Business error codes are returned when a transaction cannot be processed due to specific system rules, user account status, or payment method conditions. Unlike credit card errors (which follow the ABECS standard), these codes are specific to the PicPay API and indicate situations that require specific actions from the merchant or end user.
Payment and Card Errors#
| Return Code | HTTP | API Message | Message for Merchant |
|---|
| INVALID_FUNDING_SOURCE | 406 | Invalid founding source. | Invalid card. Do not retry. The user must add funds or change their primary card. |
| FUNDING_SOURCE_UNAVAILABLE | 403 | Funding source unavailable | The payment method is not available. Use another payment method. |
| INSUFFICIENT_FUNDS | 406 | Insufficient funds. | User does not have sufficient wallet balance to complete the transaction. Do not retry. The user must add funds or register a card. |
Account and Status Errors#
| Return Code | HTTP | API Message | Message for Merchant |
|---|
| ACCOUNT_CLOSED | 406 | The account is closed. | The account is closed. Use another account. |
| ACCOUNT_ON_HOLD | 406 | The account is on hold. | The account is temporarily unavailable for transactions. The customer should contact PicPay. |
Transaction Errors#
| Return Code | HTTP | Technical Message | Standard Message for Merchant |
|---|
| TRANSACTION_CANT_BE_PAID | 409 | Transaction not in pending status | This transaction cannot be paid in its current status. |
Refund Errors#
| Return Code | HTTP | Technical Message | Standard Message for Merchant |
|---|
| TRANSACTION_CANT_BE_REFUNDED | 409 | Transaction has invalid status for refund. | The transaction cannot be refunded in its current status. |
| INSUFFICIENT_BALANCE_REFUND | 406 | Insufficient funds to refund this transaction. | Insufficient balance to process the refund. |
Cancellation and Capture Errors (Business Rules)#
| Return Code | HTTP | Technical Message | Standard Message for Merchant |
|---|
| TRANSACTION_CANT_BE_CANCELLED | 409 | Transaction has invalid status for cancellation. | The transaction cannot be cancelled in its current status. |
| TRANSACTION_CANT_BE_CAPTURED | 409 | Transaction has invalid status for capture. | The transaction cannot be captured in its current status. |