Home

Descripción general

  • API REST

    • Web Checkout

      • Link de Pago

        • Notificaciones

        • Reintentos Automáticos

          • Códigos de Retorno

            • Portal de la Tienda

              • 3D Secure 2.0

                • Conexiones Adquirentes

                  • Métodos de pago

                    • Integraciones Antifraude

                      • Gestión de Tiendas

                        • Información Generale

                          Servicio de aviso de Status

                          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
                          parcelasNúmero de plazos< 2 N
                          tipoFinanciamentoTipo de financiación elegido por el cliente. 3 = cuotas del administrador (con intereses), 4 = cuotas de la tienda (sin intereses).= 1 N
                          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
                          tidTransacción TID, presente solo cuando se realiza a través de Cielo eCommerce, e-Rede y e.Rede REST= 40 A
                          eciEletronic Comerce Indicator (ECI).= 3 A
                          bandeiraCó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.statusStatus de la transacción de análisis de riesgo. (NOV = nuevo, EXP = vencido, ACC = aceptado, REJ = denegado, REV = en revisión)=3 A
                          analise.codigoCódigo de retorno numérico.< 3N
                          analise.mensagemDevolver mensaje de la institución de revisión<30 A
                          NITTransacaoSecundariaNIT’s desde transacciones secundarias (separadas por & # 124; pipe), para transacciones split.< 1040 A
                          binCartaoBIN (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ámetroDescripciónFormato
                          recarga.nitIdentificador de transacción NIT.= 64 A
                          recarga.nsusitefNúmero secuencial único de SiTef.< 10 A
                          recarga.nsuhostNúmero secuencial único del Autorizador.< 20 A
                          recarga.nsuesitefNSU de Portal Carat.= 15 A
                          recarga.statusStatus de la orden= 3 A
                          recarga.cupomCupó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.cupomestabelecimentoCupón del establecimiento en caso de recarga realizada. No contiene saltos de línea, cada línea está separada por una "@".< 4000 A
                          recarga.codigoconcessionariaCódigo de Distribuidor (en GwCel).< 10 A
                          recarga.redeCódigo del Comprador.< 4 N
                          recarga.dataefetivacaoFecha 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.dataefetivacaositefFecha 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.dadosconfirmacaoDatos de confirmación de recarga (secuencia alfanumérica).= 12 A
                          recarga.telefoneNúmero de teléfono de recarga.< 20 N
                          recarga.dddCódigo de área del teléfono descrito en la recarga.< 4 N
                          recarga.valorValor de la recarga.< 12 N
                          recarga.codigorespostahostCódigo de respuesta enviado por el distribuidor.< 4 N
                          recarga.codigorespostasitefCódigo de respuesta enviado por el SiTef.< 4 N
                          recarga.mensagemrespostahostMensaje de respuesta enviado por el distribuidor.< 64 A
                          recarga.mensagemrespostasitefMensaje 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:

                          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.