-
Inicio
Guías
- Pagos con tarjeta
- Búsquedas
- Pago en agentes (Kasnet)
- Suscripciones
- OneClick
- 3D Secure 2.0
- Recurrencia
Referencia
Plugins
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:
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.pe 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.pe | Se han terminado las transacciones incluidas en tu paquete. Para contratar otro paquete contacta a soporte@openpay.pe. |
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
Ejemplo:
Códigos de Error
Generales
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 | 402 Payment Required | Bank authorization is required for this charge | Se requiere solicitar al banco autorización para realizar este pago. |
3203 | 402 Payment Required | Invalid promotion for such card type | Promoción no valida para este tipo de tarjetas. |
3204 | 402 Payment Required | 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 | 402 Payment Required | 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. |