Comcarde Response Codes
In addition to standard HTTP Status Codes, all responses
from the Comcarde REST API will contain a top level code
field containing a Comcarde Response Code to give you
additional insight into what happened.
E.g.
{ "code": 1000, "message": "Approved", "id": "4fad8e2e06a15656", "paymentId": "22669f90-5bf0-45df-ba8c-ea6d4235a5da"}
#
HTTP Status Code: 201 Created#
1000Approved.
Payment or payment modification (refund, capture, void etc) was accepted by a Payment Service Provider, and will be processed in due course.
#
1001Authorization was approved but capture failed - please issue a subsequent capture request or void request for this payment ID.
#
HTTP Status Code: 202 Accepted#
1002Authorization was approved but capture outcome is pending.
#
20013D Secure: Further action is required to progress payment.
E.g.
{ "code": 2001, "message": "3D Secure: Further action is required to progress payment", "id": "4fad8e2e06a15656", "paymentId": "22669f90-5bf0-45df-ba8c-ea6d4235a5da", "threeDSecureAction": { "clientToken": "aaabbb", "verifyCardPayload": "payload" }}
The content of threeDSecureAction
can be passed to one our Client SDKs. See 3D Secure Payment Flow for
more information.
#
20023D Secure: Additional payment with nonce is required to complete payment.
#
2101Pending: The operation has been accepted for processing and the outcome is not yet known. Please see callbacks.
#
HTTP Status Code: 400 Bad Request#
20033D Secure: Authentication failed.
#
20053D Secure: Card type is not supported for 3D Secure by the configured payment service provider.
#
20063D Secure: Cardholder is not enrolled with 3D Secure scheme supported by payment service provider.
#
4000Request Error: The request is invalid. You may also see Comcarde Validation Errors in the response.
{ "code": 4000, "message": "Request Error - The request is invalid", "id": "4fad8e2e06a15656", "validationErrors": { "paymentInstrument.pan": [ "4030203 - The value entered for Pan is incorrect. It is not a valid card PAN." ] }}
#
4002Request Error: Data required by payment service provider for 3D Secure is missing.
#
4003Request Error: Data required by payment service provider for 3D Secure is invalid.
#
4004Request Error: Request Error: Could not get payment service provider recommendation for the payment instrument type.
#
4100Merchant Account Error.
#
4101Merchant Account Error: Invalid merchant keys.
#
4102Merchant Account Error: Merchant account is configured incorrectly on the payment service provider.
#
4103Merchant Account Error: PayPal merchant account configuration error.
#
4104Merchant Account Error: Set up error.
#
4200Transaction Error.
#
4201Transaction Error: Transaction declined by payment processor - customer will need to contact their bank for more details.
#
4202Transaction Error: Insufficient funds.
#
4203Transaction Error: Withdrawal limit exceeded.
#
4204Transaction Error: Activity limit exceeded.
#
4205Transaction Error: Expired or inactive card.
#
4206Transaction Error: Invalid credit card number.
#
4207Transaction Error: Invalid expiration date.
#
4208Transaction Error: Card not on record with payment processor.
#
4209Transaction Error: No such card issuer.
#
4210Transaction Error: Invalid CVV.
#
4211Transaction Error: Voice authorisation required.
#
4212Transaction Error: Transaction declined by payment processor as card reported as lost or stolen.
#
4214Transaction Error: Transaction declined by payment processor as possible fraud detected.
#
4215Transaction Error: Duplicate transaction.
#
4216Transaction Error: Customer stopped billing.
#
4217Transaction Error: The card does not support this type of transaction.
#
4220Transaction Error: Surcharge not permitted.
#
4228Transaction Error: The card used for this transaction requires customer approval โ they will need to contact their bank.
#
4231Transaction Error: The merchant is requested to retain the card.
#
4232Transaction Error: Invalid amount.
#
4233Transaction Error: Invalid credit plan.
#
4234Transaction Error: Credit card number does not match method of payment.
#
4236Transaction Error: Either the refund amount is greater than the original transaction or the card-issuing bank does not allow partial refunds.
#
4239Transaction Error: Issuer or Cardholder has put a restriction on the card.
#
4240Transaction Error: Address Verification failed.
#
4241Transaction Error: Both the AVS and CVV checks failed for this transaction (PayPal).
#
4242Transaction Error: Invalid transaction data.
#
4243Transaction Error: Invalid tax amount.
#
4245Transaction Error: The processor is unable to provide a definitive answer about the customer's bank account.
#
4246Transaction Error: CVV is required.
#
4247Transaction Error: Credit card number is prohibited.
#
4248Transaction Error: Unsupported operation.
#
4249Transaction Error: Card is not supported by payment processor.
#
4250Transaction Error: Invalid payment details.
#
4251Transaction Error: Payment was rejected by payment processor.
#
4252Transaction Error: Maximum number of attempts to process request reached.
#
4253Transaction Error: Tokenized payment instrument not found.
#
4254Transaction Error: Unknown or expired payment nonce.
#
4255Transaction Error: Name on card is required.
#
4256Transaction Error: Merchant should contact payment service provider.
#
4257Transaction Error: Merchant should contact acquiring bank.
#
4258Transaction Error: Transaction data was rejected by configured payment service provider as invalid.
#
4259Transaction Error: CVV is required by configured payment service provider.
#
4260Transaction error: Transaction refused due to payment processor risk model.
#
4261Transaction error: Transaction refused due to payment processor blacklist flag.
#
4262Transaction Error: Status could not be determined at this time and the merchant should check the status with the payment service provider later.
#
4263Transaction Error: Payment nonce has already been used.
#
4264Transaction Error: Currency code of payment request does not match any of the supported currency codes on payment service provider.
#
4265Transaction Error: Payment nonce not supported for merchant account on payment service provider.
#
4266Transaction Error: Cannot find successful transaction for operation.
#
4267Transaction Error: Transaction is not in a state in which it can be voided.
#
4268Transaction Error: Transaction is not in a state in which it can be captured.
#
4269Transaction Error: Capture amount is too large for this transaction.
#
4270Transaction Error: Transaction was cancelled or abandoned before it could be completed.
#
4271Transaction Error: PIN is incorrect, invalid, or could not be validated.
#
4272Transaction Error: Invalid PIN entered too many times.
#
4273Transaction Error: Customer requested to stop subscription.
#
4274Transaction Error: Online or mobile PIN required.
#
4275Transaction Error: Customer must have a checking account to complete the purchase.
#
4276Transaction Error: Customer must have a savings account to complete the purchase.
#
4277Transaction Error: Transaction rejected due to configured payment service provider rules.
#
4278Transaction Error: Transaction declined as customer authentication is required.
#
4279Transaction Error: Customer is a new cardholder and the card is not yet unblocked
#
4280Transaction Error: Customer has been issued with a new card and that new card should be used.
#
4300PayPal Error.
#
4301PayPal Error: PayPal authorization error.
#
4302PayPal Error: PayPal blocking duplicate order IDs.
#
4303PayPal Error: PayPal buyer revoked future payment authorization.
#
4304PayPal Error: PayPal payee account invalid or does not have a confirmed email.
#
4305PayPal Error: Payer account is locked or closed.
#
4306PayPal Error: Payer cannot pay for this transaction with PayPal.
#
4307PayPal Error: Transaction refused due to PayPal risk model.
#
4308PayPal Error: PayPal domestic transaction required.
#
4309PayPal Error: PayPal phone number required.
#
4310PayPal Error: PayPal tax info required.
#
4311PayPal Error: PayPal payee blocked transaction.
#
4312PayPal Error: PayPal transaction limit exceeded.
#
4313PayPal Error: Currency of this transaction must match currency of your PayPal account.
#
4314PayPal Error: Attempt to use an invalid email for PayPal account.
#
4315PayPal Error: PayPal transaction cannot be validated - check payment details are correct.
#
4316PayPal Error: Transaction failed due to configuration of PayPal business account.
#
4317PayPal Error: Payee account is invalid. Verify the payee account information and try the request again.
#
4318PayPal Error: Transaction could not complete because payee account is locked or closed.
#
4319PayPal Error: Payee account is restricted.
#
4320PayPal Error: The user account could not be validated.
#
4400Refund Error: Invalid refund request.
#
4401Refund Error: Cannot refund a transaction unless it is settled.
#
4402Refund Error: Transaction has already been refunded in full.
#
4403Refund Error: Refund amount is too large for this transaction.
#
4404Refund Error: Refund time limit exceeded.
#
4405Refund Error: Cannot find successful transaction for refund.
#
HTTP Status Code: 403 Forbidden#
4001Request Error: Access denied - insufficient authorities for requested action.
#
5002Server Error: Incorrectly configured authorization information for payment service provider.
#
HTTP Status Code: 500 Internal Server Error#
5000Server Error.
#
5001Server Error: An unexpected error occurred when processing the request.
#
5004Server Error: Invalid or missing payment service provider rules configuration for client.
#
5005Server Error: No payment service provider strategy configuration for client.
#
5006Server Error: No payment service provider keys configuration for client.
#
5007Server Error: Not Implemented.
#
5008Server Error: Unknown server error.
#
5300Network Error.
#
5302Network Error: All configured payment service providers currently unavailable.
#
HTTP Status Code: 502 Bad Gateway#
20043D Secure: Exception occurred when processing request.
#
20073D Secure: Cardholder enrollment with 3D Secure scheme could not be determined.
#
20083D Secure: Authentication was unavailable or bypassed.
#
5003Server Error: Error occurred on payment processor.
#
5009Server Error: Error occurred on payment service provider.
#
5301Network Error: Payment processor unavailable.
#
5304Network Error: Error communicating with payment service provider.
#
HTTP Status Code: 504 Gateway Timeout#
5303Network Error: Payment service provider timed out awaiting response from the acquiring bank.
#
Glossary#
Payment ProcessorA payment processor refers to the back-end supporting system or network that the payment service provider (PSP) relies on to process transactions, typically facilitating the interaction between the PSP and the systems of the financial institutions that are responsible for actually authorizing or declining transactions.
#
Payment Service Provider (PSP)A payment service provider (PSP) connects merchants, consumers, card brand networks and financial institutions. In the context of this document, any reference to a payment service provider should be assumed to relate to a payment service provider downstream from Comcarde that we integrate with.
#
Card Verification Number (CVV)A card verification value (CVV) is usually located on the back of a payment card and provides additional security for when a PIN number cannot be used.
#
Address Verification System (AVS)The Address Verification System (AVS) is a system used to verify the address of a person claiming to own a credit card.