Cheque Electrónico

Guía de integración Comercio-eCheck

Introducción

El propósito de este documento es brindar al usuario una guía que permita integrar su aplicación de
comercio electrónico a Cheque Electrónico Banorte.

El Comercio podrá recibir a Clientes de Banorte que tengan contratado el servicio de Banorte por
Internet (BxI).

Proceso de compra

Dentro de cada comercio electrónico, y una vez integrado el comercio, el proceso que generalmente se
sigue al realizar una compra es el siguiente:

1. El Cliente del comercio inicia una sesión de compra en la tienda virtual.

2. El Cliente navega a través de la tienda virtual, observando los distintos productos que se ofrecen
para su venta (catálogo).
3. El Cliente selecciona los productos que desea adquirir y al momento de cerrar la compra se
despliega un formulario de pago donde se muestran los productos seleccionados, los costos y el
costo total del pedido, adicional a esto se le indican las formas de pago (tarjeta o cheque Banorte).
4. El Cliente selecciona Cheque Electrónico Banorte, el sistema permite que se abra una pantalla de
Banorte donde le solicita al Cliente su información.
5. El Cliente captura su Usuario y Password de BxI (Banorte por Internet), el cual si es correcto le
permitirá acceder al sistema.
6. Una vez dentro del sistema de Banorte, este presentará la información básica mandada por el
comercio, esto con el fin de que el Cliente seleccione la cuenta con la que realizará el pago.
7. Una vez seleccionada la cuenta, el cliente captura su código (de BxI) para autorizar el cargo a la
cuenta y luego selecciona pagar, cerrando la conexión con Banorte.
8. Una vez cerrada la conexión con Banorte, el sistema del comercio recibirá un HTTPHeader que le
permitirá al comercio presentar al Cliente el resultado de la operación.

Variables de envío a eCheck

Acceso a la pantalla de Login de Cheque Electrónico (https://www.banorte.com/echeck/login.jsp) para

autenticación de usuario a Banorte por Internet (BxI), el cual recibe información con el método POST.

La página que recibirá el pago deberá invocar esta pantalla de login, ya sea en la misma ventana o
bien como una ventana pop-up.

La información concerniente a las transacciones, que deberá ser enviada como parámetros a esta
forma se describe a continuación:

Campo Tipo Descripción

target Alfanumérico Este campo es opcional. Puede ser
utilizado si la página que origina la
transacción abrió una ventana “popup”
para acceder al servicio de cheque
electrónico. Aplica para el caso en que
la página origen use frames e indica el
nombre del frame al que se desea
enviar la respuesta (indicada en
“responseUrl”) Si se desea que la
respuesta se envíe a la misma ventana
especificar el valor: “_self”
 txCount Numérico entero (2 Número de transacciones (pagos) que
digitos máximo) están siendo enviadas para ser
procesadas.
responseUrl Alfanumérico URL que recibirá la respuesta
(resultado) de las transacciones.
mode Alfanumérico Indicador de modo de la transacción.
Puede utilizarse uno de los siguientes
valores P ó T.

Donde:

P = Modo producción. Las transacciones

se realizan en modo real.

T = Modo prueba. Las transacciones no

se realizan en modo real. El banco
responde en forma aleatoria con un
rechazo o una confirmación ficticia.
txId<No. consecutivo> Alfanumérico (20 Número de referencia interno para
caracteres máximo) identificar a la transacción “n”.
clientId<No. Alfanumérico (10 Identificador único asignado por
consecutivo> caracteres máximo) Banorte para el proveedor del servicio
de cheque electrónico, para la
transacción “n”
reference<No. Numérico entero (10 Número de referencia para el cliente
consecutivo> dígitos máximo) para la transacción “n”.
concept<No. Alfanumérico (40 Concepto para la transacción “n”.
consecutivo> caracteres máximo)
amount<No. Numérico decimal (7 Monto a pagar para la transacción “n”.
consecutivo> enteros, 2 decimales
máximo)

Nota: Los números consecutivos deben comenzar en 1 y se incrementan hasta completar el número de
transacciones indicadas en txCount.

Ejemplo:

<input type="hidden" name="txCount" value="2">

<input type="hidden" name="responseUrl" value="http://www.comercio.com/echeck/paymentResult.asp">
<input type=”hidden” name=”mode” value=”T”>

<input type="hidden" name="txId1" value="GAB1077232">

<input type="hidden" name="clientId1" value="CHE102303040">
<input type="hidden" name="reference1" value="12345678">
<input type="hidden" name="concept1" value="Pago de tenencia">
<input type="hidden" name="amount1" value="150.00">

<input type="hidden" name=" txId2" value=”GAH234344234">

<input type="hidden" name="clientId2" value="CHE102303040">
<input type="hidden" name="reference2" value="1111">
<input type="hidden" name="concept2" value="Cargo por mensajeria">
<input type="hidden" name="amount2" value="150.23">
Variables de recepción de eCheck

Una vez que las transacciones hayan sido procesadas se enviará el resultado de las mismas al sitio de
Internet en donde se realizó la transacción, utilizando el URL que haya sido especificado como página de
resultado.

La información que será enviada se muestra a continuación:

Campo Tipo Descripción

txCount Numérico entero (2 Número de transacciones (pagos) que
digitos máximo) fueron procesadas.
txId<No. consecutivo> Alfanumérico (20 Número de referencia interno para
caracteres máximo) identificar a la transacción “n”.
reference<No. Numérico entero (10 Número de referencia para la
consecutivo> dígitos máximo) transacción “n”.
confirmation<No. Numérico entero (20 Número de confirmación de operación
consecutivo> digitos máximo) para la transacción “n”, en caso de ser
exitosa.
status<No. consecutivo> Numérico entero (1 Estatus de la transacción “n”
digito) 0 = Transacción exitosa
1 = Error en transacción
message<No. Alfanumérico (500 Mensaje de error para la transacción
consecutivo> caracteres máximo) “n” en caso de existir una falla.

Nota: Los números consecutivos deben comenzar en 1 y se incrementan hasta completar el número de
transacciones indicadas en txCount.

El monto mínimo con el cual se puede aceptar una transacción es de 20 pesos, por lo que si se desea
mandar una prueba en producción este no debe ser menor a este monto.