Itaú Shopline
Portal Carat permite la integración del sitio web del comerciante con pagos a través de Itaú Shopline, donde el comprador accede a su propia cuenta a través de la interfaz Itaú para pagar mediante transferencia bancaria, transferencia bancaria o con tarjetas Itaucard.
En esta página se utilizará la nomenclatura " Itaú Shopline " para referirse al enrutamiento en Portal Carat.
Interfaces Portal Carat apoyado para la integración#
Puede utilizar las siguientes interfaces para la integración con el enrutamiento de Itaú Shopline:
- Pago HTML
- Reedición de facturas
Autorizadores permitidos#
Los siguientes autorizadores son compatibles con el enrutamiento de Itaú Shopline:
- Itaú Shopline
Cred necesaria#
La tienda debe obtener de Itaú las credenciales que se enumeran a continuación y pasarlas a Software Express.
| Campo | Descripción del campo | Formato |
|---|---|---|
codigoEmpresa | Código de empresa (tienda) en Itaú. | = 26 AN |
chave | Clave de cifrado para el intercambio de información con Itaú Shopline. | = 16 AN |
Configuraciones requeridas en el Portal Itaú Shopline#
Se deben realizar algunos ajustes en la cuenta del comerciante en Itaú Shopline para una integración perfecta con Portal Carat.
URL de retorno#
Para que la confirmación del pago funcione correctamente, el comerciante debe ingresar a Itaú Bankline con sus credenciales y configurar el campo Shopline Return URL a la URL de Portal Carat a continuación:
| Entorno de producción |
|---|
| https://esitef-ec.softwareexpress.com.br/e-sitef/itau.se |
| Ambiente de Homologação |
| https://esitef-homologacao.softwareexpress.com.br/itau.se |
Esta URL se utiliza para que Itaú confirme el pago en Portal Carat. Hay una limitación de 60 caracteres en Itaú Shopline para la URL, así que tenga cuidado al registrar la URL, que son diferentes para aprobación y producción.
Tenga en cuenta que los cambios en el entorno de Itaú pueden tardar un día hábil en estar disponibles.
A continuación se muestra una copia del manual técnico de Itaú Shopline para acceder a los datos de registro.
(Extraído del manual técnico de Itaú Shopline)
Dentro de Itaú Bankline, la ruta de acceso a esta función es: Produtos e Serviços > Itaú Shopline > Informações Cadastrais
(...)
Atención: Cualquier información modificada en este entorno estará disponible para su uso 1 (un) día hábil después del cambio. Para acceder a Itaú Bankline, es necesario ingresar a la web de Itaú (http://www.itau.com.br/) y digitar:
- Datos de agencia, cuenta corriente y contraseña electrónica en la barra de acceso Itaú Bankline Empresa;
- o datos de Usuario Operador y Contraseña Electrónica en la barra de acceso Itaú Bankline Empresa Plus.
Flujo de pago con Itaú Shopline#
Una vez que se ha configurado este método de pago para la tienda, el flujo de pago ocurre de la siguiente manera:
- El usuario inicia el pago a través de Portal Carat;
- Se presenta al usuario la lista de autorizadores configurados en la tienda;
- El usuario elige el método de pago Itaú Shopline;
- En ese momento se abrirá una nueva ventana, redireccionando al usuario al sitio web Itaú Shopline;
- El usuario inicia el proceso de pago en el sitio web Itaú Shopline.
- El usuario completa el pago en el entorno de Itaú Shopline;
- Itaú Shopline redirige al usuario a Portal Carat, según la URL de retorno configurada.
- Al recibir la redirección del usuario, Portal Carat realiza una consulta a Itaú y actualiza el estado de la transacción en Portal Carat.
- Si la tienda ha configurado la redirección automática, el usuario es redirigido a la URL de éxito o fracaso configurada en Portal Carat.
- Finalmente, si hay un redireccionamiento automático, el usuario vuelve al sitio web de la tienda. En la siguiente figura, podemos ver el flujo descrito anteriormente en el diagrama:
Una excepción a este flujo es el caso en el que la URL de retorno no se registró en Itaú. Por lo tanto, el usuario no será redirigido después de que se complete el pago en Itaú Shopline.
Otro caso posible es iniciar la transacción con la autoridad de autorización prefijada, donde los pasos 2 y 3 no son necesarios.
Por lo tanto, sugerimos que la configuración descrita en URL de retorno hecho correctamente, para permitir una mejor experiencia de compra para el usuario.
Aviso de Status#
Por cada cambio de estado de transacción en Portal Carat, resultante de la comunicación entre Portal Carat e Itaú, un Aviso de Status. Para obtener más detalles sobre esta funcionalidad, consulte Pago HTML en el elemento Aviso de Status.
Parámetros de transacción vía Itaú Shopline#
Los parámetros utilizados para crear una transacción de pago con Itaú Shopline son los mismos que se presentan en Pago HTML en el ítem Iniciar una transacción de pago.
Para pagos con Itaú Shopline, se deben considerar las siguientes características:
Código de orden
Para utilizar el método de pago Itaú Shopline, el código de pedido siempre debe ser diferente para cada transacción y tener solo ocho dígitos. Este código de pedido no puede repetirse durante 60 días (según información de Itaú a 12/2010), y debe ser numérico. Si la tienda envía más de ocho o contiene caracteres alfanuméricos, Portal Carat:
- Eliminar todos los caracteres no numéricos
- Mantenga los últimos ocho dígitos a la izquierda (a la derecha).
- Envíe "0" si no queda nada.
Importante: Portal Carat no verificará si los códigos se repiten, e Itaú Shopline puede incluso aceptar códigos para pedidos repetidos, sin embargo, pueden ocurrir errores a medida que regresan nuevos pedidos impagos según lo confirma Itaú. Portal Carat no se hace responsable de los códigos de pedido repetidos.
Pagos de Itaú Shopline a través de Boleto Bancário
Si el usuario opta por pagar Itaú Shopline mediante comprobante bancario, la confirmación del pago puede demorar hasta un día hábil en ser efectuada por Itaú, y permanecer en status Pendente en Portal Carat durante este período.
Como Itaú no informa a Portal Carat cuando se ha realizado el pago del recibo bancario, Portal Carat puede tardar otro día en confirmar, ya que la investigación que actualiza el estado de los pagos del recibo bancario solo se ejecuta al amanecer. En este caso, la redirección a la URL de éxito por Portal Carat en el caso de elección vía comprobante bancario ocurrirá cuando el comprobante bancario sea generado por Itaú. Corresponderá a la tienda verificar el estado final de la transacción con Portal Carat.
Si se comprueba que la fecha del comprobante bancario ha superado los días configurados para cancelamento, entonces el estado de la transacción cambiará a Expirada, para que se finalicen las consultas sobre el estado de pago del comprobante bancario en Itaú. Si se realiza una transacción de pago con estado Vencido en Portal Carat en el entorno de Itaú, una vez que Itaú notifique a Portal Carat que el pago se ha realizado con éxito, la transacción se reanudará y el pago se realizará con normalidad, si el pago es exitoso, el la transacción tiene su status cambiado desde Expirada para Confirmada.
Tenga en cuenta que por cada actualización de status de las transacciones de Portal Carat, se enviará una publicación a la URL de notificación de status de la tienda registrada en Portal Carat.
Para que el usuario pueda realizar un pago mediante comprobante bancario, la tienda debe enviar la siguiente información a Portal Carat:
| Campo | Descripción | Formato | Obligatorio |
|---|---|---|---|
identification_number | Número de registro del beneficiario (CPF o CNPJ) Si el número de registro del beneficiario tiene más de 11 dígitos, el campo se considerará CNPJ. | < 20 N | SÍ |
name | Para Itaú Shopline, el nombre y apellido más un espacio que los separe debe tener un máximo de 200 caracteres alfanuméricos. | ||
surname | |||
address_street_name | Para la Tienda Itaú, la calle, el número, el complemento de la dirección más los espacios de separación entre ellos deben tener un máximo de 200 caracteres alfanuméricos. | ||
address_street_number | |||
address_street_complement | |||
address_zip_code | Código postal del beneficiario | = 8 N | SI |
CITY | Ciudad dibujada | < 100 AN | SI |
state | Estado del librado | = 2 AN | SI |
neighborhood | Barrio Balcón | < 15 AN | SÍ |
A continuación se muestra un ejemplo de uso en la Interfaz HTML de Portal Carat, con el JSON del objeto request enviado en el POST:
Reedición de resbalones#
Es posible poner a disposición de los compradores la Reedición de comprobantes de pago de Itaú Shopline.
Esta función está disponible a través de la URL:
| Entorno de producción |
|---|
| https://esitef-ec.softwareexpress.com.br/e-sitef/reissue.se?nit=XXX |
| Ambiente de Homologação |
| https://esitef-homologacao.softwareexpress.com.br/e-sitef-hml/reissue.se?nit=XXX |
La nit utilizada para la transacción de pago original, realizada a través de Itaú Shopline, debe ser informada como parámetro POST. El simple hecho de acceder a esta URL ya permite la visualización directa del comprobante bancario reemitido con los mismos datos que la primera emisión.
Si la transacción de pago NO está en el estado esperado, se muestra un mensaje de error.
Atención
La IP nunca debe usarse en lugar del dominio. esitef-ec.softwareexpress.com.br (ou esitef- homologacao.softwareexpress.com.br para ambiente de homologação). La IP puede cambiar en cualquier momento y sin previo aviso, por lo que es importante utilizar siempre el dominio para acceder a Portal Carat.