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

1000

Approved.

Payment or payment modification (refund, capture, void etc) was accepted by a Payment Service Provider, and will be processed in due course.

1001

Authorization was approved but capture failed - please issue a subsequent capture request or void request for this payment ID.

HTTP Status Code: 202 Accepted

1002

Authorization was approved but capture outcome is pending.

2001

3D 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.

2002

3D Secure: Additional payment with nonce is required to complete payment.

2101

Pending: The operation has been accepted for processing and the outcome is not yet known. Please see callbacks.

HTTP Status Code: 400 Bad Request

2003

3D Secure: Authentication failed.

2005

3D Secure: Card type is not supported for 3D Secure by the configured payment service provider.

2006

3D Secure: Cardholder is not enrolled with 3D Secure scheme supported by payment service provider.

4000

Request 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."    ]  }}

4002

Request Error: Data required by payment service provider for 3D Secure is missing.

4003

Request Error: Data required by payment service provider for 3D Secure is invalid.

4004

Request Error: Request Error: Could not get payment service provider recommendation for the payment instrument type.

4100

Merchant Account Error.

4101

Merchant Account Error: Invalid merchant keys.

4102

Merchant Account Error: Merchant account is configured incorrectly on the payment service provider.

4103

Merchant Account Error: PayPal merchant account configuration error.

4104

Merchant Account Error: Set up error.

4200

Transaction Error.

4201

Transaction Error: Transaction declined by payment processor - customer will need to contact their bank for more details.

4202

Transaction Error: Insufficient funds.

4203

Transaction Error: Withdrawal limit exceeded.

4204

Transaction Error: Activity limit exceeded.

4205

Transaction Error: Expired or inactive card.

4206

Transaction Error: Invalid credit card number.

4207

Transaction Error: Invalid expiration date.

4208

Transaction Error: Card not on record with payment processor.

4209

Transaction Error: No such card issuer.

4210

Transaction Error: Invalid CVV.

4211

Transaction Error: Voice authorisation required.

4212

Transaction Error: Transaction declined by payment processor as card reported as lost or stolen.

4214

Transaction Error: Transaction declined by payment processor as possible fraud detected.

4215

Transaction Error: Duplicate transaction.

4216

Transaction Error: Customer stopped billing.

4217

Transaction Error: The card does not support this type of transaction.

4220

Transaction Error: Surcharge not permitted.

4228

Transaction Error: The card used for this transaction requires customer approval – they will need to contact their bank.

4231

Transaction Error: The merchant is requested to retain the card.

4232

Transaction Error: Invalid amount.

4233

Transaction Error: Invalid credit plan.

4234

Transaction Error: Credit card number does not match method of payment.

4236

Transaction Error: Either the refund amount is greater than the original transaction or the card-issuing bank does not allow partial refunds.

4239

Transaction Error: Issuer or Cardholder has put a restriction on the card.

4240

Transaction Error: Address Verification failed.

4241

Transaction Error: Both the AVS and CVV checks failed for this transaction (PayPal).

4242

Transaction Error: Invalid transaction data.

4243

Transaction Error: Invalid tax amount.

4245

Transaction Error: The processor is unable to provide a definitive answer about the customer's bank account.

4246

Transaction Error: CVV is required.

4247

Transaction Error: Credit card number is prohibited.

4248

Transaction Error: Unsupported operation.

4249

Transaction Error: Card is not supported by payment processor.

4250

Transaction Error: Invalid payment details.

4251

Transaction Error: Payment was rejected by payment processor.

4252

Transaction Error: Maximum number of attempts to process request reached.

4253

Transaction Error: Tokenized payment instrument not found.

4254

Transaction Error: Unknown or expired payment nonce.

4255

Transaction Error: Name on card is required.

4256

Transaction Error: Merchant should contact payment service provider.

4257

Transaction Error: Merchant should contact acquiring bank.

4258

Transaction Error: Transaction data was rejected by configured payment service provider as invalid.

4259

Transaction Error: CVV is required by configured payment service provider.

4260

Transaction error: Transaction refused due to payment processor risk model.

4261

Transaction error: Transaction refused due to payment processor blacklist flag.

4262

Transaction Error: Status could not be determined at this time and the merchant should check the status with the payment service provider later.

4263

Transaction Error: Payment nonce has already been used.

4264

Transaction Error: Currency code of payment request does not match any of the supported currency codes on payment service provider.

4265

Transaction Error: Payment nonce not supported for merchant account on payment service provider.

4266

Transaction Error: Cannot find successful transaction for operation.

4267

Transaction Error: Transaction is not in a state in which it can be voided.

4268

Transaction Error: Transaction is not in a state in which it can be captured.

4269

Transaction Error: Capture amount is too large for this transaction.

4270

Transaction Error: Transaction was cancelled or abandoned before it could be completed.

4271

Transaction Error: PIN is incorrect, invalid, or could not be validated.

4272

Transaction Error: Invalid PIN entered too many times.

4273

Transaction Error: Customer requested to stop subscription.

4274

Transaction Error: Online or mobile PIN required.

4275

Transaction Error: Customer must have a checking account to complete the purchase.

4276

Transaction Error: Customer must have a savings account to complete the purchase.

4277

Transaction Error: Transaction rejected due to configured payment service provider rules.

4278

Transaction Error: Transaction declined as customer authentication is required.

4279

Transaction Error: Customer is a new cardholder and the card is not yet unblocked

4280

Transaction Error: Customer has been issued with a new card and that new card should be used.

4300

PayPal Error.

4301

PayPal Error: PayPal authorization error.

4302

PayPal Error: PayPal blocking duplicate order IDs.

4303

PayPal Error: PayPal buyer revoked future payment authorization.

4304

PayPal Error: PayPal payee account invalid or does not have a confirmed email.

4305

PayPal Error: Payer account is locked or closed.

4306

PayPal Error: Payer cannot pay for this transaction with PayPal.

4307

PayPal Error: Transaction refused due to PayPal risk model.

4308

PayPal Error: PayPal domestic transaction required.

4309

PayPal Error: PayPal phone number required.

4310

PayPal Error: PayPal tax info required.

4311

PayPal Error: PayPal payee blocked transaction.

4312

PayPal Error: PayPal transaction limit exceeded.

4313

PayPal Error: Currency of this transaction must match currency of your PayPal account.

4314

PayPal Error: Attempt to use an invalid email for PayPal account.

4315

PayPal Error: PayPal transaction cannot be validated - check payment details are correct.

4316

PayPal Error: Transaction failed due to configuration of PayPal business account.

4317

PayPal Error: Payee account is invalid. Verify the payee account information and try the request again.

4318

PayPal Error: Transaction could not complete because payee account is locked or closed.

4319

PayPal Error: Payee account is restricted.

4320

PayPal Error: The user account could not be validated.

4400

Refund Error: Invalid refund request.

4401

Refund Error: Cannot refund a transaction unless it is settled.

4402

Refund Error: Transaction has already been refunded in full.

4403

Refund Error: Refund amount is too large for this transaction.

4404

Refund Error: Refund time limit exceeded.

4405

Refund Error: Cannot find successful transaction for refund.

HTTP Status Code: 403 Forbidden

4001

Request Error: Access denied - insufficient authorities for requested action.

5002

Server Error: Incorrectly configured authorization information for payment service provider.

HTTP Status Code: 500 Internal Server Error

5000

Server Error.

5001

Server Error: An unexpected error occurred when processing the request.

5004

Server Error: Invalid or missing payment service provider rules configuration for client.

5005

Server Error: No payment service provider strategy configuration for client.

5006

Server Error: No payment service provider keys configuration for client.

5007

Server Error: Not Implemented.

5008

Server Error: Unknown server error.

5300

Network Error.

5302

Network Error: All configured payment service providers currently unavailable.

HTTP Status Code: 502 Bad Gateway

2004

3D Secure: Exception occurred when processing request.

2007

3D Secure: Cardholder enrollment with 3D Secure scheme could not be determined.

2008

3D Secure: Authentication was unavailable or bypassed.

5003

Server Error: Error occurred on payment processor.

5009

Server Error: Error occurred on payment service provider.

5301

Network Error: Payment processor unavailable.

5304

Network Error: Error communicating with payment service provider.

HTTP Status Code: 504 Gateway Timeout

5303

Network Error: Payment service provider timed out awaiting response from the acquiring bank.

Glossary

Payment Processor

A 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.