Servicio de captura de autorización previa
El flujo sería: realizar la operación de ejecución de preautorización y si se aprueba el resultado, se debe consumir el servicio de captura para completar el flujo. La captura se realizará en el momento definido por las reglas de negocio de la aplicación.
Detalles de la llamada#
- Recurso:
/v1/preauthorizations/capture/{nit} - Método HTTP:
POST - Formato de solicitud:
JSON - Formato de respuesta:
JSON - Parámetros de encabezado:
| Nombre del parámetro | Descripción | Formato | Obligatorio |
|---|---|---|---|
Content-Type | Valor fijo application/json | = 15 AN | SÍ |
merchant_id | Código de la tienda en el Carat. Los códigos de producción y certificación serán diferentes | < 15 AN | SÍ |
merchant_key | Clave de autenticación para la tienda de Carat. Las claves de producción y certificación serán diferentes. | < 80 AN | SÍ |
Ejemplo#
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 | |||
|---|---|---|---|---|---|---|
amount | Monto total de la compra (en centavos). | < 12 N | SI | |||
card | El envío de datos de la tarjeta es obligatorio para las transacciones de enrutamiento de SiTef excepto para el adquirente Cetelem . Solo se debe usar uno entre los campos: | |||||
number | Número de tarjeta del comprador (PAN). | < 19 N | COND. | |||
expiry_date | Fecha de vencimiento de la tarjeta en formato MMAA. | = 4 N | COND. | |||
security_code | Código de seguridad. | < 5 N | COND. | |||
Parámetros de respuesta#
| Parámetro | Descripción | Formato | |
|---|---|---|---|
code | Código de respuesta de Carat. Cualquier código que no sea "0" significa error. Para obtener más información, consulte el documento adjunto A-2 - Códigos de respuesta. | < 4 N | |
message | Mensaje de respuesta de Carat. | < 500 AN | |
capture | |||
authorizer_code | Código de respuesta del autorizador. | < 10 AN | |
authorizer_message | Mensaje de respuesta del autorizador. | < 500 AN | |
status | Status de la transacción de preautorización en Carat. | = 3 AN | |
nit | Identificador de la transacción de preautorización en Carat. | = 64 AN | |
order_id | |||
customer_receipt | Recibo (vía cliente). | < 4000 AN | |
merchant_receipt | Recibo (vía establecimiento). | < 4000 AN | |
authorizer_id | Código de autorización utilizado en la transacción. | < 4 N | |
acquirer_id | Código de la entidad adquirente/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 vigencia de la preautorización devuelta por el autorizador en el 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 preautorización de Carat. | = 15 N | |
sitef_usn | Número secuencial único de la transacción de preautorización en SiTef. | = 6 N | |
host_usn | Autorizador NSU. | < 15 AN | |
amount | Importe de la compra especificado por la tienda (en centavos) al momento de la creación de la transacción. | < 12 AN | |
issuer | Código de marcas de tarjeta devuelto por la autorizadora. | < 5 AN | |
authorizer_merchant_id | Código de afiliación del comerciante con la agencia autorizadora. | < 100 AN |