Códigos de error

Un código de error tiene la forma [PREFIJO]_[CÓDIGO], donde:

[PREFIJO] define la capa de aplicación donde se ha producido el error
[CODIGO] es el código numérico del error.

Existen distintos prefijos:

PREFIJO DESCRIPCIÓN EJEMPLO DE ERROR
ACQ Error del adquiriente ACQ_001
AUTH Error de autentificación AUTH_149
CLIENT Aplicación JavaScript (en el navegador del comprador) CLIENT_003
INT Error de integración (del comerciante) INT_007
PSP Error PSP PSP_001

Los errores se envían a través de 4 parámetros:

{
  "errorCode": "INT_015",
  "errorMessage": "invalid customer email",
  "detailedErrorCode": null,
  "detailedErrorMessage": "Invalid input value [name=customer.email, value=fake-email]"
}
CARACTERÍSTICAS DESCRIPCIÓN TIPO
errorCode cadena Código de error (con formato [PREFIJO]_[CÓDIGO])
errorMessage cadena Mensaje de error
detailedErrorCode cadena Código de error detallado (o nulo)
detailedErrorMessage cadena Mensaje detallado (o nulo)

Podrán añadirse nuevos códigos de error en el futuro. Es obligatorio que su implementación lo tenga en cuenta.

Errores ACQ

Esos errores se producen en el adquiriente del comerciante (banco).

ERROR DEFINICIÓN DE CÓDIGO
ACQ_001 Pago rechazado
ACQ_999 Error técnico

El código de rechazo de autorización del adquiriente se envía en detailedErrorCode. Esos códigos se envían sin modificación. Son específicos para cada adquiriente.

Por ejemplo, si una tarjeta VISA es rechazada por robo, la estructura de error será:

{
  "errorCode": "ACQ_001",
  "errorMessage": "payment refused",
  "detailedErrorCode": "43",
  "detailedErrorMessage": "Stolen card"
}

Los códigos de errores detallados (detailedErrorCode) más frecuentes son:

GRUPO DE ERRORES DESCRIPCIÓN
tarjetas CB, Visa y Mastercard (Francia) Códigos de retorno específicos a la red de CB
tarjetas American Express Códigos devueltos por el adquirente Amex Global

Errores AUTH

Los errores AUTH (de “autentificación”) generalmente se deben a un problema en los servidores de autentificación (en 3D-Secure por ejemplo).

CÓDIGO DE ERROR DEFINICIÓN
AUTH_100 Firma ACS no válida
AUTH_101 error técnico 3DS
AUTH_102 parámetro 3DS incorrecto
AUTH_103 3DS desactivado
AUTH_149 Tiempo excedido de la operación 3DS
AUTH_999 Error técnico

Errores del CLIENTE

Esos errores se producen en el navegador del comprador. Se producen antes de que los datos de pago se envíen a nuestros servidores. Se trata, por ejemplo, de errores de validación de datos del formulario realizados localmente, o de errores de integración del cliente JavaScript.

Consultar más información en la documentación del cliente JavaScript

Errores INT

Los errores INT (de “integración”) se deben generalmente a un problema de integración del comerciante.

Código DEFINICIÓN
INT_005 parámetro manualValidation no válido
INT_006 parámetro captureDelay o expectedCaptureDate no válido
INT_009 parámetro amount no válido
INT_010 parámetro currency no válido
INT_012 parámetro customer.language no válido
INT_013 parámetro orderId no válido
INT_015 parámetro customer.email no válido
INT_016 parámetro customer.reference no válido
INT_017 parámetro customer.billingDetails.title no válido
INT_019 parámetro customer.billingDetails.address no válido
INT_020 parámetro customer.billingDetails.zipCode no válido
INT_021 parámetro customer.billingDetails.city no válido
INT_022 parámetro customer.billingDetails.country no válido
INT_023 parámetro customer.billingDetails.phoneNumber no válido
INT_030 parámetro paymentMethodToken no válido
INT_031 parámetro contrib no válido
INT_040 parámetro pan no válido
INT_041 parámetro expiryMonth no válido
INT_042 parámetro expiryYear no válido
INT_043 parámetro securityCode no válido
INT_050 parámetro strongAuthentication no válido
INT_060 parámetro paymentSource no válido
INT_062 parámetro mid no válido
INT_064 parámetro rrule no válido
INT_066 parámetro initialAmount no válido
INT_068 parámetro initialAmountNumber no válido
INT_069 parámetro effectDate no válido
INT_077 parámetro customer.shippingDetails.cellPhoneNumber no válido
INT_081 parámetro customer.billingDetails.address no válido
INT_082 parámetro customer.shippingDetails.address2 no válido
INT_083 parámetro customer.shippingDetails.city no válido
INT_084 parámetro customer.shippingDetails.state no válido
INT_085 parámetro customer.shippingDetails.zipCode no válido
INT_086 parámetro customer.shippingDetails.country no válido
INT_087 parámetro customer.shippingDetails.address2 no válido
INT_088 parámetro customer.billingDetails.state no válido
INT_091 parámetro metadata no válido
INT_092 parámetro customer.billingDetails.category no válido
INT_093 parámetro customer.shippingDetails.category no válido
INT_095 parámetro customer.shippingDetails.shippingMethod no válido
INT_095 parámetro customer.shippingDetails.shippingSpeed no válido
INT_096 parámetro customer.shippingDetails.deliveryCompanyName no válido
INT_097 parámetro cartItemInfo.productLabel no válido
INT_098 parámetro cartItemInfo.productType no válido
INT_100 parámetro cartItemInfo.productRef no válido
INT_101 parámetro cartItemInfo.productQty no válido
INT_102 parámetro cartItemInfo.productAmount no válido
INT_104 parámetro customer.billingDetails.firstName no válido
INT_105 parámetro customer.billingDetails.lastName no válido
INT_106 parámetro customer.shippingDetails.firstName no válido
INT_107 parámetro customer.shippingDetails.lastName no válido
INT_108 parámetro customer.shoppingCart.taxAmount no válido
INT_109 parámetro customer.shoppingCart.shippingAmount no válido
INT_110 parámetro customer.shoppingCart.insuranceAmount no válido
INT_112 parámetro customer.billingDetails.streetNumber no válido
INT_113 parámetro customer.billingDetails.district no válido
INT_114 parámetro customer.shippingDetails.streetNumber no válido
INT_115 parámetro customer.shippingDetails.district no válido
INT_121 parámetro customer.billingDetails.legalName no válido
INT_124 parámetro customer.billingDetails.identityCode no válido
INT_125 parámetro customer.shippingDetails.legalName no válido
INT_130 parámetro acquirerTransientData no válido
INT_131 parámetro overridePaymentCinematic no válido
INT_102 parámetro cartItemInfo.productVat no válido
INT_873 Parámetro fingerPrintld no válido
INT_874 parámetro paymentMethodType no válido
INT_875 Parámetro formAction no válido
INT_876 parámetro payload no válido
INT_877 parámetro customer.shippingDetails.identityCode no válido
INT_878 parámetro commission no válido
INT_880 initialAmount e initialAmountNumber tienen que estar definidos
INT_883 parámetro description no válido
INT_885 parámetro formToken no válido
INT_886 parámetro debitCreditSelector no válido
INT_887 parámetro brand no válido
INT_892 parámetro paymentMethodType no válido
INT_893 parámetro firstInstallmentDelay no válido
INT_895 parámetro installmentNumber no válido
INT_896 parámetro incompatible para la suscripción
INT_897 parámetro subscriptionId no válido
INT_898 Parámetro comment no válido
INT_899 Parámetro retry no válido
INT_900 El parámetro no existe
INT_901 No se encuentra el servicio web
INT_902 Uno de los parámetros enviado al servicio web no es válido
INT_903 No se encuentra el formToken
INT_904 Clave pública pública
INT_905 Nombre de usuario o contraseña no válidos
INT_906 Parámetro formToken no válido
INT_910 la creación de alias no está activada para este medio de pago
INT_911 La clave pública no se corresponde con el formToken
INT_912 La contraseña no se corresponde con la transacción
INT_913 Autorizado únicamente para los comerciantes PCI-DSS
INT_999 Error técnico

Errores de PSP

Los errores PSP (Payment Service Provider) se producen cuando el PSP no puede tratar la petición.

Código Mensaje
PSP_501 No se ha encontrado la transacción.
PSP_502 No se ha encontrado la transacción.
PSP_503 Esta acción no está autorizada para una transacción con ese estado {0}.
PSP_504 Esta transacción no está autorizada en este contexto.
PSP_505 Transacción ya existe.
PSP_506 Monto de transacción inválido.
PSP_507 Esta acción ya no es posible para una transacción creada en esa fecha.
PSP_508 La fecha de caducidad de la tarjeta no permite esta acción.
PSP_509 CVV obligatorio para la tarjeta.
PSP_510 El monto del reembolso es superior al monto inicial.
PSP_511 La suma de los reembolsos realizados es superior al monto inicial.
PSP_512 La duplicación de un crédito (rembolso) no está autorizada.
PSP_513 Debido a un incidente técnico, no podemos procesar su solicitud.
PSP_514 Debido a un incidente técnico, no podemos procesar su solicitud.
PSP_515 Debido a un incidente técnico, no podemos procesar su solicitud.
PSP_516 Debido a un incidente técnico, no podemos procesar su solicitud.
PSP_517 La teleparameterización del contrato Aurore falló.
PSP_518 Fallo en el análisis de la respuesta Cetelem.
PSP_519 Moneda desconocida.
PSP_520 Tipo de tarjeta inválido.
PSP_521 No se ha encontrado ningún contrato para este pago. Modifique los datos o póngase en contacto con su gestor en caso de fallos repetidos.
PSP_522 Tienda no encontrada.
PSP_523 Contrato ambiguo.
PSP_524 Contrato inválido.
PSP_525 Debido a un incidente técnico, no podemos procesar su solicitud.
PSP_526 Número de tarjeta no válido
PSP_527 Número de tarjeta inválido.
PSP_528 Número de tarjeta inválido.
PSP_529 Número de tarjeta inválido.
PSP_530 Número de tarjeta inválido. (Luhn)
PSP_531 Número de tarjeta inválido. (longitud)
PSP_532 Número de tarjeta inválido. (no encontrado)
PSP_533 Número de tarjeta inválido. (no encontrado)
PSP_534 Fallo en la verificación sistemática de la tarjeta autorizada.
PSP_535 Fallo en la verificación de e-tarjeta de crédito.
PSP_536 El control de riesgos provocó el rechazo de la transacción.
PSP_537 Interrupción no gestionada durante el proceso de pago.
PSP_538 Debido a un incidente técnico, no podemos procesar su solicitud.
PSP_539 Rechazo 3D Secure para la transacción.
PSP_540 Debido a un incidente técnico, no podemos procesar su solicitud.
PSP_541 Debido a un incidente técnico, no podemos procesar su solicitud.
PSP_542 Ocurrió un error interno al consultar el número de la tarjeta.
PSP_543 Ocurrió un error interno al consultar el número de la tarjeta.
PSP_545 Moneda inválida para la modificación.
PSP_546 El monto es superior al monto autorizado.
PSP_547 La fecha de presentación deseada es posterior a la fecha de validez de la autorización.
PSP_548 La modificación requerida es inválida.
PSP_549 Definición de pago múltiple inválida.
PSP_550 Tienda desconocida.
PSP_551 Curso desconocido
PSP_552 El contrato está cerrado desde {0}.
PSP_553 La tienda {0} está cerrada desde {1}.
PSP_554 Parámetro rechazado que puede contener datos confidenciales {0}.
PSP_555 Debido a un incidente técnico, no podemos procesar su solicitud.
PSP_557 Error en la recuperación del alias.
PSP_558 El estado del alias no es compatible con esta operación.
PSP_559 Error en la recuperación del alias.
PSP_560 Alias existente.
PSP_561 Alias inválido
PSP_562 Se ha rechazado la creación de un alias.
PSP_563 Afiliación ya existente.
PSP_564 Esta afiliación ya está cancelada.
PSP_565 Esta afiliación está inválida.
PSP_566 La regla de recurrencia no es válida.
PSP_567 Creación de abono rechazada.
PSP_569 Debido a un incidente técnico, no podemos procesar su solicitud.
PSP_570 Código de país inválido.
PSP_571 Parámetro del servicio web inválido.
PSP_572 Cofinoga rechaza la autorización.
PSP_573 Rechazo de la autorización a 1 euro (o petición de información en la red CB si el adquiriente lo permite).
PSP_574 Configuración de pago inválida.
PSP_575 PayPal ha rechazado la operación.
PSP_577 Debido a un incidente técnico, no podemos procesar su solicitud.
PSP_578 Identificación de transacción no definida.
PSP_579 Identificación de transacción ya utilizada.
PSP_580 Identificación de a transacción expirada.
PSP_581 Contenido del tema de configuración inválido.
PSP_582 No se autoriza el rembolso.
PSP_583 Monto de transacción fuera de los valores permitidos.
PSP_585 Debido a un incidente técnico, no podemos procesar su solicitud.
PSP_587 Debido a un incidente técnico, no podemos procesar su solicitud.
PSP_597 No hay opción de pago habilitada para este contrato.
PSP_592 Se ha producido un error al calcular el canal de pago.
PSP_593 Se ha producido un error en la acción del comprador en la página de finalización del pago.
PSP_594 Ha ocurrido un error técnico.
PSP_596 Se produjo un error al capturar esta transacción.
PSP_597 Fecha de captura demasiado lejana.
PSP_598 Fecha de transacción inválida.
PSP_599 Se ha producido un error en el cálculo del origen del pago.
PSP_600 Fallo en la verificación de tarjeta comercial.
PSP_601 Denegado porque la primera cuota fue rechazada.
PSP_603 El estatus de la transacción no se ha podido sincronizar con el sistema externo.
PSP_604 Se produjo un error al capturar esta transacción.
PSP_605 Se produjo un error de seguridad durante el proceso 3DS de esta transacción.
PSP_606 Moneda no compatible para este contrato y/o esta tienda.
PSP_607 La tarjeta asociada al alias ya no es válida.
PSP_608 Debido a un incidente técnico, no podemos procesar su solicitud.
PSP_609 Tiempo de espera excedido al redirigir al comprador.
PSP_610 Tarjeta de pago no soportada por el contrato.
PSP_611 Refus des transactions sans transfert de responsabilité.
PSP_612 No se autoriza la anulación.
PSP_613 No se autoriza la duplicación.
PSP_615 No se autoriza el rembolso.
PSP_616 Pago manual no autorizado para esta tarjeta.
PSP_618 Pago manual en cuotas no autorizado para esta tarjeta.
PSP_619 La fecha de envío es inválida.
PSP_620 La opción de pago de la transacción inicial no es aplicable.
PSP_624 Tarjeta inactiva.
PSP_625 Pago rechazado por el adquiriente.
PSP_626 Esta acción no es posible porque la secuencia de pago no ha terminado.
PSP_636 Refus des transactions dérivées, sans transfert de responsabilité sur la transaction primaire.
PSP_637 La transacción es un duplicado.
PSP_638 El rembolso parcial no es posible para esta transacción.
PSP_639 Reembolso rechazado.
PSP_641 El analizador de riesgos ha rechazado esta transacción.
PSP_642 El tipo de tarjeta utilizado no es válido para el modo de pago solicitado.
PSP_643 Debido a un incidente técnico, no podemos procesar su solicitud.
PSP_644 Una transacción en modo producción se ha marcado en modo de prueba en el adquiriente.
PSP_645 Una transacción en modo de prueba se ha marcado en modo producción en el adquiriente.
PSP_646 Código SMS inválido.
PSP_647 El módulo de gestión de fraudes ha solicitado el rechazo de esta transacción.
PSP_648 Debido a un incidente técnico, no podemos procesar su solicitud. No se ha creado la transacción.
PSP_649 La duración de la sesión de pago ha expirado (caso del adquiriente que se redirige hacia el ACS y que no finaliza la autentificación 3D Secure).
PSP_650 Debido a un incidente técnico, no podemos procesar su solicitud. No se ha creado la transacción.
PSP_651 Una transacción Facily Pay no se puede cancelar / modificar / reembolsar entre las 23:30 y las 05:30.
PSP_652 Debido a un incidente técnico, no podemos procesar su solicitud.
PSP_653 Se ha producido un error técnico al llamar al departamento Banque Accord.
PSP_655 La transacción Facily Pay no se ha podido anular/modificar/rembolsar: el estado de la transacción no permite realizar la acción solicitada. Recordatorio sobre una transacción Facily Pay: un rembolso tiene que respetar un plazo de dos días después de la devolución; el plazo entre dos rembolsos es de un día; un rembolso parcial se limita a 20 días; un rembolso total se limita a 6 meses.
PSP_658 Debido a un incidente técnico, no podemos procesar su solicitud.
PSP_659 El monto es inferior al monto mínimo autorizado (mínimo = {0} {1}).
PSP_660 Es imposible reembolsar una transacción sin pagar.
PSP_665 Figura el tipo de documento de identidad pero falta el número.
PSP_666 Figura el número de documento de identidad pero falta el tipo.
PSP_667 El tipo de documento de identidad es desconocido.
PSP_668 El número de documento de identidad no es válido.
PSP_669 Los datos concretos que deben transmitirse al adquiriente no son válidos.
PSP_670 El rembolso diferido no está autorizado.
PSP_671 El número de meses para el pago diferido no está autorizado.
PSP_672 La cinemática de pago seleccionada no es válida.
PSP_673 Error en el servicio Express Checkout de PayPal.
PSP_675 No se puede cancelar, por favor intente un reembolso.
PSP_676 Reembolso no es posible, por favor intente una cancelación.
PSP_677 No se ha recibido ninguna respuesta a la petición de autorización en el plazo correspondiente.
PSP_678 No se puede cancelar, la transacción ya ha sido cancelada.
PSP_679 El estado de la transacción es desconocido.
PSP_682 Falta el identificador nacional del cliente.
PSP_683 El formato del identificador nacional del cliente es incorrecto.
PSP_998 Error HTTP
PSP_999 Error técnico