Servicio de edición de autorización previa
El enrutamiento GetnetLac permite _ cambiar el valor de una autorización previa no capturada_. Consulte nuestro Soporte para ver si existen otras rutas con esta funcionalidad. Para usar esta funcionalidad, simplemente vuelva a llamar a la operación doPreAuthorization con los datos de una transacción de preautorización con estado CON (confirmado) con la adición del campo amount. A continuación 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 en el Portal Carat. Obtenido al devolver la llamada a beginTransaction. | = 64 A | Si |
authorizer_id | Código de autorizador en el Portal Carat. Consulte [lista de autorizadores] (autorizadores.md). | ≤ 3 N | Si |
amount | Monto total de la compra (en centavos). | ≤ 12 N | Si |
number | Número de tarjeta del comprador (PAN). | ≤ 19 N | Si |
token | Se utiliza para casos de pagos recurrentes, donde la tarjeta ya debe estar almacenada en la base de datos de pagos en línea. Obligatorio utilizar uno de los campos (número, token o initial_wallet_transaction_id) | = 88 A | Condicional |
expiry_date | Fecha de vencimiento en formato MMYY. | = 4 N | Si |
security_code | Código de seguridad. | ≤ 5 N | Si |
ecomm_pos_ref | Este campo enviará una identificación que aparecerá en el campo PDV del informe SiTef Web para transacciones de comercio electrónico. | ≤ 8 AF | No |
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 | Adquiriente / código de enrutamiento utilizado en la transacción. | <4 N |
acquirer_name | Nombre del adquirente / enrutamiento utilizado en la transacción. | <100 AN |
amount | Monto de compra especificado en la tienda (en centavos). | <12 AN |
authorization_number | Numero de autorización. | <6 AN |
authorizer_code | Código de respuesta del autorizador. | <10 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: 07/13 / 2017T16: 03 | = 16 D |
authorizer_id | Código de autorización utilizado en la transacción. | <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. | <500 AN |
customer_receipt | Cupón (a través del cliente). | <4000 AN |
eci | Eletronic Commerce Indicator (indicador del nivel de seguridad de la transacción de autorización previa a través de Cielo e-Commerce). | <3 AN |
sitef_usn | Número secuencial único de la transacción de autorización previa en Portal Carat. | = 6 N |
host_usn | NSU del autorizador . | <15 AN |
issuer | Código de la marca de la tarjeta devuelto por el autorizador. | <5 AN |
merchant_receipt | Cupón (vía establecimiento). | <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 autorización previa en 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 = comprobante bancario, 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, W = comprobante bancario NR vía Web Service | = 1 A |
sitef_usn | Número secuencial único de la transacción de autorización previa en SiTef. | = 6 N |
status | Sstado de la transacción de autorización previa en Portal Carat. | = 3 AN |
tid | ID de transacción en adquirente / enrutamiento. Este campo solo se devuelve en transacciones con adquirentes que no son SiTef. | <40 AN |
xid | Campo XID devuelto en autenticaciones 3DS o ciertos adquirientes / rutas. | <40 AN |
En caso de éxito, se devolverá el responseCode ** '0' **. El estado de la transacción no cambiará en hipótesis
cualquiera (éxito o fracaso). Sin embargo, los campos sitef_usn, host_usn, authorization_number, sitef_date, customer_receipt e merchant_receipt cambiarán si se confirma el cambio.