Os códigos de erros de negócio são retornados quando uma transação não pode ser processada devido a regras específicas do sistema, status da conta do usuário, ou condições do meio de pagamento. Diferente dos erros de cartão de crédito, estes códigos são específicos da API PicPay e indicam situações que requerem ações específicas do lojista ou do usuário final.
Erros de Pagamento e Cartão#
| Código de Retorno | HTTP | Mensagem API | Mensagem para o Lojista |
|---|
| INVALID_FUNDING_SOURCE | 406 | Invalid founding source. | Cartão inválido. Não tentar novamente. O usuário deve adicionar fundos ou alterar seu cartão principal. |
| FUNDING_SOURCE_UNAVAILABLE | 403 | Funding source unavailable | O meio de pagamento não está disponível. Utilizar outro meio de pagamento. |
| INSUFFICIENT_FUNDS | 406 | Insufficient funds. | Usuário não possui saldo suficiente em carteira para efetuar a transação. Não tentar novamente. O usuário deve adicionar fundos ou cadastrar um cartão. |
Erros de Conta e Status#
| Código de Retorno | HTTP | Mensagem API | Mensagem para o Lojista |
|---|
| ACCOUNT_CLOSED | 406 | The account is closed. | A conta está encerrada. Utilizar outra conta. |
| ACCOUNT_ON_HOLD | 406 | The account is on hold. | A conta está temporariamente indisponível para transações. O cliente deve contatar o PicPay. |
Erros de Transação#
| Código de Retorno | HTTP | Mensagem Técnica | Mensagem Padronizada para o Lojista |
|---|
| TRANSACTION_CANT_BE_PAID | 409 | Transaction not in pending status | Esta transação não pode ser paga no status atual. |
Erros de Reembolso#
| Código de Retorno | HTTP | Mensagem Técnica | Mensagem Padronizada para o Lojista |
|---|
| TRANSACTION_CANT_BE_REFUNDED | 409 | Transaction has invalid status for refund. | A transação não pode ser reembolsada no status atual. |
| INSUFFICIENT_BALANCE_REFUND | 406 | Insufficient funds to refund this transaction. | Saldo insuficiente para processar o reembolso. |
Erros de Cancelamento e Captura (Regras de Negócio)#
| Código de Retorno | HTTP | Mensagem Técnica | Mensagem Padronizada para o Lojista |
|---|
| TRANSACTION_CANT_BE_CANCELLED | 409 | Transaction has invalid status for cancellation. | A transação não pode ser cancelada no status atual. |
| TRANSACTION_CANT_BE_CAPTURED | 409 | Transaction has invalid status for capture. | A transação não pode ser capturada no status atual. |