Códigos de rechazo

Cuando un pago con tarjeta es rechazado, la transacción regresa con status: "Declined". El código y la descripción del motivo del rechazo vienen anidados dentro del objeto response, no como campos top-level:

• responseCode y responseText: código y descripción general del rechazo. Siempre presentes.
• processorError y processorMessage: aparecen cuando el rechazo viene directamente del procesador (por ejemplo, fondos insuficientes).
• rules[]: aparece en lugar de processorError/processorMessage cuando el rechazo es por una regla de validación (por ejemplo, fallo de autenticación 3DS), como un arreglo de objetos {code, message}.

Esta página es el catálogo de los códigos de rechazo que devuelve el procesador de tarjetas.

Ejemplo: rechazo por fondos insuficientes

{
  "status": "Declined",
  "transaction_status": "Declined",
  "response": {
    "responseCode": "021",
    "responseText": "Tarjeta sin fondos",
    "processorError": "K006",
    "processorMessage": "Transacción declinada.",
    "transactionStatus": "DECLINED"
  }
}

Ejemplo: rechazo por regla de validación

{
  "status": "Declined",
  "transaction_status": "Declined",
  "response": {
    "responseCode": "K322",
    "responseText": "Transacción rechazada.",
    "rules": [
      { "code": "K325", "message": "Autenticación fallida - Error de autenticación" }
    ],
    "transactionStatus": "DECLINED"
  }
}

Rechazos suaves vs duros

Cada código tiene un tipo que determina si tiene sentido reintentar:

Códigos numéricos

Códigos de 2 y 3 dígitos:

Códigos alfanuméricos

Códigos K

Siguientes pasos