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.
