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.