Servicio de aviso de Status
En cada cambio de status de la transacción, Carat notificará a la tienda de dichos cambios como se muestra en la siguiente figura:
En el registro de la tienda, se debe ingresar una URL de Status , donde Carat enviará un POST que contiene el status de la transacción con los siguientes parámetros:
Parámetro | Descripción | Formato |
---|---|---|
nit | Transacción NIT | = 64 A |
pedido | Código del Pedido (en tienda) | < 20 A |
nsu | Número secuencial enviado por la tienda | < 12 N |
nsuSitef | Número secuencial único de SiTef | < 10 A |
nsuHost | Número secuencial único del autorizador | < 20 A |
nsuesitef | Carat NSU | = 15 A |
status | Status del pedido. Más información. | = 3 A |
cupom | Recibo de pago (a través del cliente) en caso de pago realizado. No contiene saltos de línea, cada línea está separada por "@" en lugar de un salto de línea. | < 4000 A |
cupomEstabelecimento | Recibo del establecimiento en caso de pago realizado. No contiene saltos de línea, cada línea está separada por una "@". | < 4000 A |
autorizadora | Código de autorizador (en Portal Carat). Más información. | < 10 A |
tipoPagamento | Tipo de pago: C = Crédito, D = Débito, B = Billete | = 1 A |
dataSitef | Fecha de pago en formato DD/MM/AAAA hh:mm:SS :mm:SS.Atención: este parámetro solo se envía para transacciones confirmadas que fueron enrutadas por SiTef. | = 19 A |
dataEfetivacao | Fecha de pago en formato DD / MM / AAAA hh: mm: SS para pagos que no son a través de SiTef. Atención: este parámetro solo se envía para transacciones confirmadas que no fueron enrutadas por SiTef. | = 19 A |
parcelas | Número de plazos | < 2 N |
tipoFinanciamento | Tipo de financiación elegido por el cliente. 3 = cuotas del administrador (con intereses), 4 = cuotas de la tienda (sin intereses). | = 1 N |
mensagem | Mensaje del autorizador | < 1024 A |
codigoRespostaAutorizadora | Código de respuesta del autorizador | < 1024 A |
rede | Nombre de la red a través de la cual se realiza el pago | < 500 A |
numeroAutorizacao | Número de autorización (generado por el autorizador) | = 6 A |
tid | Transacción TID, presente solo cuando se realiza a través de Cielo eCommerce, e-Rede y e.Rede REST | = 40 A |
eci | Eletronic Comerce Indicator (ECI) de la presente transacción solo cuando se realiza a través de Verified By Visa o Secure Code Mastercard. | = 3 A |
bandeira | Código de la tarjeta utilizada en la transacción. NOTA: Este campo normalmente se envía en transacciones a través de SiTef. | < 5 N |
analise.status | Status de la transacción de análisis de riesgo. (NOV = nuevo, EXP = vencido, ACC = aceptado, REJ = denegado, REV = en revisión) | =3 A |
analise.codigo | Código numérico de retorno. | < 3N |
analise.mensagem | Devolver mensaje de la institución de revisión | <30 A |
NITTransacaoSecundaria | NIT’s desde transacciones secundarias (separadas por & # 124; pipe), para transacciones split. | < 1040 A |
binCartao | BIN (6 primeros dígitos) de la tarjeta utilizada para el pago. | = 6 N |
finalCartao | Últimos 4 dígitos de la tarjeta utilizados para el pago. | = 4 N |
Importante:
Además de los parámetros anteriores, el Carat puede devolver otros sin previo aviso . Esté preparado para recibir parámetros adicionales además de los de la tabla anterior, que pueden ignorarse . Sin embargo, en algunos casos, los parámetros adicionales devueltos por ciertos autorizadores se enviarán juntos.
No es necesario devolver nada en el POST, pero si el POST no se realiza correctamente (HTTP Status-Code 200: OK), Carat volverá a intentarlo hasta el número de veces configurado en el sistema, antes de darse por vencido y dejar la transacción como pendiente de notificación, como se muestra en las figuras abajo.
Lo POST/HTTPS del Carat puede no ser inmediato, pero será asincrónico, y el tiempo variará según el servidor y la carga de Internet. Si hay algún problema en el envío, Carat intentará reenviar el mensaje transcurrido un tiempo determinado, siendo 3 (tres) intentos.
No todos los parámetros pueden estar presentes en todas las transacciones, algunos parámetros pueden no enviarse dependiendo del método de pago o si la transacción no se completa, por ejemplo.
Intentos infructuosos de notificar el cambio de Status: