Ao fazer requisições para a API de Transferências, parâmetros incorretos podem gerar erros que impedem o fornecimento de uma resposta com os dados esperados. Nesse caso, erros serão retornados como resposta à sua requisição para ajudá-lo a entender o problema.
Os códigos de erro apresentados na tabela abaixo podem ocorrer durante a interação com a API de Transferências. Consulte a tabela abaixo para obter mais informações sobre cada código de erro e o respectivo cenário.
Erro de autenticação
Caso a chave e o certificado digital não forem compatíveis, ou seja, não sejam referentes ao mesmo cliente, a transação não será efetivada e um erro com Status Code 403 será retornado.
| Código de erro | Parâmetro que deu origem ao erro | Descrição | Cenário |
|---|---|---|---|
| invalid_amount | amount | Invalid amount format | O parâmetro foi fornecido com um formato inválido. |
| parameter_required_missing | amount | Field can not be null. | O parâmetro não pode ser nulo. |
| parameter_required_empty | amount.value | Field can not be null. | O parâmetro não pode ser nulo. |
| amount_too_large | amount.value | Enter only characters smaller than 20.000.000,00 | O valor da transferência superou o valor máximo. |
| invalid_amount | amount.value | Enter only numeric characters greater than zero | O valor da transferência não pode ser negativo. |
| invalid_currency | amount.currency | Use a valid value: BRL. Only capital letters. | A moeda selecionada para a transferência não é aceita. |
| parameter_required_empty | amount.currency | Field can not be null. | O parâmetro não pode ser nulo. |
| invalid_string_max_length | description | Field must have a minimum of 1 and a maximum of 72 characters. | Você precisa fornecer uma descrição que atenda o limite de caracteres definido. |
| invalid_string_max_length | reference_id | Field must have a minimum of 1 and a maximum of 64 characters. | Você precisa fornecer uma reference_id que atenda o limite de caracteres definido. |
| parameter_required_missing | instrument | Field can not be null. | O parâmetro não pode ser nulo. |
| parameter_required_empty | instrument.type | Field can not be null. | O parâmetro não pode ser nulo. |
| transfer_invalid_type | instrument.type | Use a valid value: P2P. | Você precisa selecionar um tipo para a transferência. Você pode realizar transferências do tipo P2P ou PIX. |
| transfer_required_object_p2p | instrument.p2p | Field can not be null. | O parâmetro não pode ser nulo. |
| account_not_exists | instrument.p2p.email | Destination account does not exist | A conta de destino da transferência não existe com base no e-mail fornecido. |
| account_not_exists | instrument.p2p.account_id | Destination account does not exist | A conta de destino da transferência não existe com base no account_id fornecido. |
| parameter_required_missing | instrument.p2p.account_id | "Enter a value for the destination account: ""email"" or ""account_id""" | Você precisa fornecer um dos parâmetros de identificação para a conta de destino quando seleciona transferências do tipo P2P. |
| account_divergent | instrument.p2p.email | Account_id value and email value do not represent the same account | Os dados fornecidos para a identificação da conta são divergentes, não referênciando contas distintas. |
| invalid_email | instrument.p2p.email | Invalid email format | O e-mail fornecido não é válido. |
| idempotency_key_in_use | x-idempotency-key | Transfer already exists | Você está tentanto criar uma transferência já criada anteriormente. Se essa for uma nova transferência altere o valor de x-idempotency-key. |
| invalid_notification_url | notification_urls | Invalid notification url format | A URL para recebimento das notificações não é válida. |
| invalid_payload_format | Invalid JSON format | Os dados do corpo da requisição não estão no formato adequado. | |
| account_inactive | instrument.p2p.email | Destination account is inactive | A conta de destino da transferência está inativada. |
| account_inactive | instrument.p2p.account_id | Destination account is inactive | A conta de destino da transferência está inativada. |
| invalid_id | instrument.p2p.account_id | Invalid account_id format | O formato do dado para account_id está incorreto. |
| invalid_notification_url | notification_urls | Only one URL is accepted. | Forneça apenas uma URL para receber a notificação. |
| invalid_string_max_length | x-idempotency-key | IdempotencyKey must have at maximum 200 characters and cannot have special characters. | O tamanho da chave de idempotência não está adequado ou você está utilizando de forma inadequada caracteres especiais. |
| invalid_string_max_length | x-idempotency-key | IdempotencyKey must have at maximum 200 characters and cannot have special characters. | O tamanho da chave de idempotência não está adequado ou você está utilizando de forma inadequada caracteres especiais. |
| account_blocked | - | Destination account is blocked | A conta de destino está bloqueada. |
| transfer_insufficient_balance | - | Insufficient balance to transfer | A conta de origem não tem saldo suficiente para realizar esta transferência. |
| failed | - | Transfer failed | Erro ao realizar a transferência. |
| transfer_security_rejected | - | Transfer rejected for security reasons. Contact us for more information. | A transferência falhou em função de restrições de segurança. Você deve entrar em contato com o time de suporte do PagBank para obter maiores informações. |
| invalid_date | start_date | Enter a valid value for the start_date | A data utilizada é inválida. |
| invalid_date | end_date | Enter a valid value for the end_date | A data utilizada é inválida. |
| invalid_date_period | - | Enter a valid date period. The end date must be equal to or greater than the start date, and neither date can be in the future | O período selecionado é inválido. |
| invalid_date_format | start_date | Enter a valid date format: yyyy-MM-dd | O formato dos dados de data estão incorretos. |
| invalid_date_format | end_date | Enter a valid date format: yyyy-MM-dd | O formato dos dados de data estão incorretos. |
| invalid_page | page | Enter a valid value for page | O valor para a página não é válido. |
| invalid_size | size | Enter a valid value for size | O valor informado para a quantidade de items por página não é válido. |