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 |
|---|---|---|---|
| account_blocked | - | Destination account is blocked | A conta de destino está bloqueada. |
| account_blocked_origin | - | Your account is blocked. For more information, contact the Service Center. | Sua conta está bloqueada. Para mais informações, entre em contato com a Central de Atendimento. |
| 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, referenciando contas distintas. |
| account_inactive | instrument.p2p.account_id | Destination account is inactive | A conta de destino da transferência está inativada. |
| account_inactive | instrument.p2p.email | Destination account is inactive | A conta de destino da transferência está inativada. |
| account_inactive_origin | - | Your account is inactive. For more information, contact the Service Center. | Sua conta está inativa. Para mais informações, entre em contato com a Central de Atendimento. |
| 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. |
| 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_found_origin | - | Your account was not found. For more information, contact the Service Center. | Sua conta não foi encontrada. Para mais informações, entre em contato com a Central de Atendimento. |
| amount_too_large | amount.value | Enter only characters smaller than 20.000.000,00 | O valor da transferência superou o valor máximo. |
| failed | - | Transfer failed | Erro ao realizar a transferência. |
| idempotency_key_in_use | x-idempotency-key | Transfer already exists | Você está tentando criar uma transferência já criada anteriormente. Se essa for uma nova transferência, altere o valor de x-idempotency-key. |
| invalid_account | - | Destination account is blocked, Inbound transfers not allowed. | A conta de destino da transferência está bloqueada, proibindo o lançamento de transações. |
| invalid_account | - | Destination account is closed | A conta de destino da transferência foi encerrada. |
| invalid_account | - | Destination account number invalid or missing | O número da conta de destino está inválido. |
| invalid_account_type | - | Destination account type invalid or missing | O tipo de conta de destino está inválido ou ausente. |
| invalid_account_type | - | Transaction type not supported/authorized on this account type | Tipo de transação não suportado/autorizado nesta conta. |
| invalid_amount | amount | Invalid amount format | O parâmetro foi fornecido com um formato inválido. |
| 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. |
| invalid_date | end_date | Enter a valid value for the end_date | A data utilizada é inválida. |
| invalid_date | start_date | Enter a valid value for the start_date | A data utilizada é inválida. |
| invalid_date_format | end_date | Enter a valid date format: yyyy-MM-dd | O formato dos dados de data está incorreto. |
| invalid_date_format | start_date | Enter a valid date format: yyyy-MM-dd | O formato dos dados de data está incorreto. |
| 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_email | instrument.p2p.email | Invalid email format | O e-mail fornecido não é válido. |
| invalid_id | instrument.p2p.account_id | Invalid account_id format | O formato do dado para account_id está incorreto. |
| invalid_notification_url | notification_urls | Invalid notification url format | A URL para recebimento das notificações não é válida. |
| invalid_notification_url | notification_urls | Only one URL is accepted | Forneça apenas uma URL para receber a notificação. |
| invalid_page | page | Enter a valid value for page | O valor para a página não é válido. |
| invalid_payload_format | Invalid JSON format | Os dados do corpo da requisição não estão no formato adequado. | |
| invalid_size | size | Enter a valid value for size | O valor informado para a quantidade de itens por página não é válido. |
| 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 ao 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 ao limite de caracteres definido. |
| 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 caracteres especiais inadequados. |
| invalid_tax_id | instrument.pix.tax_id | Field must have 11 or 14 numbers | O parâmetro deve ter 11 ou 14 números. |
| invalid_tax_id | - | Identification of end customer does not match the associated account number | A identificação do cliente final não é consistente com o número da conta associada. |
| invalid_tax_id | - | Invalid CPF or CNPJ | CPF ou CNPJ está inválido. |
| parameter_required_empty | amount.currency | 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. |
| parameter_required_empty | instrument.type | Field can not be null | O parâmetro não pode ser nulo. |
| parameter_required_missing | amount | Field can not be null | O parâmetro não pode ser nulo. |
| parameter_required_missing | instrument | Field can not be null | O parâmetro não pode ser nulo. |
| 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. |
| transfer_blocked_balance | - | Your balance is temporarily blocked. For more information, contact the Service Center. | O saldo está temporariamente bloqueado. Verifique as orientações em seu e-mail cadastrado no PagBank ou acessando o Ibanking. |
| transfer_failed | - | An unexpected error has occurred. Try again. | Ocorreu um erro inesperado. Tente novamente. |
| transfer_insufficient_balance | - | Insufficient balance to transfer | A conta de origem não tem saldo suficiente para realizar esta transferência. |
| transfer_invalid_account_type | instrument.pix.account_type | Use a valid value: CC, PP, PG or CS | Use um valor válido: CC [CONTA_CORRENTE], PP [CONTA_POUPANÇA], PG [CONTA_PAGAMENTO] ou CS [CONTA_SALÁRIO]. |
| transfer_invalid_ispb | instrument.pix.bank_ispb | Field must have 8 numbers | O parâmetro deve ter 8 números. |
| transfer_invalid_ispb | - | The destination ispb is invalid or missing | A ISPB de destino é inválida. |
| transfer_invalid_ispb | - | The origin ispb is invalid or missing | A origem ISPB é inválida. |
| 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_permission | - | Transfer must be requested by the account owner. | Você não tem permissão para efetuar este tipo de transação. Em caso de dúvidas, consulte o titular da conta. |
| transfer_pix_cnpj_invalid | - | CNPJ not registered in pix | CNPJ não cadastrado no pix. |
| transfer_pix_error_creditor | - | The transfer was rejected by the destination bank | A transferência foi rejeitada pelo banco de destino. |
| transfer_pix_error_creditor | - | Transfer failed due to a the destination account error | A transferência falhou devido a um erro na conta de destino. |
| transfer_pix_invalid_key | instrument.pix.key | Pix key value is invalid. | A chave pix informada é inválida. |
| transfer_pix_salary_account_type_unsupported | - | It is not possible to send PIX to a salary account. | A transferência falhou devido a conta de destino ser uma conta salário. |
| transfer_pix_timeout | - | Transfer failed due to SPI timeout | A transferência falhou devido ao tempo limite do SPI. |
| transfer_pix_timeout | - | Transfer failed due to origin account timeout | A transferência falhou devido ao tempo limite da conta de origem. |
| transfer_required_object_p2p | instrument.p2p | Field can not be null | O parâmetro não pode ser nulo. |
| transfer_required_object_pix | instrument.pix | Field can not be null | O parâmetro não pode ser nulo. |
| 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. |