Errores

Openpay siempre regresa objetos de JSON en las respuestas del servicio, incluso en caso de errores por lo que cuando exista un error recibirás el siguiente objeto error.

​Objeto Error

Campo

Tipo

Descripción

category

string

La categoria general del error.

  • request: Indica un error causado por datos enviados por el cliente. Por ejemplo, una petición inválida, un intento de una transacción sin fondos, o una transferencia a una cuenta que no existe.
  • internal: Indica un error del lado de Openpay, y ocurrira muy raramente.
  • gateway: Indica un error durante la transacción de los fondos de una tarjeta a la cuenta de Openpay o de la cuenta hacia un banco o tarjeta.

error_code

numeric

El código del error de Openpay indicando el problema que ocurrió.

description

string

El detalle del error.

http_code

string

Código de error HTTP de la respuesta.

request_id

string

Identificador de la petición.

Ejemplo:

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

Códigos de Error

Generales

Código

Error HTTP

Mensaje

Causa

1000

500 Internal Server Error

Internal server error, contact support

Ocurrió un error interno en el servidor de Openpay

1001

400 Bad Request

Bad Request

El formato de la petición no es JSON, los campos no tienen el formato correcto, o la petición no tiene campos que son requeridos.

1002

401 Unauthorized

The api key or merchant id are invalid

La llamada no esta autenticada o la autenticación es incorrecta.

1003

422 Unprocessable Entity

Parameters look valid but request failed

La operación no se pudo completar por que el valor de uno o más de los parámetros no es correcto.

1004

503 Service Unavailable

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

Un servicio necesario para el procesamiento de la transacción no se encuentra disponible.

1005

404 Not Found

The requested resource doesn't exist

Uno de los recursos requeridos no existe.

1006

409 Conflict

The order_id has already been processed

Ya existe una transacción con el mismo ID de orden.

1007

402 Payment Required

Operation rejected by processor

La transferencia de fondos entre una cuenta de banco o tarjeta y la cuenta de Openpay no fue aceptada.

1008

423 Locked

The account is inactive

Una de las cuentas requeridas en la petición se encuentra desactivada.

1009

413 Request Entity too large

The request is too large

El cuerpo de la petición es demasiado grande.

1010

403 Forbidden

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

Se esta utilizando la llave pública para hacer una llamada que requiere la llave privada, o bien, se esta usando la llave privada desde JavaScript.

1011

404 Not Found

The resource was previously deleted

Se solicita un recurso que esta marcado como eliminado.

1012

412 Precondition failed

The transaction amount exceeds your allowed transaction limit

El monto transacción esta fuera de los limites permitidos.

1013

412 Precondition failed

The operation is not allowed on the resource

La operación no esta permitida para el recurso.

1014

401 Unauthorized

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

La cuenta esta inactiva.

1015

504 Gateway timeout

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

No se ha obtenido respuesta de la solicitud realizada al servicio.

1016

409 Conflict

The merchant email has been already processed

El mail del comercio ya ha sido procesada.

1017

502 Bad Gateway

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

El gateway no se encuentra disponible en ese momento.

1018

402 Payment Required

The number of retries of charge is greater than allowed

El número de intentos de cargo es mayor al permitido.

1020

400 Bad Request

The number of decimal digits is not valid for this currency

El número de dígitos decimales es inválido para esta moneda.

1023

412 Precondition failed

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

Se han terminado las transacciones incluidas en tu paquete. Para contratar otro paquete contacta a soporte@openpay.mx.

1024

412 Precondition failed

The transaction amount exceeds your allowed transaction limit by TPV

El monto de la transacción excede su límite de transacciones permitido por TPV

1025

412 Precondition failed

The CoDi transactions contracted in your plan have been blocked

Se han bloqueado las transacciones CoDi contratadas en tu plan

Almacenamiento

Código

Error HTTP

Mensaje

Causa

2001

409 Conflict

The bank account already exists

La cuenta de banco con esta CLABE ya se encuentra registrada en el cliente.

2003

409 Conflict

The external_id already exists

El cliente con este identificador externo (External ID) ya existe.

Tarjetas

Código

Error HTTP

Mensaje

Causa

2004

422 Unprocessable Entity

The card number verification digit is invalid

El número de tarjeta es invalido.

2005

400 Bad Request

The expiration date has expired

La fecha de expiración de la tarjeta es anterior a la fecha actual.

2006

400 Bad Request

The CVV2 security code is required

El código de seguridad de la tarjeta (CVV2) no fue proporcionado.

2007

412 Precondition Failed

The card number is only valid in sandbox

El número de tarjeta es de prueba, solamente puede usarse en Sandbox.

2008

412 Precondition Failed

The card is not valid for points

La tarjeta no es valida para pago con puntos.

2009

412 Precondition Failed

The CVV2 security code is invalid

El código de seguridad de la tarjeta (CVV2) es inválido.

2010

402 Payment Required

3D Secure authentication failed

Autenticación 3D Secure fallida.

2011

422 Unprocessable Entity

Card product type not supported

Tipo de tarjeta no soportada.

3001

402 Payment Required

The card was declined by the bank

La tarjeta fue declinada por el banco.

3002

402 Payment Required

The card has expired

La tarjeta ha expirado.

3003

402 Payment Required

The card doesn't have sufficient funds

La tarjeta no tiene fondos suficientes.

3004

402 Payment Required

The card was reported as stolen

La tarjeta ha sido identificada como una tarjeta robada.

3005

402 Payment Required

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

La tarjeta ha sido rechazada por el sistema antifraude.

Rechazada por coincidir con registros en lista negra.

3006

412 Precondition Failed

Request not allowed

La operación no esta permitida para este cliente o esta transacción.

3009

402 Payment Required

The card was reported as lost

La tarjeta fue reportada como perdida.

3010

402 Payment Required

The bank has restricted the card

El banco ha restringido la tarjeta.

3011

402 Payment Required

The bank has requested the card to be retained

El banco ha solicitado que la tarjeta sea retenida. Contacte al banco.

3012

412 Precondition Failed

Bank authorization is required for this charge

Se requiere solicitar al banco autorización para realizar este pago.

3201

412 Precondition Failed

Merchant not authorized to use payment plan

Comercio no autorizado para procesar pago a meses sin intereses.

3203

412 Precondition Failed

Invalid promotion for such card type

Promoción no valida para este tipo de tarjetas.

3204

412 Precondition Failed

Transaction amount is less than minimum for promotion

El monto de la transacción es menor al mínimo permitido para la promoción.

3205

412 Precondition Failed

Promotion not allowed

Promoción no permitida.

Cuentas

Código

Error HTTP

Mensaje

Causa

4001

412 Precondition Failed

There are not enough funds in the openpay account

La cuenta de Openpay no tiene fondos suficientes.

4002

412 Precondition Failed

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

La operación no puede ser completada hasta que sean pagadas las comisiones pendientes.

Webhooks

Código

Error HTTP

Mensaje

Causa

6001

409 Conflict

The webhook has already been processed

El webhook ya ha sido procesado.

6002

412 Preconditon Failed

Could not connect with webhook service, verify URL

No se ha podido conectar con el servicio de webhook.

6003

502 Bad Gateway

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

El servicio respondió con errores.