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 siguinte 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 parametros 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 The account is inactive
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

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.
2004 422 Unprocessable Entity The card number verification digit is invalid El dígito verificador del número de tarjeta es inválido de acuerdo al algoritmo Luhn.
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 puntos Santander.
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

Tarjetas

Código Error HTTP Mensaje Causa
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 Merchant not authorized to use payment plan Merchant not authorized to use payment plan El número de afiliación no soporta pago a meses sin intereses.
3203 Invalid promotion for such card type Invalid promotion for such card type Promoción no válida para este tipo de tarjetas.
3204 Transaction amount is less than minimum for promotion Transaction amount is less than minimum for promotion El monto de la transacción es menor al mínimo permitido para esta promoción.
3205 El monto de la transacción es menor al mínimo permitido para esta promoción. Promotion not allowed Promoción no permitida.

Cuentas

Código Error HTTP Mensaje Causa
4001 412 Preconditon Failed There are not enough funds in the openpay account La cuenta de Openpay no tiene fondos suficientes.
4002 412 Preconditon 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 respondio con errores.

Ponte en contacto con nosotros: