logo
API docs by Redocly

API KLAP H2H (1.10)

Download OpenAPI specification:

Introducción

Acerca de este manual

Este documento describe los aspectos técnicos que deben ser considerados para la integración con KLAP utilizando la API de Pago H2H, y cómo debe ser utilizada en los distintos tipos de transacciones. Además se incluyen ejemplos para cada tipo de transacción soportada por la API.

Audiencia

Este documento está dirigido a personal técnico que requiera implementar la integración con la API de Pago H2H de KLAP. En el contenido de este documento se detallan los campos que debe tener en consideración quien desee enviar solicitudes de pago con tarjetas de crédito, débito o prepago de las marcas: MASTERCARD, MAESTRO, VISA, AMERICAN EXPRESS (AMEX) y UNIONPAY (UPI).

Descripción de la API

La API de Pago con tarjetas de KLAP (que llamaremos desde ahora en adelante, API) permite realizar los siguientes tipos de operaciones (cada una con sus respectivas reversas):

  • PURCHASE (Venta)
  • PRE AUTHORIZATION (Pre autorización o Checkin)
  • CAPTURE (Captura o Checkout)
  • REFUND (Anulación)
  • DELAYED (Demorado posterior a Checkout)
  • INCREMENTAL (Incremental posterior a Checkin, previo a Checkout)
Cada transacción cumple estándares de seguridad y protección de datos propios de la industria financiera.

Por el momento, la API soporta transacciones cuya divisa debe ser en Pesos Chilenos (CLP, según ISO 4217), permite cuotas emisor. Las marcas de tarjetas soportadas son las siguientes:

  • MASTERCARD: Modelo GTW y PSP.
  • MAESTRO: Modelo PSP.
  • VISA: Modelo GTW y PSP.
  • AMEX: Modelo GTW y PSP.
  • UPI: Modelo PSP.

Estructura de la API

En cada solicitud enviada a la API, la aplicación cliente debe enviar un MAC, el cual es un identificador único proporcionado por KLAP, para identificar a la aplicación cliente. Estas peticiones deben ser en formato JSON y cada tipo de transacción tiene sus propios campos necesarios para ser enviadas.

Seguridad

Para la protección de los datos de la transacción y junto con ello de los datos sensibles del tarjeta habiente se establecen las siguientes medidas:
  • Comunicación HTTPS: La API solo soporta mensajería sobre protocolo HTTPS con nivel de seguridad TLS1.2 o superior.
  • Cifrado de datos sensibles: Utilizando llave BDk/DUKPT.
  • Verificación de MAC: Utilizando la combinación HMAC SHA256, estandar para este tipo de validaciones.

Glosario

A continuación se definen/explican algunos términos utilizados en esta documentación:

  • MK: Llave maestra utilizada para el cifrado de la MAC utilizando el algoritmo Hmac SHA256. La MK es provista, en hexadecimal, en conjunto con la data sensible.
  • BDK: Clave secreta que se mantiene en un entorno seguro y se utiliza para generar claves de sesión derivadas únicas para cada transacción. El BDK se combina con un número de serie único denominado Key Serial Number (KSN) utilizando el algoritmo DUKPT.
  • KSN: KSN es un número de serie de clave utilizado en el algoritmo de encriptación BDK DUKPT para generar claves de sesión únicas para transacciones específicas.
  • GTW: Transacciones Gateway (Comercios Propios) generadas directamente por el comercio con el adquirente bancario.
  • PSP: Transacciones generadas por Proveedores de Servicios de Pago (PSP) que actúan como intermediario para los sub comercios.

Echo

En las solicitudes de tipo Echo se puede invocar el servicio GET solicitud de Echo.

Echo

Una transacción echo corresponde a una solicitud que permite resolver el estado de conectividad de los servicios.

Authorizations:
ApiKey

Responses

Purchase

En las solicitudes de tipo Purchase se puede invocar el servicio POST solicitud de Purchase considerando el nuevo tag "is_delayed" con valor false (en caso de NO incluir el tag el valor por defecto es false) y el servicio POST solicitud de Purchase Reversal.

Para el caso de solicitudes de tipo Delayed se puede invocar el servicio POST solicitud de Purchase considerando el nuevo tag "is_delayed" con valor true y el servicio POST solicitud de Purchase Reversal.

Purchase

Una transacción purchase corresponde a una solicitud de autorización financiera de pago con tarjeta, enviando información esencial para el pago, como por ejemplo datos de tarjeta, de la transacción y del comercio a la API; adicionalmente se pueden enviar transacciones de tipo delayed las que corresponden a una solicitud de autorización financiera de pago con tarjeta posterior a un capture (checkout), esto considera el mismo envio de datos que para una transacción de tipo purchase.

Authorizations:
ApiKey
header Parameters
Content-Type
required
string
Example: application/json

Describe el tipo de contenido que está siendo enviado como solicitud a la API.

Request Body schema: application/json
required

Cargo a ser realizado

commerce_id
required
string (field_def)

Identificador único de comercio.

branch_id
string (branchId_field_def)

Este campo corresponde a la sucursal de un comercio (largo menor o igual a 70).

required
object (terminal_data_spec_complex_request)

Objeto que contiene datos del Terminal.

required
object (card_data_enc_spec_request)

Objeto que contiene datos de la Tarjeta.

required
object (trx_data_spec_complex_request)

Objeto que contiene datos de la Tarjeta.

object (payment_facilitator_request)

Objeto que contiene datos requeridos por modelo PSP.

Responses

Request samples

Content type
application/json
{
  • "commerce_id": "ABCDE12345",
  • "branch_id": "sucursal_01A",
  • "terminal": {
    },
  • "data": {
    },
  • "transaction": {
    },
  • "payment_facilitator": {
    }
}

Response samples

Content type
application/json
{
  • "code": "01",
  • "message": "TRANSACCION APROBADA",
  • "transaction": {
    },
  • "data": {
    },
  • "terminal": {
    },
  • "installments": {
    }
}

Purchase Reversal

Una transacción reversal purchase corresponde a una solicitud de reversa de a un pago con tarjeta, esto aplica tanto para purchase como para delayed.

Authorizations:
ApiKey
header Parameters
Content-Type
required
string
Example: application/json

Describe el tipo de contenido que está siendo enviado como solicitud a la API.

Request Body schema: application/json
required

Cargo a ser realizado

commerce_id
required
string (field_def)

Identificador único de comercio.

branch_id
string (branchId_field_def)

Este campo corresponde a la sucursal de un comercio (largo menor o igual a 70).

required
object (terminal_data_spec_simple_request)

Objeto que contiene datos del Terminal.

required
object (card_data_enc_spec_basic_request)

Objeto que contiene datos de la Tarjeta.

required
object (trx_data_spec_min_request)

Objeto que contiene los datos de la transacción como los montos, número de cuotas, tipo de moneda, entre otros.

Responses

Request samples

Content type
application/json
{
  • "commerce_id": "ABCDE12345",
  • "branch_id": "sucursal_01A",
  • "terminal": {
    },
  • "data": {
    },
  • "transaction": {
    }
}

Response samples

Content type
application/json
{
  • "code": "01",
  • "message": "TRANSACCION APROBADA",
  • "transaction": {
    },
  • "terminal": {
    }
}

Pre Authorization

En las solicitudes de tipo Pre Authorization se puede invocar el servicio POST solicitud de Pre Authorization, y el servicio POST solicitud de Pre Authorization Reversal.

Pre Autorización

Una transacción pre-authorization corresponde a una solicitud de autorización financiera de pre autorización, enviando información esencial para el pago, como por ejemplo datos de tarjeta, de la transacción, y del comercio a la API.

Authorizations:
ApiKey
header Parameters
Pre Authorization
required
string
Example: application/json

Describe el tipo de contenido que está siendo enviado como solicitud a la API.

Request Body schema: application/json
required

Cargo a ser realizado

commerce_id
required
string (field_def)

Identificador único de comercio.

branch_id
string (branchId_field_def)

Este campo corresponde a la sucursal de un comercio (largo menor o igual a 70).

required
object (terminal_data_spec_complex_request)

Objeto que contiene datos del Terminal.

required
object (card_data_enc_spec_request)

Objeto que contiene datos de la Tarjeta.

required
object (trx_data_spec_normal_request)
object (payment_facilitator_request)

Objeto que contiene datos requeridos por modelo PSP.

Responses

Request samples

Content type
application/json
{
  • "commerce_id": "ABCDE12345",
  • "branch_id": "sucursal_01A",
  • "terminal": {
    },
  • "data": {
    },
  • "transaction": {
    },
  • "payment_facilitator": {
    }
}

Response samples

Content type
application/json
{
  • "code": "01",
  • "message": "TRANSACCION APROBADA",
  • "transaction": {
    },
  • "data": {
    },
  • "terminal": {
    },
  • "installments": {
    }
}

Pre Authorization Reversal

Una transacción reversal preauthorization corresponde a una solicitud de reversa de a una pre autorización.

Authorizations:
ApiKey
header Parameters
Content-Type
required
string
Example: application/json

Describe el tipo de contenido que está siendo enviado como solicitud a la API.

Request Body schema: application/json
required

Cargo a ser realizado

commerce_id
required
string (field_def)

Identificador único de comercio.

branch_id
string (branchId_field_def)

Este campo corresponde a la sucursal de un comercio (largo menor o igual a 70).

required
object (terminal_data_spec_simple_request)

Objeto que contiene datos del Terminal.

required
object (card_data_enc_spec_basic_request)

Objeto que contiene datos de la Tarjeta.

required
object (trx_data_spec_min_request)

Objeto que contiene los datos de la transacción como los montos, número de cuotas, tipo de moneda, entre otros.

Responses

Request samples

Content type
application/json
{
  • "commerce_id": "ABCDE12345",
  • "branch_id": "sucursal_01A",
  • "terminal": {
    },
  • "data": {
    },
  • "transaction": {
    }
}

Response samples

Content type
application/json
{
  • "code": "01",
  • "message": "TRANSACCION APROBADA",
  • "transaction": {
    },
  • "terminal": {
    }
}

Capture

En las solicitudes de tipo Capture se puede invocar el servicio POST solicitud de Capture, y el servicio POST solicitud de Capture Reversal.

Capture

Una transacción capture corresponde a una solicitud de autorización financiera de captura, enviando información esencial para el pago, como por ejemplo datos de tarjeta, de la transacción, y del comercio a la API.

Authorizations:
ApiKey
header Parameters
Content-Type
required
string
Example: application/json

Describe el tipo de contenido que está siendo enviado como solicitud a la API.

Request Body schema: application/json
required

Cargo a ser realizado

commerce_id
required
string (field_def)

Identificador único de comercio.

branch_id
string (branchId_field_def)

Este campo corresponde a la sucursal de un comercio (largo menor o igual a 70).

object (terminal_data_spec_complex_optional_request)

Objeto que contiene datos del Terminal.

required
object (card_data_enc_spec_simple_request)

Objeto que contiene datos de la Tarjeta.

required
object (trx_data_spec_normal_auth_request)

Responses

Request samples

Content type
application/json
{
  • "commerce_id": "ABCDE12345",
  • "branch_id": "sucursal_01A",
  • "terminal": {
    },
  • "data": {
    },
  • "transaction": {
    }
}

Response samples

Content type
application/json
{
  • "code": "01",
  • "message": "TRANSACCION APROBADA",
  • "transaction": {
    },
  • "data": {
    },
  • "terminal": {
    }
}

Capture Reversal

Una transacción reversal capture corresponde a una solicitud de reversa de a una de pago con tarjeta.

Authorizations:
ApiKey
header Parameters
Content-Type
required
string
Example: application/json

Describe el tipo de contenido que está siendo enviado como solicitud a la API.

Request Body schema: application/json
required

Cargo a ser realizado

commerce_id
required
string (field_def)

Identificador único de comercio.

branch_id
string (branchId_field_def)

Este campo corresponde a la sucursal de un comercio (largo menor o igual a 70).

object (terminal_data_spec_simple_request)

Objeto que contiene datos del Terminal.

required
object (card_data_enc_spec_basic_request)

Objeto que contiene datos de la Tarjeta.

required
object (trx_data_spec_min_request)

Objeto que contiene los datos de la transacción como los montos, número de cuotas, tipo de moneda, entre otros.

Responses

Request samples

Content type
application/json
{
  • "commerce_id": "ABCDE12345",
  • "branch_id": "sucursal_01A",
  • "terminal": {
    },
  • "data": {
    },
  • "transaction": {
    }
}

Response samples

Content type
application/json
{
  • "code": "01",
  • "message": "TRANSACCION APROBADA",
  • "transaction": {
    },
  • "terminal": {
    }
}

Refund

En las solicitudes de tipo Refund se puede invocar el servicio POST solicitud de Refund, y el servicio POST solicitud de Refund reversal.

Refund

Una transacción refund corresponde a una solicitud de autorización financiera de captura, enviando información esencial para la anulación del pago, como por ejemplo datos de tarjeta, de la transacción, y del comercio a la API.

Authorizations:
ApiKey
header Parameters
Content-Type
required
string
Example: application/json

Describe el tipo de contenido que está siendo enviado como solicitud a la API.

Request Body schema: application/json
required

Cargo a ser realizado

commerce_id
required
string (field_def)

Identificador único de comercio.

branch_id
string (branchId_field_def)

Este campo corresponde a la sucursal de un comercio (largo menor o igual a 70).

required
object (terminal_data_spec_simple_request)

Objeto que contiene datos del Terminal.

required
object (card_data_enc_spec_basic_request)

Objeto que contiene datos de la Tarjeta.

required
object (trx_data_spec_simple_auth_request)

Responses

Request samples

Content type
application/json
{
  • "commerce_id": "ABCDE12345",
  • "branch_id": "sucursal_01A",
  • "terminal": {
    },
  • "data": {
    },
  • "transaction": {
    }
}

Response samples

Content type
application/json
{
  • "code": "01",
  • "message": "TRANSACCION APROBADA",
  • "transaction": {
    },
  • "data": {
    },
  • "terminal": {
    }
}

Refund Reversal

Una transacción reversal refund corresponde a una solicitud de reversa de a una Anulación.

Authorizations:
ApiKey
header Parameters
Content-Type
required
string
Example: application/json

Describe el tipo de contenido que está siendo enviado como solicitud a la API.

Request Body schema: application/json
required

Cargo a ser realizado

commerce_id
required
string (field_def)

Identificador único de comercio.

branch_id
string (branchId_field_def)

Este campo corresponde a la sucursal de un comercio (largo menor o igual a 70).

required
object (terminal_data_spec_simple_request)

Objeto que contiene datos del Terminal.

required
object (card_data_enc_spec_basic_request)

Objeto que contiene datos de la Tarjeta.

required
object (trx_data_spec_min_request)

Objeto que contiene los datos de la transacción como los montos, número de cuotas, tipo de moneda, entre otros.

Responses

Request samples

Content type
application/json
{
  • "commerce_id": "ABCDE12345",
  • "branch_id": "sucursal_01A",
  • "terminal": {
    },
  • "data": {
    },
  • "transaction": {
    }
}

Response samples

Content type
application/json
{
  • "code": "01",
  • "message": "TRANSACCION APROBADA",
  • "transaction": {
    },
  • "terminal": {
    }
}

Incremental

En las solicitudes de tipo Incremental se puede invocar el servicio POST solicitud de Incremental, y el servicio POST solicitud de Incremental Reversal.

Incremental

Una transacción incremental corresponde a una solicitud de autorización financiera de re-autorización, posterior a una transacción de tipo "pre-authorization (checkin)" y anterior a una transacción de tipo "capture (checkout)", enviando información esencial para el pago, como por ejemplo datos de tarjeta, de la transacción, y del comercio a la API.

Authorizations:
ApiKey
header Parameters
Content-Type
required
string
Example: application/json

Describe el tipo de contenido que está siendo enviado como solicitud a la API.

Request Body schema: application/json
required

Cargo a ser realizado

commerce_id
required
string (field_def)

Identificador único de comercio.

branch_id
string (branchId_field_def)

Este campo corresponde a la sucursal de un comercio (largo menor o igual a 70).

object (terminal_data_spec_complex_optional_request)

Objeto que contiene datos del Terminal.

required
object (card_data_enc_spec_simple_request)

Objeto que contiene datos de la Tarjeta.

required
object (trx_data_spec_normal_auth_request)

Responses

Request samples

Content type
application/json
{
  • "commerce_id": "ABCDE12345",
  • "branch_id": "sucursal_01A",
  • "terminal": {
    },
  • "data": {
    },
  • "transaction": {
    }
}

Response samples

Content type
application/json
{
  • "code": "01",
  • "message": "TRANSACCION APROBADA",
  • "transaction": {
    },
  • "data": {
    },
  • "terminal": {
    }
}

Incremental Reversal

Una transacción reversal incremental corresponde a una solicitud de reversa de a una de pago con tarjeta.

Authorizations:
ApiKey
header Parameters
Content-Type
required
string
Example: application/json

Describe el tipo de contenido que está siendo enviado como solicitud a la API.

Request Body schema: application/json
required

Cargo a ser realizado

commerce_id
required
string (field_def)

Identificador único de comercio.

branch_id
string (branchId_field_def)

Este campo corresponde a la sucursal de un comercio (largo menor o igual a 70).

object (terminal_data_spec_simple_request)

Objeto que contiene datos del Terminal.

required
object (card_data_enc_spec_basic_request)

Objeto que contiene datos de la Tarjeta.

required
object (trx_data_spec_min_request)

Objeto que contiene los datos de la transacción como los montos, número de cuotas, tipo de moneda, entre otros.

Responses

Request samples

Content type
application/json
{
  • "commerce_id": "ABCDE12345",
  • "branch_id": "sucursal_01A",
  • "terminal": {
    },
  • "data": {
    },
  • "transaction": {
    }
}

Response samples

Content type
application/json
{
  • "code": "01",
  • "message": "TRANSACCION APROBADA",
  • "transaction": {
    },
  • "terminal": {
    }
}

FAQ

Teniendo como contexto la agregación de Ips al ambiente de desarrollo ¿Existe algún límite en el número de IPs que se pueden agregar? ¿A futuro se podrán añadir más IPs?

-No existe un limite de IPs. Estas se pueden añadir cuando el comercio lo solicite.

Respecto a la certificación L3 ¿Cómo es el procedimiento de las pruebas? ¿El comercio debe enviar uno de sus POS de desarrollo para que alguien KLAP ejecute las pruebas?

-Las debe realizar el comercio, no es necesario compartir a klap uno de sus POS de desarrollo.

Respecto a la certificación L3 ¿El comercio debe rellenar algún formulario con las especificaciones de los dispositivos POS para generar los casos de prueba?

-No, pues los casos de prueba los debe generar el comercio. Durante la certificación Klap participa como acompañamiento tecnico, especificamente disponibilizando ambiente y simulador para la realización de los casos de prueba.

Referent a campo ICC y los tags. ¿Cuáles tags son requeridos y cuales opcionales? ¿Son requeridos todos los que se muestran en la tabla dentro de la documentación de la API o hay más?

-La documentación muestra información de referencia, en la práctica los POS proveen ese conjunto de TAGs durante el proceso EMV de lectura de las tarjetas. Las marcas normalmente piden un mínimo de tags, no importa que el comercio envíe más TAGs de los que pide la marca, dado que KLAP los filtra.

Referent a campo ICC y los tags. ¿Cuáles tags son requeridos y cuales opcionales? ¿Son requeridos todos los que se muestran en la tabla dentro de la documentación de la API o hay más?

-La documentación muestra información de referencia, en la práctica los POS proveen ese conjunto de TAGs durante el proceso EMV de lectura de las tarjetas. Las marcas normalmente piden un mínimo de tags, no importa que el comercio envíe más TAGs de los que pide la marca, dado que KLAP los filtra.

¿Existe alguna documentación del proceso de certificación L3?

-Si, debes solicitarlo a tu KAM o ingeniero de integración. En el se encuentra el flujo de la certificacion.

¿El test de Homologación lo entrega Klap o debemos gestionarlo nosotros los clientes?

-El test de homologación lo entrega Klap y debe ser completado por el comercio. El comercio debera compartir los resultados con klap para su validación.

¿Existen reglas para implementación de la reversa de una venta?

-Si se tiene 2 reglas respecto a las reversa:

  • Reversa de la transacción hasta 1 hora posterior a la venta. De acuerdo al sentido que tiene la reversa, esta debería generarse minutos después de la venta. Por lo que 1 hora es un tiempo razonable para gatillarla.
  • Se permitirán reintentos de forma limitada, durante el mismo día de la venta, que no superen los 6 intentos por hora.

¿Sobre que respuestas debería generar una reversa de venta o autorización?

-Para rechazos códigos 98: Error de Procesamiento y para todas las respuestas con HTTP code 504.

Códigos de respuesta

Códigos de respuesta de Klap

Códigos generales
Response CodeDescripción
"01"OK
"88"SOLICITUD DE INGRESO DE PIN
"99"ERROR GENERAL
"900"Error de Procesamiento.
"901"Data Inválida.
"902"Petición inválida.
"903"Respuesta inválida.
"904"Codigo MC inválido.
"910"Tarjeta no es debito
"911"Tarjeta no es credito
"912"Tarjeta no es prepago
"913"Cuotas no permitidas para Tarjeta Internacional
"914"Refund partial no permitido, trx cuotas comercio
"998"No hay respuesta
"999"Error - Reintentar
"1001"Tarjeta de Crédito Inválida.
"1002"Tarjeta de Debito Invalida
"1003"Tarjeta de Prepago Invalida
"1005"DATA INVÁLIDA. Problema con la encriptacion de la data enviada.
"1006"DATA INVÁLIDA. Verificacion de la MAC responde MAC invalida.
"1007"DATA INVÁLIDA. Problema con la generacion del EnMac.
"1008"DATA INVÁLIDA. Problema con la data sensible recibida (Es nula o corrupta).
"1009"DATA INVÁLIDA. Error interno en preparación de la información.
"1010"No existe transacción original.
"1011"Transacción original inválida.
"1012"La solicitud no pudo ser almacenada.
"1013"La respuesta no pudo ser almacenada.
"1014"Tarjeta de CREDITO no tiene habilitado VUELTO.
"1015"Captura ya realizada.
"1016"Transacción inválida.
"1017"Anulación ya realizada.
"1018"Reversa ya realizada.
"1019"Transacción original rechazada.
"1020"No es posible reversar transaccion
"1021"Transaccion duplicada
"1022"La transaccion de origen no coincide
"3000"Transaccion No Habilitada(U)
"3001"El Terminal no esta registrado. Contactese con Klap
"3002"Serie no habilitada para tarjeta bancaria
"3003"Emisor desconocido
"3004"Banco aun no habilitado para ventas
"3005"Terminal sin condiciones comerciales asociadas
"3006"MCC Subcomercio no encontrado
"3007"Rut Subcomercio no encontrado
"3008"Comercio sin merchant discount
"3009"Simcard no reconocida. Contactese con Multicaja
"3010"Equipo no Activo, realice un Registra Visita
"3011"Equipo debe volver a Multicaja
"3012"Se procede a reinicio de equipo
"3013"Invalid card acceptor
"3014"Codigo de canal no definido
"3016"Importe de la transacción no válido
"3017"Tarjeta no coincide
"3018"Emisor no coincide
"3019"Monto no coincide
"3020"Marca de tarjeta no soportada
"3021"No es posible anular transaccion
"3022"Monto a anular supera el maximo permitido
"3023"Codigo de respuesta desconocido
"3024"Transaccion original corresponde a otro comercio
"3025"Check-In original ya completado
"3028"Informacion de terminal no disponible
"3029"Transaccion ya anulada
"3030"Transaccion ya completada
"3031"No se admite Check-out para este emisor
"3033"No se admite el incremento para este emisor
"3034"Vuelto no permitido para Unionpay
"3035"Emisor No soporta esta transaccion
"3036"Transaccion en proceso. No se puede reversar
"3038"Tipo de transaccion invalida
"3040"Tipo de tarjeta invalida
"3041"Monto excedido, cree un Incremental por: $%s
"3042"Monto excede lo preautorizado
"3043"Check-In original fuera de tiempo
"3044"Venta original no esta completada
"3045"Transaccion original conciliada
"3046"Transaccion original ya reversada parcialmente
"3047"Tarjeta ingresada no es la de transaccion original
"3048"Transaccion no permitida para este comercio
"3049"Codigo de comercio invalido
"3050"Informacion de facilitador de pago invalida.
"3051"Transaccion ya cancelada.
"3052"Codigo de autorizacion invalido..
"3053"Codigo de autorizacion invalido..
"3054"No es posible anular transaccion
"3055"No es posible anular transaccion
"3056"No es posible anular transaccion. Comercio tiene Anticipo realizado.
"3057"No es posible anular transaccion porque el Monto Aprobado queda por debajo del permitido
"3058"RECHAZADA- REINTENTAR EL %s A LAS %s
"5057"No permitida para el tarjetahabiente
"5058"Transaccion incremental no permitida.
"5059"Transaccion bloqueada por el rubro
"8001"Inconsistencia de datos con Transaccion AFD
"8002"Error de integridad de datos de MIT o CIT
"8003"Error de integridad de datos de SCOF para COF
"99002"Número de Tarjeta inválido.
"99004"Monto inválido.
"99014"Fecha de Expiración inválida.
"99018"Merchant Category Code es inválido.
"99022"POS Entry Mode es inválido.
"99023"POS Entry Mode fallback no soportado.
"99038"Authorization Code es invalido.
"99043"Payment Facilitator Name es invalido.
"99049"El Código de Moneda es inválido.
"99061"Pos Data inválida
"99062"Pos Data inválida

Códigos de respuesta por marca

Mastercard
Response CodeDescripción
"00"OK
"01"RECHAZADA- CONTACTE A SU EMISOR
"03"COMERCIO INVALIDO- RESTRINGIDO POR EMISOR
"04"CUENTA CERRADA- NO REINTENTE
"05"RECHAZADA- CONTACTE A SU EMISOR
"08"OK
"10"RECHAZADA
"12"TRANSACCION INVALIDA- NO REINTENTE
"13"MONTO INVALIDO
"14"TARJETA INVALIDA- CONTACTE A SU EMISOR
"15"EMISOR INVALIDO- NO REINTENTE
"30"RECHAZADA- CONTACTE A SU EMISOR
"41"TARJETA BLOQUEADA- CONTACTE A SU EMISOR
"43"TARJETA BLOQUEADA- CONTACTE A SU EMISOR
"51"EXCEDE SALDO MAXIMO
"54"TARJETA EXPIRADA
"55"PIN INVALIDO
"57"TRANSACCION NO PERMITIDA POR EMISOR
"58"TRANSACCION NO PERMITIDA
"61"EXCEDE SALDO MAXIMO
"62"TARJETA RESTRINGIDA EMISOR
"63"VIOLACION DE SEGURIDAD
"65"EXCEDE MAXIMO DE TRANSACCIONES
"70"RECHAZADA- CONTACTE A SU EMISOR
"71"PIN INVALIDO
"75"EXCEDE INTENTOS DE PIN PERMITIDOS
"76"CUENTA INVALIDA- CONTACTE A SU EMISOR
"77"CUENTA INVALIDA- CONTACTE A SU EMISOR
"78"TARJETA INACTIVA- CONTACTE A SU EMISOR
"79"Declinada - Ciclo de vida Mastercard
"81"RECHAZADA- CONTACTE A SU EMISOR
"82"Declinada - Politica Mastercard
"83"Declinada - Seguridad Mastercard
"84"AUTORIZACION INVALIDA
"85"OK
"86"PIN INVALIDO
"87"APROBADA SOLO PARA TRANSACCIONES CON VUELTO
"88"RECHAZADA- CONTACTE A SU EMISOR
"89"PIN INVALIDO
"91"RECHAZADA- SISTEMA EMISOR NO OPERATIVO
"92"RECHAZADA- SISTEMA EMISOR NO OPERATIVO
"94"RECHAZO POR DUPLICIDAD DE TRANSACCION
"96"RECHAZADA- SISTEMA EMISOR NO OPERATIVO
Maestro
Response CodeDescripción
"00"OK
"01"RECHAZADA- CONTACTE A SU EMISOR
"03"COMERCIO INVALIDO- RESTRINGIDO POR EMISOR
"04"CUENTA CERRADA- NO REINTENTE
"05"RECHAZADA- CONTACTE A SU EMISOR
"08"OK
"10"RECHAZADA
"12"TRANSACCION INVALIDA- NO REINTENTE
"13"MONTO INVALIDO
"14"TARJETA INVALIDA- CONTACTE A SU EMISOR
"15"EMISOR INVALIDO- NO REINTENTE
"30"RECHAZADA- CONTACTE A SU EMISOR
"41"TARJETA BLOQUEADA- CONTACTE A SU EMISOR
"43"TARJETA BLOQUEADA- CONTACTE A SU EMISOR
"51"EXCEDE SALDO MAXIMO
"54"TARJETA EXPIRADA
"55"PIN INVALIDO
"57"TRANSACCION NO PERMITIDA POR EMISOR
"58"TRANSACCION NO PERMITIDA
"61"EXCEDE SALDO MAXIMO
"62"TARJETA RESTRINGIDA EMISOR
"63"VIOLACION DE SEGURIDAD
"65"EXCEDE MAXIMO DE TRANSACCIONES
"70"RECHAZADA- CONTACTE A SU EMISOR
"71"PIN INVALIDO
"75"EXCEDE INTENTOS DE PIN PERMITIDOS
"76"CUENTA INVALIDA- CONTACTE A SU EMISOR
"77"CUENTA INVALIDA- CONTACTE A SU EMISOR
"78"TARJETA INACTIVA- CONTACTE A SU EMISOR
"79"Declinada - Ciclo de vida Mastercard
"81"RECHAZADA- CONTACTE A SU EMISOR
"82"Declinada - Politica Mastercard
"83"Declinada - Seguridad Mastercard
"84"RECHAZADA
"85"APROBADA
"86"PIN INVALIDO
"87"APROBADA SOLO PARA TRANSACCIONES CON VUELTO
"88"RECHAZADA- CONTACTE A SU EMISOR
"89"PIN INVALIDO
"91"RECHAZADA- SISTEMA EMISOR NO OPERATIVO
"92"RECHAZADA- SISTEMA EMISOR NO OPERATIVO
"94"RECHAZO POR DUPLICIDAD DE TRANSACCION
"96"RECHAZADA- SISTEMA EMISOR NO OPERATIVO
Visa
Response CodeDescripción
"00"OK
"01"RECHAZADA- CONTACTE A SU EMISOR
"02"RECHAZADA- CONTACTE A SU EMISOR
"03"COMERCIO INVALIDO- RESTRINGIDO POR EMISOR
"04"CUENTA CERRADA- NO REINTENTE
"05"RECHAZADA- CONTACTE A SU EMISOR
"06"RECHAZADA- CONTACTE A SU EMISOR
"07"CUENTA CERRADA- NO REINTENTE
"10"AUTORIZACION PARCIAL
"11"APROBADA
"12"TRANSACCION INVALIDA- NO REINTENTE
"13"MONTO INVALIDO
"14"TARJETA INVALIDA- CONTACTE A SU EMISOR
"15"EMISOR INVALIDO- NO REINTENTE
"19"REINTENTE- EMISOR NO DISPONIBLE
"1A"SE REQUIERE INFORMACIÓN ADICIONAL DE CLIENTE
"21"TARJETA INACTIVA- CONTACTE A SU EMISOR
"25"RECHAZADA- CONTACTE A SU EMISOR
"28"ARCHIVO NO DISPONIBLE PARA ACTUALIZACION
"39"TARJETA INVALIDA- CONTACTE A SU EMISOR
"41"TARJETA BLOQUEADA- CONTACTE A SU EMISOR
"43"TARJETA BLOQUEADA- CONTACTE A SU EMISOR
"51"EXCEDE SALDO MAXIMO
"52"CUENTA INVALIDA- CONTACTE A SU EMISOR
"53"CUENTA INVALIDA- CONTACTE A SU EMISOR
"54"TARJETA EXPIRADA
"55"PIN INVALIDO
"57"TRANSACCION NO PERMITIDA POR EMISOR
"58"TRANSACCION NO PERMITIDA
"59"RECHAZADA- CONTACTE A SU EMISOR
"61"EXCEDE SALDO MAXIMO
"62"TARJETA RESTRINGIDA EMISOR
"63"VIOLACION DE SEGURIDAD
"64"MONTO NO COINCIDE CON TRANSACCION ORIGINAL
"65"EXCEDE MAXIMO DE TRANSACCIONES
"74"PIN INVALIDO
"75"EXCEDE INTENTOS DE PIN PERMITIDOS
"76"TRANSACCION SIN RESPUESTA
"79"TRANSACCION SIN RESPUESTA
"80"NO HAY IMPACTO FINANCIERO
"81"RECHAZADA- CONTACTE A SU EMISOR
"82"CODIGO DE SEGURIDAD INVALIDO
"85"FALLA EN LA VERIFICACION DE LA CUENTA
"86"PIN INVALIDO
"89"RECHAZADA- CONTACTE A SU EMISOR
"91"RECHAZADA- SISTEMA EMISOR NO OPERATIVO
"92"RECHAZADA- SISTEMA EMISOR NO OPERATIVO
"93"TRANSACCION RESTRINGIDA POR EMISOR
"94"RECHAZO POR DUPLICIDAD DE TRANSACCION
"96"RECHAZADA- SISTEMA EMISOR NO OPERATIVO
"B2"TRANSACCION NO PERMITIDA POR EMISOR
"N0"FORZAR STIP
"N3"TRANSACCION NO PERMITIDA POR EMISOR
"N4"EXCEDE SALDO MAXIMO
"N7"CODIGO DE SEGURIDAD INVALIDO
"N8"EXCEDE SALDO MAXIMO
"Q1"TARJETA INVALIDA- CONTACTE A SU EMISOR
"R0"RECHAZADA- CONTACTE A SU EMISOR
"R1"RECHAZADA- CONTACTE A SU EMISOR
"R2"TRANSACCION NO CALIFICADA PARA VISA PIN
"R3"RECHAZADA- CONTACTE A SU EMISOR
"Y1"OK
"Y3"OK
"Z1"RECHAZADA- CONTACTE A SU EMISOR
"Z3"RECHAZADA- CONTACTE A SU EMISOR
"Z5"Cuenta Valida - Monto no disponible
American Express
Response CodeDescripción
"00"OK
"10"AUTORIZACION PARCIAL TARJETA PREPAGO
"05"RECHAZADA- CONTACTE A SU EMISOR
"54"TARJETA EXPIRADA
"75"EXCEDE INTENTOS DE PIN PERMITIDOS
"01"RECHAZADA- CONTACTE A SU EMISOR
"03"COMERCIO INVALIDO- RESTRINGIDO POR EMISOR
"13"MONTO INVALIDO
"14"CUENTA INVALIDA- CONTACTE A SU EMISOR
"57"TRANSACCION NO PERMITIDA POR EMISOR
"55"PIN INVALIDO
"N7"CODIGO DE SEGURIDAD INVALIDO
"06"RECHAZADA- CONTACTE A SU EMISOR
"04"RECHAZADA- CONTACTE A SU EMISOR
"00"AVISO ACEPTADO
"96"TRANSACCION SIN RESPUESTA
"91"ERROR EN SISTEMA DEL EMISOR