Servicio de Ejecución de preautorización
Detalles de la llamada#
El nit obtenido en la devolución del servicio de creación de autorización previa debe enviarse en la operación de ejecución de autorización previa junto con los parámetros descritos en la tabla siguiente (según la necesidad de cada aplicación):
- Recurso:
/v1/preauthorizations/{nit} - Método HTTP:
POST - Formato de solicitud :
JSON - Formato de respuesta :
JSON - Parámetros de encabezado :
| Parámetro | Descripción | Formato | Obligatorio |
|---|---|---|---|
Content-Type | Valor fijo application / json | = 15 AN | SI |
merchant_id | Código de tienda en el Portal Carat. Los códigos de producción y certificación serán diferentes | < 15 AN | SI |
merchant_key | Clave de autenticación para la tienda de pagos online. Las claves de producción y certificación serán diferentes. | < 80 AN | SI |
Ejemplos:#
Solicitud:
Respuesta:
Códigos de respuesta
Ver referencia en Códigos API - Códigos de respuesta
Parámetros de solicitud#
| Parámetro | Descripción | Formato | Obligatorio |
|---|---|---|---|
authorizer_id | Código de autorizador en el Carat. Ver documento Autorizadoras. | < 3 N | SI |
number | Número de tarjeta del comprador (PAN). Mayor 14 y menor o igual que 19. | < 19 N | COND. |
expiry_date | Fecha de caducidad "MMAA". | = 4 N | COND. |
security_code | Código de seguridad. De 3 a 5. | < 5 N | COND. |
external_authentication | Este elemento recibe campos de autenticación MPI. | ||
version | Versión de 3DS utilizada en el proceso de autenticación (actualmente solo se acepta la versión 2) | < 1 AN | NO |
eci | Indicador de comercio electrónico: indica el nivel de seguridad de la transacción con autenticación del titular de la tarjeta | < 3 N | NO |
reference_id | Identificador de la operación de autenticación del titular de la tarjeta, realizada en un servicio ajeno al Portal Carat | < 40 N | NO |
cavv | Valor de verificación de autenticación del titular de la tarjeta: código que indica el resultado de la autenticación del titular de la tarjeta. | < 40 N | NO |
Parámetros de respuesta#
La siguiente tabla contiene los parámetros de respuesta del servicio de promulgación de autorización previa. La aplicación debe almacenar los parámetros que considere necesarios. Sugerimos almacenar los parámetros: order_id, autorización_number, merchant_usn, esitef_usn, sitef_usn, host_usn, status, code, amount, message (el parámetromessage se puede mostrar al cliente). authorization_number
| Parámetro | Descripción | Formato | |
|---|---|---|---|
code | Código de respuesta en Carat. Cualquier código que no sea 0 significa falla. Para obtener más información, consulte el documento Códigos de respuesta. | < 4 N | |
message | Mensaje de respuesta de Carat. | < 500 AN | |
pre_authorization | |||
authorizer_message | Mensaje de respuesta del autorizador. | < 500 AN | |
status | Status de la transacción de autorización previa en Carat. | = 3 AN | |
nit | Identificador de la transacción de autorización previa en Carat. | = 64 AN | |
order_id | Código de pedido enviado por la tienda al crear la transacción. | < 40 AN | |
customer_receipt | Recibo (a través del cliente). | < 4000 AN | |
merchant_receipt | Recibo (vía establecimiento). | < 4000 AN | |
authorizer_id | Código de autorizadora en el Carat. Ver documento Autorizadoras. | < 4 N | |
acquirer_id | Adquirente/código de enrutamiento utilizado en la transacción. | < 4 N | |
acquirer_name | Nombre del adquirente/enrutamiento utilizado en la transacción. | < 100 AN | |
authorizer_date | Fecha de ejecución de la autorización previa devuelta por el autorizador en formato DD/MM/AAAA'T'HH:mm. Ejemplo: 13/07/2017T16:03 | = 16 D | |
authorization_number | Numero de autorización. | < 6 AN | |
merchant_usn | Número secuencial único enviado por la tienda al crear la transacción. | < 12 AN | |
esitef_usn | Número secuencial único de la transacción de autorización previa en Carat. | = 15 N | |
sitef_usn | Número secuencial único de la transacción de autorización previa en SiTef. | < = 6 N | |
host_usn | NSU del autorizador. | < 15 AN | |
amount | Importe de compra especificado por la tienda (en céntimos) al crear la transacción | < 12 AN | |
payment_type | Tipo de pago del autorizador elegido: C = crédito, D = débito, O = otros métodos de pago | = 1 AN | |
issuer | Código de bandera devuelto por el autorizador. Banderas. | < 5 AN | |
authorizer_merchant_id | Código de afiliación del comerciante con la agencia autorizadora. | < 100 AN |