Servicio de aviso de Status
Importante:
Para que el aviso de estado funcione en las transacciones REST, la tienda debe estar configurada en la versión 6. Si tiene alguna pregunta, póngase en contacto con el equipo de producción.
En el registro de la tienda, se debe ingresar una URL de Staus , donde Portal 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 do 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 | Portal Carat NSU | = 15 A |
status | Status del pedido. Más información. | = 3 A |
cupom | Cupón 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 | Cupón 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). Sepa mas. | < 10 A |
tipoPagamento | Tipo de pago: C = Crédito, D = Débito, B = Boleto | = 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). | = 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 de retorno numérico. | < 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 |
Además de los campos descritos anteriormente, si se vincula una [transacción de recarga] (recarga-html-fluxo.md), se devolverán los siguientes campos:
Parámetro | Descripción | Formato |
---|---|---|
recarga.nit | Identificador de transacción NIT. | = 64 A |
recarga.nsusitef | Número secuencial único de SiTef. | < 10 A |
recarga.nsuhost | Número secuencial único del Autorizador. | < 20 A |
recarga.nsuesitef | NSU de Portal Carat. | = 15 A |
recarga.status | Status de la orden | = 3 A |
recarga.cupom | Cupón de recarga (a través del cliente) en caso de que se realice una recarga. No contiene saltos de línea, cada línea está separada por "@" en lugar de un salto de línea. | < 4000 A |
recarga.cupomestabelecimento | Cupón del establecimiento en caso de recarga realizada. No contiene saltos de línea, cada línea está separada por una "@". | < 4000 A |
recarga.codigoconcessionaria | Código de Distribuidor (en GwCel). | < 10 A |
recarga.rede | Código del Comprador. | < 4 N |
recarga.dataefetivacao | Fecha de pago en formato DD/MM/AAAA hh: mm:SS en caso de pagos que no sean vía SiTef. ATENCIÓN : este parámetro solo se envía para transacciones confirmadas que no fueron enrutadas por SiTef. | = 19 A |
recarga.dataefetivacaositef | Fecha de pago en formato DD/MM/AAAA hh: mm: SS. ATENCIÓN : Este parámetro solo se envía para transacciones confirmadas que fueron enrutadas por SiTef. | = 19 A |
recarga.dadosconfirmacao | Datos de confirmación de recarga (secuencia alfanumérica). | = 12 A |
recarga.telefone | Número de teléfono de recarga. | < 20 N |
recarga.ddd | Código de área del teléfono descrito en la recarga. | < 4 N |
recarga.valor | Valor de la recarga. | < 12 N |
recarga.codigorespostahost | Código de respuesta enviado por el distribuidor. | < 4 N |
recarga.codigorespostasitef | Código de respuesta enviado por el SiTef. | < 4 N |
recarga.mensagemrespostahost | Mensaje de respuesta enviado por el distribuidor. | < 64 A |
recarga.mensagemrespostasitef | Mensaje de respuesta enviado por el SiTef. | < 64 A |
Importante:
Además de los parámetros anteriores, el Portal 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), Portal 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 Portal 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, Portal 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 de notificación de cambio de Status:
Intentos infructuosos de notificar el cambio de Status: