Servicio de consulta de transacciones
La aplicación de la tienda debe realizar la consulta de estado cuando haya problemas para recibir el estado de la transacción.
Flujo#
Para realizar la consulta, la tienda debe realizar un POST en la siguiente dirección:
https://esitef-homologacao.softwareexpress.com.br/e-sitef-hml/consultarTransacao.se?nit=XXXXX
Donde XXXXX es el NIT recibido por el sitio web del Portal Carat en la solicitud de consulta. La respuesta será "OK" si la transacción NIT es correcta y la comunicación finaliza.
El Portal Carat enviará un POST / HTTPS a la URL de advertencia de estado registrada en el servidor de Portal Carat, enviando como parámetro el código de estado de la transacción. La tienda debe estar preparada para lidiar con estos estados y con la llamada HTTPS (SSL / TLS) en la URL de advertencia de estado registrado.
El pago POST / HTTPS en línea puede no ser inmediato, pero será asincrónico, con variaciones en el tiempo dependiendo del servidor y la carga de Internet. En caso de que haya algún problema en el envío, Portal Carat intentará reenviar el mensaje transcurrido un tiempo determinado.
Cabe recordar que la tienda debe aceptar el POST vía HTTPS vía SSL / TLS con un certificado válido, e incluso si es válido, puede ser necesario importarlo a Portal Carat
Otro punto importante es que Portal Carat siempre espera la respuesta 200 ("OK") en la URL de advertencia de estado, no aceptando en ningún caso un redireccionamiento (302) a otra URL y mucho menos a otro sitio web.
Atención :
La consulta del estado de la transacción en el Portal Carat NO consulta el estado de la transacción en el adquirente / autorizador . Este servicio devuelve el estado de la transacción en la base de datos electrónica. SiTef.
Ejemplo: Si se confirma una transacción de pago en PayPal, pero se revierte a través de Llame directamente al adquirente / autorizador, esta extorno no será necesariamente reflejado en el servicio de consulta del estado de Portal Carat.
¿Cuándo usar la Consulta de estado?#
Si por alguna razón la aplicación del comerciante alcanza el timeout y no recibe el aviso de estado de Portal Carat, debido a algún problema de infraestructura o incluso un problema en el servidor que impidió la recepción de la respuesta, en este caso la aplicación del comerciante deberá realizar el Consulta de Status. En esta consulta, la aplicación del comerciante recibe todos los parámetros de la transacción, que habría recibido si el aviso de Status se hubiera recibido con normalidad. De esta forma, se evita que se envíe dos veces un mismo pago o que se abandone un pago que ya ha sido enviado y luego se cargue en la factura de la tarjeta.
Es sumamente importante que la aplicación del comerciante conozca el estado de la transacción en Portal Carat antes de realizar cualquier procesamiento de la transacción, evitando así que el cliente vuelva a intentar pagar por el mismo pedido, sin conocer el resultado del pago. enviado previamente.
Ejemplo:
Si la URL del aviso de estado de la tienda registrada es:
https://www.lojateste.com.br/status.php
La tienda recibirá un POST en:
https://www.lojateste.com.br/status.php
Con los parámetros:
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 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á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.
Atención:
No abuse de la llamada de Servicio de consulta de status, llamándola constantemente, de lo contrario Portal Carat se convertirá en ignorar las llamadas.