Errors

Openpay always returns JSON objects in the service responses, so when there is an error you will get the following error object.

Error Object

Field

Type

Description

category

string

General category.

  • request: It means an error caused by data sent by the customer. For example, an invalid request, an attempt of a transaction without funds or a transfer to an account that does not exist.
  • internal: It means an error on the Openpay side, this will occur very rarely.
  • gateway: It means an error during the transaction of funds from one card to the Openpay account or from the to a bank account or card.

error_code

numeric

This is the Openpay error code.

description

string

The error details.

http_code

string

HTTP error code from the response.

request_id

string

Request identifier

Example:

{
    "category" : "request",
    "description" : "The customer with id 'm4hqp35pswl02mmc567' does not exist",
    "http_code" : 404,
    "error_code" : 1005,
    "request_id" : "1981cdb8-19cb-4bad-8256-e95d58bc035c"
}

Error Codes

General

Code

HTTP Error

Message

Cause

1000

500 Internal Server Error

Internal server error, contact support

An error happened in the internal Openpay server.

1001

400 Bad Request

Bad Request

The request is not JSON valid format, the fields don’t have the correct format, or the request doesn’t have the required fields.

1002

401 Unauthorized

The api key or merchant id are invalid

The request is not authenticated or is incorrect.

1003

422 Unprocessable Entity

Parameters look valid but request failed

The operation couldn’t be processed because one or more parameters are incorrect.

1004

503 Service Unavailable

The resource is unavailable at this moment. Please try again later

A required service is not available.

1005

404 Not Found

The requested resource doesn't exist

A required resource doesn’t exist.

1006

409 Conflict

The order_id has already been processed

There is already a transaction with the same ID order.

1007

402 Payment Required

Operation rejected by processor

The funds transfer between the bank account or card and the Openpay account was rejected.

1008

423 Locked

The account is inactive

One of the required accounts is deactivated.

1009

413 Request Entity too large

The request is too large

The request body is too large.

1010

403 Forbidden

Method not allowed for public API key, use private key instead

The public key is being used to make a request that requires the private key, or the private key is being using from Javascript.

1011

404 Not Found

The resource was previously deleted

The resource was previously deleted.

1012

412 Precondition failed

The transaction amount exceeds your allowed transaction limit

The transaction amount is out of the limits.

1013

412 Precondition failed

The operation is not allowed on the resource

The operation is not allowed on the resource.

1014

401 Unauthorized

Your account is inactive, please contact to soporte@openpay.mx for more information

The account is inactive.

1015

504 Gateway timeout

Could not get any response from gateway. Please try again later

Could not get any response from gateway.

1016

409 Conflict

The merchant email has been already processed

The merchant email has been already processed.

1017

502 Bad Gateway

The payment gateway is not available at the moment, please try again later

The payment gateway is not available at the moment, please try again later.

1018

402 Payment Required

The number of retries of charge is greater than allowed

The number of retries of charge is greater than allowed.

1020

400 Bad Request

The number of decimal digits is not valid for this currency

The number of decimal digits is not valid for this currency.

1023

412 Precondition failed

The transactions included in your package have been completed. To contract another package contact support@openpay.mx

The transactions included in your package have been completed. To contract another package contact support@openpay.mx

1024

412 Precondition failed

The transaction amount exceeds your allowed transaction limit by TPV

The transaction amount exceeds your allowed transaction limit by TPV

1025

412 Precondition failed

The CoDi transactions contracted in your plan have been blocked

The CoDi transactions contracted in your plan have been blocked.

Storage

Code

HTTP Error

Message

Cause

2001

409 Conflict

The bank account already exists

The bank account already exists.

2003

409 Conflict

The external_id already exists

The external_id already exists.

Cards

Code

HTTP Error

Message

Cause

2004

422 Unprocessable Entity

The card number verification digit is invalid

The card number is invalid.

2005

400 Bad Request

The expiration date has expired

The expiration date has expired.

2006

400 Bad Request

The CVV2 security code is required

The CVV2 security code is required.

2007

412 Precondition Failed

The card number is only valid in sandbox

The card number is only valid in sandbox.

2008

412 Precondition Failed

The card is not valid for points

The card is not valid for points.

2009

412 Precondition Failed

The CVV2 security code is invalid

The CVV2 security code is invalid.

2010

402 Payment Required

3D Secure authentication failed

3D Secure authentication failed.

2011

422 Unprocessable Entity

Card product type not supported

Card product type not supported.

3001

402 Payment Required

The card was declined by the bank

The card was declined by the bank.

3002

402 Payment Required

The card has expired

Card is expired.

3003

402 Payment Required

The card doesn't have sufficient funds

Card has not enough funds.

3004

402 Payment Required

The card was reported as stolen

Card has been flagged as stolen.

3005

402 Payment Required

Fraud risk detected by anti-fraud system --- Found in blacklist

Fraud risk detected by anti-fraud system

Found in blacklist.

3006

412 Precondition Failed

Request not allowed

The operation is not allowed for this customer or transaction.

3009

402 Payment Required

The card was reported as lost

Card has been flagged as lost.

3010

402 Payment Required

The bank has restricted the card

The card has been restricted by the bank.

3011

402 Payment Required

The bank has requested the card to be retained

The bank has requested to hold this card. Please contact the bank.

3012

412 Precondition Failed

Bank authorization is required for this charge

Bank authorization is required to make this payment.

3201

412 Precondition Failed

Merchant not authorized to use payment plan

Merchant not authorized to use promotions.

3203

412 Precondition Failed

Invalid promotion for such card type

Invalid promotion for such card type.

3204

412 Precondition Failed

Transaction amount is less than minimum for promotion

Transaction amount is less than minimum for promotion.

3205

412 Precondition Failed

Promotion not allowed

Promotion not allowed.

Accounts

Code

HTTP Error

Message

Cause

4001

412 Precondition Failed

There are not enough funds in the openpay account

The Openpay account doesn’t have enough funds.

4002

412 Precondition Failed

The operation can't be completed until pending fees are paid

The operation can't be completed until pending fees are paid.

Webhooks

Code

HTTP Error

Message

Cause

6001

409 Conflict

The webhook has already been processed

The webhook has already been processed.

6002

412 Preconditon Failed

Could not connect with webhook service, verify URL

Could not connect with webhook service.

6003

502 Bad Gateway

Service responded with an error on this moment. Please try again later

Service responded with an error.