status_details that might occur.
Incorrect credit card information:
cc_rejected_bad_filled_card_number
cc_rejected_bad_filled_card_number
Incorrect card numberThe card number provided is invalid or incorrect.
cc_rejected_bad_filled_date
cc_rejected_bad_filled_date
Incorrect card due dateThe expiration date provided for the card is incorrect.
cc_rejected_bad_filled_security_code
cc_rejected_bad_filled_security_code
Incorrect card security codeThe CVV/security code provided is incorrect.
cc_rejected_bad_filled_other
cc_rejected_bad_filled_other
Any other card-related incorrect informationOther card information provided is incorrect or invalid.
General credit card issues:
cc_rejected_card_disabled
cc_rejected_card_disabled
Disabled credit cardThe card has been disabled by the issuing bank and cannot be used for transactions.
cc_rejected_card_error
cc_rejected_card_error
General credit card errorA general error occurred with the credit card processing.
cc_rejected_insufficient_amount
cc_rejected_insufficient_amount
Credit card with insufficient fundsThe card does not have sufficient available credit to complete the transaction.
Internal issues:
cc_rejected_card_type_not_allowed
cc_rejected_card_type_not_allowed
Credit card type not allowedThe type of credit card used is not accepted for this transaction.
cc_rejected_duplicated_payment
cc_rejected_duplicated_payment
Duplicated payment for credit-cardA payment with the same details has already been processed.
cc_rejected_invalid_installments
cc_rejected_invalid_installments
Invalid number of installments selectedThe number of installments chosen is not valid or not allowed.
Internal due-diligence issues
cc_rejected_blacklist
cc_rejected_blacklist
Credit card or holder signed as black listThe card or cardholder has been flagged and cannot proceed with transactions.
cc_rejected_high_risk
cc_rejected_high_risk
Credit card signed as high risk user to proceed with the transactionThe transaction has been flagged as high risk and cannot be processed.
Fallback general errors:
cc_rejected_other_reason
cc_rejected_other_reason
Transaction rejected due to other reasonsThe transaction was rejected for reasons not covered by the specific error codes above.
cc_rejected_fallback
cc_rejected_fallback
Fallback rejection (timeout, invalid payment information…)The transaction was rejected due to timeout, invalid payment information, or other technical issues.
bad_request
bad_request
Bad request during transactionThe request was malformed or contained invalid data.
Best Practices
Handle Errors Gracefully: Always provide clear error messages to your users based on the rejection status received.
Common Solutions
| Rejection Status | Recommended Action |
|---|---|
| cc_rejected_bad_filled_* | Ask user to verify and re-enter card information |
| cc_rejected_card_disabled | Suggest user to contact their bank or use another card |
| cc_rejected_insufficient_amount | Suggest user to use another payment method or card |
| cc_rejected_duplicated_payment | Check if payment was already processed successfully |
| cc_rejected_high_risk | Contact support for manual review |
| cc_rejected_fallback | Retry the transaction or contact support |