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Í |
#
EjemploSolicitud:
Respuesta:
Códigos de respuesta
Ver referencia en Códigos API - Códigos de respuesta
#
Parámetros de solicitudPará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 respuestaPará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 |