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á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 |
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 |
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 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
#
Parámetros de POST de aviso de statusEn la siguiente tabla, hay una descripción de los parámetros enviados por Portal Carat en el POST de aviso de status:
Parámetro | Descripción | Formato |
---|---|---|
nsuSitef | NSU generada en la tienda | = 6 AN |
nit | Identificador de transacción en Carat | = 64 AN |
pedido | Código de pedido del pago | < 20 AN |
status | Estado 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.