Ejecución de los pagos programados
Diariamente, Portal Carat procesará los pagos programados para el día en cuestión y actualizará los datos de los horarios ejecutados, como el número actual de ejecuciones. Si el cronograma ya se ha ejecutado el número de veces deseado por el comerciante, su estado cambiará a FIN (finalizado) y no se tendrá en cuenta en el procesamiento futuro, ya que solo se verán los cronogramas con el estado ATV (activo). ejecutado.
El número actual de ejecuciones de un cronograma solo se incrementará en pagos confirmados o denegados. En caso de transacciones denegadas, Portal Carat no las volverá a procesar.
Por cada pago realizado, Portal Carat realizará un POST en la URL de estado de la tienda configurada en Portal Carat, informando varios datos del pago recurrente.
Aviso de estado de pago recurrente#
En el registro de la tienda, se debe ingresar una URL de estado , donde Portal Carat enviará un POST HTTPS (x-www-form-urlencoded) que contiene el estado de la transacción además de los siguientes parámetros:
Para usar este ejemplo, no olvide definir la variable {{url}} con el valor
esitef-homologacao.softwareexpress.com.br
| Parámetro | Descripción | Formato |
|---|---|---|
nit | Identificador de transacción NIT | = 64 A |
request | Código de pedido (en la 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 | Estado de la transacción de pago en Portal Carat. [Más información.] (Api-codes.md # e-sitef-transaction-status) | = 3 A |
cupón | 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 |
couponEstablishment | Cupón del establecimiento en caso de pago realizado. No contiene saltos de línea, cada línea está separada por una "@". | < 4000 A |
autorizador | Código de autorizador (en Portal Carat) | < 10 A |
PaymentType | 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. Atención: este parámetro solo se envía para transacciones confirmadas que fueron enrutadas por SiTef. | = 19 A |
dateEffective | 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 |
parcels | Número de paquetes | < 2 N |
Financetype | Tipo de financiación elegido por el cliente. 3 = cuotas del administrador (con intereses), 4 = cuotas de la tienda (sin intereses). | = 1 N |
message | Mensaje del autorizador | < 1024 A |
network | Nombre de la red a través de la cual se realiza el pago | < 500 A |
| «número de autorización» | Número de autorización (generado por el autorizador) | = 6 A |
tid | TID de transacción, presente solo cuando se realiza a través de métodos de pago externos. | = 40 A |
eci | Indicador de comercio electrónico (ECI) de la transacción presente solo en transacciones con autenticación. | = 3 A |
flag | Código de la marca de tarjeta utilizada en la transacción, de acuerdo con la tabla de códigos de la marca de la tarjeta (Anexo D). | < 5 N |
binCard | BIN (6 primeros dígitos) de la tarjeta utilizada para el pago. | = 6 N |
finalCard | Últimos 4 dígitos de la tarjeta utilizados para el pago. | = 4 N |
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 .
No es necesario devolver nada en el POST, pero si el POST no se realiza correctamente (código de estado HTTP 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 advertencia.
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.
Restricciones de programación#
Las funciones no admitidas por el programa se enumeran a continuación:
- Envío de prefijos SiTef
- Pagos con autenticación
- Pagos con análisis de fraude
- Transacciones IATA
- Uso de tarjeta de cifrado SiTef
- Envío del código de seguridad en pagos programados