Servicio de aviso de Status

Importante:

Para que el aviso de estado funcione en las transacciones PIX 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ámetroDescripciónFormato
nitTransacción NIT= 64 A
pedidoCódigo do Pedido (en tienda)< 20 A
nsuNúmero secuencial enviado por la tienda< 12 N
nsuSitefNúmero secuencial único de SiTef< 10 A
nsuHostNúmero secuencial único del autorizador< 20 A
nsuesitefPortal Carat NSU= 15 A
statusStatus del pedido. Más información.= 3 A
cupomCupó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
cupomEstabelecimentoCupón del establecimiento en caso de pago realizado. No contiene saltos de línea, cada línea está separada por una "@".< 4000 A
autorizadoraCódigo de autorizador (en Portal Carat). Sepa mas.< 10 A
tipoPagamentoTipo de pago: C = Crédito, D = Débito, B = Boleto= 1 A
dataSitefFecha 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
dataEfetivacaoFecha 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
mensagemMensaje del autorizador< 1024 A
codigoRespostaAutorizadoraCódigo de respuesta del autorizador< 1024 A
redeNombre de la red a través de la cual se realiza el pago< 500 A
numeroAutorizacaoNúmero de autorización (generado por el autorizador)= 6 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:

POST de aviso de status:

Para usar este ejemplo, no olvide definir la variable {{url}} con el valor
esitef-homologacao.softwareexpress.com.br

curl -X POST \
https://www.lojateste.com.br/status.php \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'cache-control: no-cache' \
-d 'nsuSitef=315569&nit=9230d962f0afb40db64e082c37564f4b113c3e4fc6a5090c40813c4b0d80ca37&pedido=201808020001&status=CON'

Parámetros de POST de aviso de status#

En la siguiente tabla, hay una descripción de los parámetros enviados por Portal Carat en el POST de aviso de status:

ParámetroDescripciónFormato
nsuSitefNSU generada en la tienda= 6 AN
nitIdentificador de transacción en Carat= 64 AN
pedidoCódigo de pedido del pago< 20 AN
statusEstado de la transacción en Carat= 3 N

Pago Online también puede enviar nuevos parámetros sin previo aviso, lo que significa que la aplicación de la tienda debe estar preparada para recibir campos adicionales y simplemente ignorarlos.