Servicio de incremento de la preautorización
Para determinados enrutamientos, es posible incrementar el valor de una preautorización no capturada. Consulte nuestro servicio para valorar qué enrutamientos tienen esta funcionalidad.
Para usar esta funcionalidad, simplemente llame a la operación doPreAuthorization con los datos de una transacción de preautorización con status CON (confirmado) con la adición del campo additional_amount. Abajo se muestran los detalles de esa llamada.
Parámetros de solicitud:#
| Nombre del parámetro
| Descripción
| Tamaño | Obligatorio |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | ------- | ----------- |
| nit | Identificador de transacción de Portal Carat. Obtenido al devolver la llamada a beginTransaction. | = 64 A | Sí |
| authorizer_id | Código de autorizador de Portal Carat. Consulte [lista de autorizadores] (autorizadores.md). | ≤ 3 N | Sí |
| additional_amount | Valor que se incrementará con la compra (en centavos). | ≤ 12 N | Sí |
| number (\ ) | Número de tarjeta del comprador (PAN). | ≤ 19 N | Sí |
| token (\ ) | Se utiliza para casos de pagos recurrentes, donde la tarjeta ya debe estar almacenada en la base de datos de Portal Carat. | = 88 A | Condicional |
| wallet_transaction_id (\ *) | Código de identificación de transacción con wallet Visa Checkout. | <25 A | Condicional |
| expiry_date | Fecha de vencimiento en formato MMAA. | = 4 N | Sí |
| security_code | Código de seguridad. | ≤ 5 N | Sí |
(*) Uso obligatorio solo uno entre los campos: number, token ou wallet_transaction_id
Parámetros de respuesta:#
| Nombre del parámetro
| Descripción | Tamaño |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
| code | Código de respuesta de Portal Carat. Cualquier código que no sea "0" significa falla. Para obtener más información, consulte el documento Anexo A-2 - Códigos de respuesta.
| <4 N |
| message | Mensaje de respuesta de Portal Carat. | <500 AN |
| acquirer_id| Código de Adquiriente/enrutamiento utilizado en la transacción. | < 4 N |
| acquirer_name | Nombre del adquirente/enrutamiento utilizado en la transacción. | <100 AN |
| amount | Monto total de compra (en centavos), es decir, monto inicialmente preautorizado más el monto incrementado (s). | <12 AN |
| authorization_number | Incrementar el número de autorización. | <6 AN |
| authorizer_code | Incrementar el código de respuesta del autorizador. | <10 AN |
| authorizer_date | Fecha de vigencia del incremento de preautorización devuelto por el autorizador en formato DD/MM/ AAAA'T'HH: mm. Ejemplo: 07/13/2017T16: 03 | = 16 D |
| authorizer_id | Código de autorizador utilizado en el incremento. | <4 N |
| authorizer_merchant_id | Código de afiliación del comerciante con la agencia autorizadora. | < 100 AN |
| authorizer_message | Mensaje de respuesta del autorizador del incremento. | < 500 AN |
| customer_receipt | Cupón (vía cliente) del incremento. | < 4000 AN |
| eci | Eletronic Commerce Indicator (indicador del nivel de seguridad de la transacción de preautorización a través de Cielo e-Commerce). | < 3 AN |
| esitef_usn | Número secuencial único de la transacción de preautorización de Portal Carat.
| = 15 N |
| host_usn | Aumento del autorizador NSU.
| <15 AN |
| issuer | Código de marca de tarjeta devuelto por el autorizador.
| <5 AN |
| merchant_receipt | Cupón (vía establecimiento) del incremento.
| <4000 AN |
| merchant_usn | Número secuencial único enviado por la tienda al crear la transacción.
| <12 AN |
| nit | Identificador de la transacción de preautorización de Portal Carat.
| = 64 AN |
| order_id | Código de pedido enviado por la tienda al crear la transacción.
| < 40 AN |
| payment_type | Tipo de pago del autorizador elegido: B = boleto, C = crédito, D = débito, P = tarjeta de crédito Private Label puro, T = transferencia bancaria, G = tarjeta gift, O = otros medios y pagos | = 1 A |
| sitef_usn | Número secuencial único del incremento de preautorización en SiTef. | = 6 N |
| status | Status del incremento de preautorización de Portal Carat. | = 3 AN |
| tid | Incremento de ID en adquirente/enrutamiento. Este campo sólo se devuelve en las transacciones con adquirentes externos a SiTef.| <40 AN |
| xid | Campo XID devuelto en autenticaciones 3DS o ciertos adquirientes/ enrutamiento. | <40 AN |
En caso de éxito, se devolverá el responseCode '0'. El estado de la transacción en la base de datos de Portal Carat no se modificará en ningún caso (éxito o fracaso).
Los campos sitef_usn, host_usn, authorization_number, sitef_date, customer_receipt y merchant_receipt en la respuesta se refieren al incremento, pero los datos respectivos no se modifican en la base de datos de Portal Carat. Solo el monto total se incrementa en la transacción.
Ejemplo:#
1. Creación y ejecución de preautorización de R$ 20,00:#
a. creación - solicitud#
suponiendo que la creación se haya realizado con éxito.
B. ejecución - solicitud#
c. respuesta#
2. Incremento de preautorización de R$ 2,00#
a. incremento - solicitud#
b. incremento - respuesta#
El detalle de esta respuesta es que el campo amount contiene el valor total preautorizado.