manual ventas
TRANSCRIPT
1
Manual de Vendedores
2
1. Introducción
2. Uso del Manual
3. Descripción general de pagos de DineroMail
4. Creación del Carrito de compras
5. Creación del Botón de compras
6. Modificación manual del Código
7. Funcionamiento del Proceso de Compras
8. Notificación al Vendedor
9. Como utilizar el Carrito de compras externo
10. Operaciones en dólares
11. Cómo vender con montos variables
12. Costos y Límites
13. Contacto
14. Anexo 1: Instrucciones para la consulta
automática de pagos
15. Anexo 2: Especificación técnica IPN 16. Anexo 3: Proceso de Pre-Registro
..:::
Tabla de Contenidos
1
3
..:::
1
Introducción
DineroMail, la empresa líder de pagos online, ha desarrollado sistemas de pago electrónicos que se encuentran a la vanguardia mundial en términos de seguridad, comodidad y conveniencia.
Los servicios de venta que se presentan en este documento permiten a cualquier persona o comercio, con conocimientos mínimos de creación de páginas Web, vender y cobrar en forma fácil y segura en pocos minutos.
Para cobrar en Internet DineroMail ofrece una amplia gama de herramientas de venta. Este documento describe la operatoria de dos (2) de ellas: el ‘Carrito de compras’
y los ‘Botones de compras’. Ambos mecanismos son muy similares, y permiten comenzar con las cobranzas online en unos pocos minutos. Esto se logra completando un simple formulario en el que se especifican el monto y características del producto a vender. DineroMail genera automáticamente un código HTML que puedes colocar en tu página Web o enviar por e-mail (formato HTML). Este código es un botón de compra que presionarán tus compradores para pagarte.
Las alternativas de pago que tiene un comprador son:
Depósitos Referenciados en Sucursales Bancarias de Bancomer, Banamex, Santander y ScotiaBank/Inverlat.
Tarjetas de Crédito Visa, Mastercard
y American Express.
Transferencia Bancaria
Fondos disponibles en la Cuenta DineroMail.
Tiendas OXXO
Tiendas 7-Eleven
2
4
Se arma en pocos minutos.
Es muy simple para tus compradores.
Integra muchos medios de pago.
No requiere PHP y ASP ni características especiales de hosting.
Se puede colocar en cualquier pagina Web, incluso dentro de remates o páginas gratuitas.
Se puede colocar en e-mails con formato HTML.
Incluye el logo de tu comercio.
Permite incluir un mensaje y la dirección de entrega del producto.
Permite personalizar las páginas finales de la compra (una para éxito, otra para fracaso).
Tu
Carrito
de Compras
o Botón
de Compras:
3
5
El Manual para Vendedores de DineroMail proporciona información sobre la mayoría de las funciones de DineroMail, así
como instrucciones para utilizarlas para cubrir sus necesidades de pago en Internet.
Utiliza el Manual para Vendedores de DineroMail para:
..:::
2
Uso
del Manual
Configurar de manera rápida y sencilla la funcionalidad de comercio electrónico con DineroMail. Por ejemplo, aprende a integrar Carritos de compra y Botones de compra de DineroMail en tu sitio Web en cuestión de minutos.
Conocer técnicas y herramientas más avanzadas para sacar el máximo partido a las herramientas de venta de DineroMail.
Entender cual es el proceso de compra que realizaran tus clientes al pagar a través de DineroMail.
El Manual para Vendedores de DineroMail incluye información e instrucciones del uso de las siguientes funciones:
-
Carrito de Compras
-
Botón de Compras
4
6
Las herramientas de venta que se presentan en este documento permiten a cualquier persona o comercio, con conocimientos mínimos de creación de páginas web, comenzar a vender y cobrar de manera fácil, rápida y segura en tan solo unos minutos.DineroMail ofrece una amplia gama de herramientas de venta para que puedas cobrar y recibir pagos a través de Internet. Este documento describe la operatoria de dos de ellas: Carrito de Compras y Botón de Compras
Antes de empezar a operar con DineroMail deberás activar las herramientas de venta en la sección DineroTools
de nuestro sitio web.
Utilizando el Carrito de Compras de DineroMail, tus clientes pueden elegir uno o más ítems, examinar toda su selección, visualizar una lista consolidada de todos los artículos antes de efectuar la compra, y finalmente abonar su compra mediante un único pago.Tus clientes pueden pagar sus compras a través de diferentes medios de pago:
..:::
3
Descripción general de pagos de DineroMail
..:::
Carrito
de compras
5
Depósito Referenciado en Sucursales Bancarias de Bancomer, Banamex, Santander y ScotiaBank/Inverlat.
Pagos con tarjeta de crédito Visa, Mastercard
y American Express.
Fondos disponibles en tu cuenta de DineroMail
Pago con Transferencia Bancaria
Tiendas OXXO
Tiendas 7-Eleven
7
Se implementa en pocos minutos.
Es muy simple para tus compradores.
Integra los más importantes medios de pago.
Puedes incluir el logo de tu comercio.
Fáciles de implementar: sin necesidad de secuencias de comandos PHP y ASP.
No hay costos iniciales ni cargos mensuales.
Posibilidad de llevar registros detallados de ventas a través del sitio de DineroMail.
Mejora la experiencia del comprador: con botones personalizables
y pagos seguros.
..:::
Botón
de compras
DineroMail facilita la aceptación de pagos en tu sitio web
o
directamente en un e-mail si lo que quieres es vender ítems individuales. Los Botones de Compra se pueden implementar en cuestión de minutos. Tus clientes y cualquier otra persona podrán comprar y pagarte de manera muy simple.
Ventajas del Carrito de compras:
6
El Carrito de compras de DineroMail es una alternativa económica de empezar a aceptar pagos en tu sitio web. Se puede integrar totalmente a tu sitio web
siguiendo solo unos simples pasos.
8
Tus clientes pueden pagar sus compras a través de diferentes medios de pago:
7
Depósito Referenciado en Sucursales Bancarias de Bancomer, Banamex, Santander y ScotiaBank/Inverlat.Pagos con tarjeta de crédito Visa, Mastercard
y American Express.
Fondos disponibles en tu cuenta de DineroMail.
Pago con Transferencia Bancaria.
Tiendas OXXO
Tiendas 7-Eleven
La flexibilidad de los Botones de compra permite que tu sitio Web trabaje para ti. Puedes aceptar pagos de usuarios actuales de DineroMail, así
como de personas que hayan registrado nuestro servicio recientemente sin perder a tus clientes tras la compra (el proceso de pago permite que los compradores regresen a tu sitio Web)
Ventajas de los Botones de Compras
Se implementa en pocos minutos.
Es muy simple para tus compradores.
Integra los más importantes medios de pago.
Se pueden colocar en e-mails con formato HTML.
Fáciles de implementar: sin necesidad de secuencias de
Comandos PHP y ASP.
No hay costos iniciales ni cargos mensuales.
Posibilidad de llevar registros detallados de ventas a través del
sitio de DineroMail.
Mejorar la experiencia del comprador: con botones personalizables
y
pagos seguros.
9
..:::
4
Creación del Carrito de compras
Con el Carrito de compras de DineroMail, tus compradores pueden realizar un solo pago al comprar varios artículos.
Un Carrito de compras es muy fácil de configurar y utilizar. Sólo basta con crear un botón Agregar Carrito para cada producto o servicio a vender, y luego pegar el código HTML generado automáticamente para ese botón en tu sitio web
junto al artículo.
Completa los siguientes pasos para crear tus botones Carrito de compras.
Ingresa los detalles del producto o servicio que deseas vender
PASO 1:
..:::
Introducción
8
1. Ingresa en https://mexico.dineromail.com/index.asp
e inicia la sesión en tu cuenta DineroMail con tu e-mail y clave personal.
2. Haz click
en la pestaña DineroTools..
3. Haz click
en la opción Carrito de compras.
Descripción.Ingresa el nombre del producto o servicio a vender.
Código.Ingresa el código interno o número de producto/servicio. Este campo es opcional.
10
Selecciona la imagen del botón “Agregar al Carrito”.Tus clientes usarán la imagen que selecciones para agregar un producto al Carrito. Dispones de una serie de botones pre-determinados. Si lo deseas, puedes agregar tu propia imagen ingresando la URL de la misma (tiene que estar en Internet).
Selecciona la imagen del botón “Ver el Carrito”.Tus clientes usarán la imagen que selecciones para ver el contenido de tu
Carrito. Dispones de una serie de botones pre-determinados. Si lo deseas, puedes agregar tu propia imagen ingresando la URL de la misma (tiene que estar en Internet).
Agrega
el logo de tu
comercio
(opcional)Debes ingresar la URL de la imagen correspondiente.Tienes dos opciones: incluir una imagen que se encuentra en un servidor no seguro (http) o incluir una imagen que se encuentra en un servidor seguro (https). Recomendamos utilizar una imagen en servidor seguro, ya que toda
la información de DineroMail se encuentra encriptada bajo protocolo SSL y si el logo de tu compañía no lo está, el explorador de Internet mostrará
al
comprador un mensaje como el siguiente: “¿Deseas ver los elementos no seguros?”
Esto puede hacer sentir al comprador que la operación no es segura.Si deseas que DineroMail realice el hosteo
de tu logo, deberás enviarlo a [email protected]. El logo deberá
tener las siguientes características: formato gif
o jpg, 150x50 píxeles y no debe superar los 50 kb.
PASO 2:
PASO 3:
PASO 4:
9
Monto.
Ingresa el monto que desees cobrar por cada unidad de este
producto/servicio. Recuerda utilizar el punto (.) como separador
de decimales. Introduce sólo 2 cifras decimales. No existe monto mínimo en la creación del botón, pero tienes que tener en cuenta que no podrás completar una compra por menos de $50. Esto quiere decir que la suma total del valor de la compra del carrito debe ser mayor o igual a cincuenta pesos mexicanos.
11
Ingresa una dirección de éxito y otra de fracaso (opcional)Puedes ingresar la URL de la página a la que desees que sea enviado el comprador en el caso de que la compra sea exitosa. Por ejemplo, esta página podría ser una con el texto: “Muchas gracias por su compra”.También puedes ingresar la URL correspondiente al caso de fracaso o cancelación de la operación por parte del usuario.
PASO 5:
PASO 6:
PASO 7:
PASO 8:
10
Preferencias
(opcional)Si deseas que el comprador ingrese un mensaje, selecciona la casilla correspondiente.
Si deseas que el comprador ingrese la dirección de entrega del producto, selecciona la casilla correspondiente. Esta opción es ideal para sitios que desean recibir toda la información referida a la venta a través de DineroMail. RECUERDA QUE DINEROMAIL NO ES RESPONSABLE POR LA ENTREGA DEL PRODUCTO NI POR LA INFORMACIÓN QUE INGRESE AQUÍ
EL COMPRADOR.
Presiona CREAR BOTÓN DE COMPRAS.
Copia
el código
HTML.Copia todo el código HTML de los botones “Agregar al Carrito”
y “Ver Carrito”. Primero selecciona el texto (ten cuidado en seleccionar TODO el código; de lo contrario, tu botón no funcionará). Luego presiona Ctrl.+C para copiar, o el botón derecho de tu mouse
y “Copiar”.
Es importante destacar que no se puede implementar la solución DineroMail con frames.
12
Pega
el código
HTML.Pega el código HTML en tu página Web en el lugar en el que desees que se genere cada uno de los botones. Esto se puede hacer con un editor de texto o de páginas HTML.
La forma más simple es abriendo el programa BLOC DE NOTAS. Pega el código (Ctrl
+ V o con el botón derecho del mouse) y guarda el documento con la extensión “.html”
PASO 9:
Asegúrate que el código pegado en tu página Web sea exactamente igual al que se muestra en esta página. Cualquier
diferencia impedirá
que los botones de compra funcionen correctamente.
Obtén
los fondos.En cuanto un comprador efectúe un pago, recibirás una notificación por e-mail a la casilla de correo que identifica a tu Cuenta DineroMail.
Puedes optar por retirar tus fondos inmediatamente o mantenerlos
en tu Cuenta DineroMail. Dispones de 2 maneras para retirar los fondos:
Transferencia a tu cuenta bancaria. Tiempo de acreditación: 48 a72 horas hábiles.
Cheque a domicilio. Podrás cobrarlo en ventanilla en cualquiersucursal de Bancomer o bien depositarlo en una cuentabancaria propia. Tiempo: 1 a 5 días hábiles. Costo:Consultar Costos y Límites
PASO 10:
11
13
12
Para retirar fondos, completa los siguientes pasos:
1-
Ingresa a tu Cuenta DineroMail.2-
Haz click
en ‘Retirar Fondos’.3-
Selecciona la opción preferida para retirar tus fondos.
14
..:::
5
Creación del Botón de compras
1.
Ingresa en https://mexico.dineromail.com/index.asp
e inicia la sesión en tu cuenta DineroMail con tu e-mail y clave personal.
2. Haz click
en la pestaña DineroTools..3. Haz click
en la opción Botón de compras.
..:::
Introducción
Completa los siguientes pasos para crear tus botones de “Comprar/Donar”.
Ingresa los detalles del producto o servicio que deseas vender
PASO 1:
13
Un Botón de compras se puede utilizar para vender una sola unidad de un determinado ítem o servicio; o también permite a tus clientes comprar varias unidades de ese mismo ítem.
Crear un Botón de compras es muy simple. Es fácil de configurar y utilizar. Sólo basta con crear un botón de “Comprar/Donar”
para cada producto o servicio a vender, y luego pegar el código HTML generado automáticamente para ese botón en tu sitio web junto al artículo.
15
Descripción.Ingresa el nombre del producto o servicio a vender.
Código.Ingresa el código interno o número de producto/servicio. Este campo es opcional.
Monto.Ingresa el monto que desees cobrar por cada unidad de este producto/servicio. Recuerda utilizar el punto (.) como separador
de decimales. Introduce sólo 2 cifras decimales. No existe monto mínimo en la creación del botón, pero tienes que tener en cuenta que no podrás completar una compra por menos de $50. Esto quiere decir que la suma total del valor de la compra del carrito debe ser mayor o igual a cincuenta pesos.
Selecciona la imagen del botón “Comprar/Donar”.Tus clientes usarán la imagen que selecciones para comprar. Dispones de una serie de botones pre-determinados. Si lo deseas, puedes agregar tu propia imagen ingresando la URL de la misma (tiene que estar en Internet).
Agrega
el logo de tu
comercio
(opcional)Debes ingresar la URL de la imagen correspondiente.Tienes dos opciones: incluir una imagen que se encuentra en un servidor no seguro (http) o incluir una imagen que se encuentra en un servidor seguro (https).
PASO 2:
PASO 3:
14
16
Recomendamos utilizar una imagen en servidor seguro, ya que toda
la información de DineroMail se encuentra encriptada bajo protocolo SSL y si el logo de tu compañía no lo está, el explorador de Internet mostrará
al comprador un mensaje como el siguiente: “¿Deseas ver los elementos no seguros?”
Esto puede hacer sentir al comprador que la operación no es segura.
Si deseas que DineroMail realice el hosteo
de tu logo, por favor enviarlo a [email protected]. El logo deberá
tener las siguientes características: formato gif
o jpg, 150x50 píxeles y no debe superar los 50 kb.
Ingresa una dirección de éxito y otra de fracaso (opcional)Puedes ingresar la URL de la página a la que desees que sea enviado el comprador en el caso de que la compra sea exitosa. Por ejemplo, esta página podría ser una con el texto: “Muchas gracias por su compra”.
También puedes ingresar la URL correspondiente al caso de fracaso o cancelación de la operación por parte del usuario.
Preferencias (opcional)Si deseas que el comprador ingrese un mensaje, selecciona la casilla correspondiente.
Si deseas que el comprador ingrese la dirección de entrega del producto, selecciona la casilla correspondiente. Esta opción es ideal para sitios que desean recibir toda la información referida a la venta a través de DineroMail. RECUERDA QUE DINEROMAIL NO ES RESPONSABLE POR LA ENTREGA DEL PRODUCTO NI POR LA INFORMACIÓN QUE INGRESE AQUÍ
EL COMPRADOR.
PASO 5:
PASO 4:
15
17
Obtén
los fondos.En cuanto un comprador efectúe un pago, recibirás una notificación por e-mail a la casilla de correo que identifica a tu Cuenta DineroMail.
Presiona CREAR BOTÓN DE COMPRAS.
Copia el código HTML. Copia todo el código HTML de los botones de “Comprar/Donar”. Primero selecciona el texto (ten cuidado en seleccionar TODO el código; de lo contrario, tu botón no funcionará). Luego presiona Ctrl.+C para copiar, o el botón derecho de tu mouse
y “Copiar”.
Es importante destacar que no se puede implementar la solución DineroMail con frames.
Pega el código HTML.Pega el código HTML en tu página Web en el lugar en el que desees que se genere cada uno de los botones. Esto se puede hacer con un editor de texto o de páginas HTML.La forma más simple es abriendo el programa BLOC DE NOTAS. Pega el código (Ctrl
+ V o con el botón derecho del mouse) y guarda el documento con la extensión “.html”
PASO 8:
PASO 7:
PASO 6:
Asegúrate que el código pegado en tu página Web sea exactamente igual al que se muestra en esta página. Cualquier
diferencia impedirá
que los botones de compra funcionen correctamente.
16
PASO 9:
18
Puedes optar por retirar tus fondos inmediatamente o mantenerlos
en tu Cuenta DineroMail. Dispones de 2 formas de retiros de fondos:
Transferencia a tu cuenta bancaria.
Tiempo de acreditación: 48 a 72 horas hábiles.
Cheque a domicilio.
Podrás cobrarlo en ventanilla en cualquier sucursal de Bancomer o bien depositarlo en una cuenta bancaria propia. Tiempo: 1 a 5 días hábiles. Costo: Consultar “Costos y Límites”.
Para retirar fondos, completa los siguientes pasos:
1-
Ingresa a tu Cuenta DineroMail.2-
Haz click
en Retirar Fondos.3-
Selecciona la opción preferida para retirar tus fondos.
17
19
..:::
6
Modificación
manual del Código
CARRITO DE COMPRAS
Botón “Agregar al Carrito / Comprar”
El siguiente es un ejemplo del código HTML:
<a href="#" onclick="window.open('https://mexico.dineromail.com/carrito/cart.asp? NombreItem=Televisor+14+pulgadas&TipoMoneda=1&PrecioItem=3000.00&NroItem= IXD443&image_url=http://www.logo.com/logo.jpg&DireccionExito=http%3A//www.exito .com&DireccionFracaso=http%3A//www.fracaso.com&DireccionEnvio=1&Mensaje=1& MediosPago=7,6,18Comercio=7239','Carrito','width=600,height=275,toolbar=no,locatio n=no,status=no,menubar=no,resizable=yes,scrollbars=yes,directories=no');"><img src="http://www.agregar.com/agregar.gif" border="0"></a>
Todo lo que se encuentra en gris
no puede ser modificado de ninguna manera.
Lo que se encuentra en verde, puede o no estar, dependiendo de si se desea agregar el parámetro. Si está, debe aparecer tal cual se muestra en el ejemplo.
Lo que se encuentra en azul puede ser modificado de la siguiente manera:
18
20
CODE DESCRIPTION
NombreItem=Televisor+14+pulgadas Aquí
debes poner el nombre o descripción del producto o servicio. Atención: El signo + reemplaza el espacio. Es decir, para
escribir “Televisor 14 pulgadas”, ingresa
aquí
“Televisor+14+pulgadas”.
TipoMoneda=1 Ingresa “1”
para pesos, “2”
para dólar.
PrecioItem=3000.00 Es el precio del producto o servicio en forma individual. Atención: Utiliza el punto (.) para separar decimales. La coma (,) será
rechazada. No pongas más de 2
decimales. Verifica el monto máximo actualmente disponible en DineroMail.
NroItem=- Opcional. Puedes reemplazar la parte azul por un código interno del producto dentro del comercio. Sirve para aquellos comercios o vendedores que clasifican
con código sus productos. Atención: si no deseas poner código, ingresa un signo “-”.
&image_url=https://www.logo.com/logo.j
pgSi deseas agregar un logo propio de tu comercio, debes ingresar todo este texto, reemplazando la parte azul por la URL de la imagen de tu logo. Atención: la extensión debe ser jpg
o gif. Se
recomienda el uso de una imagen en servidor seguro, que comience por https, para evitar que el comprador reciba una notificación de “elementos no seguros”.
&DireccionExito=http%3ª//www.success.
comSi deseas agregar una dirección a la que será
enviado el comprador en las compras exitosas, debes ingresar todo este texto, reemplazando la parte azul por la URL de la página indicada. Atención: En este parámetro, el signo (:) luego de http debe ser reemplazado por %3A.
19
21
&DireccionFracaso=http%3ª//www.fail
ure.comSi deseas agregar una dirección a la que será
enviado el comprador en las compras canceladas, debes ingresar
todo este texto, reemplazando la parte azul por el URL de la página indicada. Atención: En este parámetro, el signo (:) luego de http debe ser reemplazado por %3A.
DireccionEnvio=1 Ingresa “1”
si deseas que el comprador pueda agregar la dirección en la que desea recibir el producto.Ingresa “0”
si no deseas que el comprador pueda agregar la dirección.
Mensaje=1 Ingresa “1”
si deseas que el comprador pueda enviar un mensaje.Ingresa “0”
si no deseas que el comprador pueda enviar un mensaje.
MediosPago=7, 6, 18 No ingreses ningún valor para aceptar todos los medios de pago. Ingresa “7”
para Fondos en cuenta DineroMail, “2”
para Depósito Referenciado, “13”
pagos en Oxxo, “14”
pagos através
de 7-Eleven. Para pagos con tarjeta de crédito en 1, 3, 6 y 12 pagos, ingresa “4”, “5”, “6”
y “17”
respectivamente. Para Transferencia Bancaria “18”, pago en 1, 3, 6 y 12 pagos con tarjeta American Express ingresa “19”, “20”, “21”
y “22”
respectivamente. O combina los
métodos que desees mediante comas (Ej: 4,5,7,20)
Comercio=7239 El número de la cuenta DineroMail del comercio o
vendedor (sin ceros y sin el dígito final, que es un dígito verificador). Atención: Debe coincidir con el e-mail del vendedor.
Carrito Es el título (arriba, izquierda, parte azul del explorador) que tendrá
la página del carrito de compras.
<img
src="http://www.agregar.com/agregar.
gif" border="0">
Es la imagen del botón. Puedes cambiar la imagen
utilizando la URL de los botones predeterminados.
Consulta el Anexo 1 para ver las opciones.
Alternativamente puedes ingresar el URL de una imagen propia. Si deseas convertir el botón en un texto que cumpla la misma función, reemplaza todo (incluída
la parte verde) por el texto que desees.
20
22
Botón
“Ver
el Carrito”
El siguiente es un ejemplo del código HTML:
<a href="#" onclick="window.open('http://mexico.dineromail.com/carrito/cart.asp?Store=7239','Cart'
,'width=600,height=275,toolbar=no,location=no,status=no,menubar=no,resizable=yes,s
crollbars=no,directories=no');"><img
src="https://mexico.dineromail.com/imagenes/vender/verCarrito/ver-carrito.gif" border="0"></a>
Todo lo que se encuentra en gris
no puede ser modificado de ninguna manera.
Lo que se encuentra en verde, puede o no estar, dependiendo de si se desea agregar el parámetro. Si está, debe aparecer tal cual se muestra en el ejemplo.
Lo que se encuentra en azul
puede ser modificado de la siguiente manera:
CODE DESCRIPTION
Comercio=7239 El número de la Cuenta DineroMail del comercio o vendedor (sin ceros y sin el dígito final, que es un dígito verificador). Atención: Debe coincidir con el email del vendedor.
Cart Es el título (arriba, izquierda, parte azul del explorador) que tendrá
la página del carrito de compras.
21
23
<img src="https://mexico.dineromail.com/image nes/vender/verCarrito/ver-carrito.gif" border="0">
Es la imagen del botón. Puedes cambiar la imagen utilizando la URL de los
botones predeterminados. Consulta el Anexo 1 para ver las opciones. Alternativamente puedes ingresar la URL de una imagen propia. Si deseas convertir el botón en un texto que cumpla la misma función, reemplaza todo (incluida la parte verde) por el texto que desees.
La modificación del código de manera diferente a la detallada en este documento constituye una violación de los Términos y Condiciones de Uso. Está
expresamente prohibida la utilización de URLs
propios que no pertenezcan a imágenes o páginas de éxito/fracaso. Asimismo, se prohíbe la modificación de código ajeno o el intento de engañar al comprador con una identidad falsa. En
estos y otros casos, DineroMail se reserva el derecho de bloquear y/o cancelar la cuenta e iniciar las acciones legales pertinentes, como se detalla en los Términos y
Condiciones de Uso de Digicuenta
SA de CV
22
24
BOTON DE COMPRAS
Botón “Comprar/Donar”
El siguiente es un ejemplo del código HTML
<form action='https://mexico.dineromail.com/Shop/Shop_Ingreso.asp' method='post'> <input type='hidden' name='NombreItem' value='Televisor'> <input type='hidden' name='TipoMoneda' value='1'> <input type='hidden' name='PrecioItem' value=‘3000.00'> <input type='hidden' name='E_Comercio' value='94'> <input type='hidden' name='NroItem' value='IIRUUT'> <input type='hidden' name='image_url' value='https://www.comercio.com/imagen.gif'> <input type='hidden' name='DireccionExito' value='http://www.exito.com'> <input type='hidden' name='DireccionFracaso' value='http://www.fracaso.com'> <input type='hidden' name='DireccionEnvio' value='1'> <input type='hidden' name='Mensaje' value='1'><input type='hidden' name=‘MediosPago' value=‘7,6,18'> <input type='image' src='https://mexico.dineromail.com/imagenes/vender/boton/comprar- gris.gif' border='0' name='submit' alt='Pagar con Dineromail'> </form>
Todo lo que se encuentra en gris
no puede ser modificado de ninguna manera.
Lo que se encuentra en azul
puede ser modificado de la siguiente manera:
CODE DESCRIPTION
name='NombreItem' value='Televisor' Aquí debes poner el nombre o descripción del producto o servicio. Atención: El signo “+” reemplaza al espacio. Es decir, para escribir “Televisor 14 pulgadas”, ingresa aquí “Televisor+14+pulgadas”.
name='TipoMoneda' value='1' Ingresa “1” para pesos, “2” para dólar. Si este parámetro no se incluye, se supone que la operación es en pesos.
23
25
name='PrecioItem' value=‘3000.00’ Es el precio del producto o servicio en forma individual. Atención: Utiliza el punto (.) para separar decimales. La coma (,) será
rechazada. No pongas más de 2
decimales. Verifica el monto máximo
actualmente disponible en DineroMail
name='E_Comercio' value='94' El número de la DineroMail del comercio o vendedor (sin ceros y sin el dígito final, que es un dígito verificador). Atención: Debes coincidir con el e-mail del
vendedor.
name='NroItem' value='IIRUUT'
name='image_url' value='https://www.comercio.com/imagen .gif‘
name='DireccionExito' value='http://www.exito.com'
name='DireccionFracaso'
value='http://www.fracaso.com'
Si deseas agregar un logo propio de tu comercio, debes ingresar todo este texto, reemplazando la parte azul por la URL de la imagen de tu logo. Atención: la extensión debe ser jpg
o gif. Se
recomienda el uso de una imagen en
servidor seguro, que comience por https, para evitar que el comprador reciba una notificación de “elementos no seguros”, ya que todo el resto de la página se
encontrará
encriptada.
Opcional. Puedes reemplazar la parte
azul por un código interno del producto dentro del comercio. Sirve para aquellos comercios o vendedores que clasifican con código sus productos. Atención: si no deseas poner código, ingresa un
signo “-”
.
Si deseas agregar una dirección a la que será
enviado el comprador en las compras canceladas, debes ingresar
todo este texto, reemplazando la parte azul por la URL de la página indicada.
Si deseas agregar una dirección a la que será
enviado el comprador en las compras exitosas, debes ingresar todo este texto, reemplazando la parte azul por la URL de la página indicada.
24
26
name='DireccionEnvio' value='1'
name='Mensaje' value='1'
name='MediosPago' value=‘7, 6, 18' No ingreses ningún valor para aceptar
todos los medios de pago. Ingresa “7”
para Fondos en cuenta
DineroMail, “2”
para Depósito Referenciado, “13”
pagos en Oxxo, “14”
pagos através
de 7-Eleven. Para pagos con tarjeta de crédito en 1, 3, 6 y 12
pagos, ingresa “4”, “5”, “6”
y “17”
respectivamente. Para Transferencia
Bancaria “18”, pago en 1, 3, 6 y 12 pagos con tarjeta American Express ingresa
“19”, “20”, “21”
y “22”
respectivamente. O combina los métodos que desees mediante comas (Ej: 4,5,7,20)
src='https://mexico.dineromail.com /imagenes/vender/boton/comprar-gris.gif‘
alt='Pagar con Dineromail' El texto explicativo que aparece en amarillo, cuando el mouse
se detiene
sobre el botón. Puedes cambiarlo si lo deseas.
Ingresa “1”
si deseas que el comprador pueda agregar la dirección en la que
desea recibir el producto.Ingresa “0”
si no deseas que el comprador pueda agregar la dirección.
Ingresa “1”
si deseas que el comprador pueda enviar un mensaje.Ingresa “0”
si no deseas que el comprador pueda enviar un mensaje.
Es la imagen del botón. Puedes cambiar la imagen utilizando la URL de los botones predeterminados. Consulta el Anexo 1 para ver las opciones.
Alternativamente puedes ingresar la URL de una imagen propia.
25
27
..:::
7
Funcionamiento del Proceso de Compras
El siguiente es un ejemplo de la secuencia completa del proceso de compra de un usuario que utiliza el Carrito de compras o el Botón de compras de DineroMail. Como todos los ejemplos de paginas web
en esta guía, el mismo se basa en la integración modelo de las herramientas de venta en DineroMail.
De acuerdo a las preferencias especificas elegidas para cada caso particular, la experiencia de compra puede variar levemente con relación a la que aquí
se muestra.A continuación se describen los pasos que seguirá
un comprador que elige pagar con DineroMail en tu sitio web:
El comprador nuevo ingresa en el comercio. Junto al producto que
desea comprar, encuentra un botón “Agregar al Carrito”. Luego de elegir varios productos, puede presionar en el botón “Ver Carrito”.
Los botones mencionados pueden seleccionarse dentro de un grupo de opciones.
PASO 1:
26
28
(el “Botón de compras”
saltea este paso)
Luego de agregar todos los productos deseados, el comprador presiona “Pagar”
PASO 2:
PASO 3:
El comprador ve un detalle de todos los productos que va a adquirir. Si es un usuario ya registrado en DineroMail, se identifica con su e-
mail y clave personal.
27
29
PASO 4:
Si es un usuario nuevo, ingresa algunos datos básicos para registrarse. La próxima vez que compre será
identificado automáticamente.
Depósito Referenciado en Sucursales Bancarias de Bancomer, Banamex, Santander y ScotiaBank/Inverlat.
Tarjetas de Crédito Visa, Mastercard
y American Express.
Fondos disponibles en la Cuenta DineroMail.
Pagos con Transferencia Bancaria.
Tiendas OXXO.
Tiendas 7-Eleven.
El comprador debe elegir el método de pago que desea:
28
30
PASO 5:
Si elige depósito referenciado en sucursales bancarias de Bancomer, Banamex, Santander, y ScotiaBank/Inverlat
debe imprimir el cupón y acercarse a alguna de las sucursales para completar el pago.
29
31
En caso de pagar con Tarjeta de Crédito, el usuario deberá
ingresar los datos de su tarjeta Visa, MasterCard o American Express para
concretar la transacción.
Si elige pagar con fondos disponibles en su Cuenta DineroMail, el débito es inmediato.
El comprador confirma la compra. Si el vendedor lo solicitó
al crear el Carrito de compras, el comprador puede ingresar un mensaje y la dirección de entrega del producto.
PASO 6:
30
32
La operación se procesa y el comprador es enviado a la página configurada por el comercio (opcional). Alternativamente, se le muestra un mensaje de éxito en DineroMail.
PASO 7:
31
33
El comprador recibe por e-mail una notificación de la compra.
PASO 8:
32
34
..:::
8
Notificación al Vendedor
A continuación se describe la secuencia de pasos a través de los cuales quien vende utilizando DineroMail es notificado de la
operación.
El vendedor es notificado por e-mail cuando se recibe el pago de una nueva venta. Este e-mail no posee los detalles de la venta por cuestiones de seguridad. .
PASO 1:
PASO 2:El vendedor ingresa en su Cuenta DineroMail y puede ver la operación en su historial. Los fondos ya se encuentran acreditados en su Cuenta DineroMail.
33
35
Nota: Las operaciones que requieren un pago posterior del comprador, como las de los depósitos referenciados o con transferencias bancarias, son
procesadas en dos etapas. El vendedor es notificado únicamente cuando se acredita el pago, para evitar confusiones.
34
Ingresando en el “Estado”
se ve un detalle de toda la operación. Se incluye el mensaje y la dirección de envío.
PASO 3:
36
..:::
9
Como utilizar
un Carrito
de Compras
externo
Es posible que desees integrar el procesamiento de pagos de DineroMail con tu propio Carrito de compras, en lugar de hacerlo
con el Carrito de compras de DineroMail, y completar la operación a través de nuestro sistema.
Las instrucciones y variables de esta sección permiten que tus compradores puedan pagar con DineroMail una vez hayan agregado todos los artículos a tu Carrito de compras y estén preparados para realizar el pago y envío.
El comercio electrónico puede tener el carrito o aplicación de compras que desee, lo único importante es que al momento de pagar, los datos sean estandarizados de acuerdo al formato y dirección establecidos por DineroMail en el código HTML estándar.Por ejemplo, suponiendo que un comercio desea utilizar su propio
carrito de compras. Un comprador elige productos y la aplicación del comercio los va registrando. Supongamos que elige:
Cafetera por $1.600 y Tazas por $120.
La compra, en pesos, es identificada por el comercio con el pedido nro. CVD22
El programador del comercio electrónico debe hacer que el botón “Pagar”
o “Checkout”
de su carrito de compras haga lo siguiente:
1-
Tome toda la información cargada en el carrito .
2-
Complete los campos en azul con esa información.
35
37
<form action='https://mexico.dineromail.com/Shop/Shop_Ingreso.asp' method='post'> <input type='hidden' name='NombreItem' value='Cafetera y Vasos'> <input type='hidden' name='TipoMoneda' value='1'> <input type='hidden' name='PrecioItem' value=‘1720.00'> <input type='hidden' name='E_Comercio' value='94'> <input type='hidden' name='NroItem' value='CVD22'> <input type='hidden' name='image_url' value='https://www.comercio.com/imagen.gif'> <input type='hidden' name='DireccionExito' value='http://www.exito.com'> <input type='hidden' name='DireccionFracaso' value='http://www.fracaso.com'> <input type='hidden' name='DireccionEnvio' value='1'> <input type='hidden' name='Mensaje' value='1'><input type='hidden' name='MediosPago' value=‘7,6,18'> <input type='image' src='https://mexico.dineromail.com/imagenes/vender/boton/comprar- gris.gif' border='0' name='submit' alt='Pagar con Dineromail'> </form>
Lo que se encuentra en negro
depende del comercio. Por lo general, estos parámetros serán siempre los mismos para un comercio.
Lo que se encuentra en azul es lo que será
modificado cada vez que una nueva compra se realice. En el ejemplo se juntaron las descripciones de los productos en un solo parámetro, “NombreItem”.
Lo mismo se hizo con el precio, que es el valor total de la compra y se introduce en el parámetro “PrecioItem”, con el Número de Pedido y la moneda de la compra.
Lo que se encuentra en gris
no puede ser modificado. Es código estándar.
36
38
..:::
10
Operaciones
en Dólares
Las operaciones en dólares permiten dar mayor estabilidad al precio del producto o servicio, sin necesidad de estar modificándolo de manera constante.
La acreditación de fondos al vendedor será
por el equivalente en pesos, al tipo de cambio vigente en el momento de la compra. No se acreditarán dólares en la Cuenta DineroMail del vendedor.
De esta manera, si una operación es en dólares, se mostrará
al comprador el equivalente en pesos al momento de realizar la operación.
37
39
..:::
11
Cómo vender con montos variables
Si tu venta depende de algo variable, como por ejemplo la cantidad de metros de tela o el importe aleatorio de una donación, puedes hacer que tu página web
lo determine en el momento de la compra y lo envíe a DineroMail.
El mecanismo es idéntico al explicado en la sección anterior. Lo importante es que la información sea estandarizada de acuerdo al formato y dirección establecidos por DineroMail en el código HTML estándar.
Por ejemplo, puedes poner
La persona que paga, ingresa el monto que desea (supongamos $100), y al oprimir el botón “Donar”, se envían los parámetros a DineroMail de la siguiente manera
<form action='https://mexico.dineromail.com/Shop/Shop_Ingreso.asp' method='post'> <input type='hidden' name='NombreItem' value=Donación'> <input type='hidden' name='TipoMoneda' value='1'> <input type='hidden' name='PrecioItem' value=‘100.00'> <input type='hidden' name='E_Comercio' value='94'> <input type='hidden' name='NroItem' value=''> <input type='hidden' name='image_url' value='https://www.comercio.com/imagen.gif'> <input type='hidden' name='DireccionExito' value='http://www.exito.com'> <input type='hidden' name='DireccionFracaso' value='http://www.fracaso.com'> <input type='hidden' name='DireccionEnvio' value='1'> <input type='hidden' name='Mensaje' value='1'> <input type='image' src='https://mexico.dineromail.com/imagenes/vender/boton/comprar-gris.gif' border='0' name='submit' alt=‘Donar con Dineromail'> </form>
38
40
Lo que se encuentra en gris
no puede ser modificado, es código estándar y obligatorio. Lo que se encuentra en negro
depende del comercio. Por lo general, estos parámetros serán siempre los mismos para un comercio.
Lo que se encuentra en azul, en este caso sólo el monto de la operación, es lo que el usuario ingresó
en el casillero correspondiente.
39
41
..:::
12
Costos
y Límites
Para mayor información, consulta nuestra sección Costos y Límites, en nuestro sitio web:
https://mexico.dineromail.com/CostosLimites.asp
40
42
..:::
13
Contacto
Ante cualquier duda o consulta, por favor no dudes en contactarte con nosotros:
Información General:Razón Social: Digicuenta
SA de CV
Dirección Legal: Av. Cuauhtemoc 1486-401CColonia Santa Cruz AtoyacCP 03310Mexico
DF
Contacto vía E-mail:Para consultas generales por favor escríbenos a [email protected]
Para consultas comerciales por favor escríbenos [email protected]
Contacto Telefónico
Para consultas que requieren asistencia telefónica, por favor comunícate a través de nuestro número de Atención al Cliente.
Nuestro horario de atención es de Lunes a Viernes de 10 a 22 horas.
41
(55) 5351 3378 – 18005141347
43
..:::
14
Anexo 1: Instrucciones para la consulta automática de pagos
Proceso:
Para automatizar el proceso de actualización de tus pagos, puedes utilizar la siguiente interfaz, la cual te permitirá
programar las consultas de los pagos que has recibido durante un rango de fechas que desees conocer. De esta forma podrás actualizar tus registros de forma automática.
Requisitos en las Herramientas utilizadas:
Botón de pago. (asociado al nodo <Pays>, ver mas adelante la estructura XML)
Se requieren los siguientes cambios:
-
Detalle de los datos que DineroMail espera recibir del comercio:
Name Description Type of data
Trx
id ID de transacción Alfanumérico
(20)
-
Código para agregar a la herramienta de venta DineroMail<input type='hidden' name='trx_id' value=''>
42
44
-
Código para agregar a la herramienta de venta DineroMail:
<input
type='hidden' name='trx_id' value=''>
Tarjetas de cobranza y Códigos de barras. (asociado al nodo <Collections>, ver mas adelante la estructura XML)
-
No requiere modificaciones adicionales
Boletas de pago.. (asociado al nodo <Tickets>, ver mas adelante la estructura XML)
-
No requiere modificaciones adicionales
Order:
Para obtener un detalle de los pagos, se debe consultar la siguiente URL:
https://mexico.dineromail.com/Vender/ConsultaPago.asp
La página ConsultaPago.asp
espera recibir los siguientes parámetros obligatorios por String
tanto por método POST como GET:
43
45
Name Type of data Description.
E-mail Alphanumeric (255)
E-mail de registro en tu cuenta DineroMail.
Acount Numerical (8) Número de cuenta DineroMail (la misma lapuedes visualizar luego de loguearte
en tu cuenta DineroMail en la página principal. Enviartodos dígitos, sin la barra invertida).
Pin Number
Alphanumeric (10)
Clave de acceso para consultas. Podrás encontrarlo una vez que te loguees
como usuarioen la sección “Mi Cuenta”. (*)
StartDate Alphanumeric (8)
Fecha de inicio de consulta (El formato esaaaammdd
Para meses y días de un carácter de longitud, se debe rellenar con cero a izquierda).(**)
EndDate Alphanumeric (8)
Fecha de fin de consulta (El formato esaaaammdd
Para meses y días de un carácter delongitud, se debe rellenar con cero a izquierda).(**)
XML Numerical (1) El comercio debe enviar este parámetro con elvalor “1”.
(*) El valor PIN se visualiza siempre y cuando el usuario tenga activada las herramientas de venta.
(**) El período máximo a consultar es de 1 mes, es decir, la diferencia entre StartDate
y EndDate
no debe superar los 30 días.
44
46
La página como respuesta envía un XML. Su estructura es la siguiente:
<?xml version="1.0" encoding="ISO-8859-1" ?>- <Report>
<Email></Email> -> e-mail recibido<Acount></Acount> -> cuenta recibida<Pin></Pin> -> clave recibida<StartDate></StartDate> -> fecha inicial recibida<EndDate></EndDate> -> fecha final recibida<XML></XML> -> flag<State></State> -> estado recibido (*1)
- <Pays> -> nodos de botones de pago- <Pay trx_id=""> -> nodo pago (*2)
<Trx_Date></Trx_Date> -> fecha de pago<Trx_Email></Trx_Email> -> email de pago<Trx_Payment></Trx_Payment> -> importe total pagado<Trx_ShipAddress></Trx_ShipAddress> -> dirección de entrega<Trx_Comment></Trx_Comment> -> mensaje del comprador- <Items> -> nodo de items- <Item Item_Code=""> -> nodo item (*3)
<Item_Quantity></Item_Quantity> -> cantidad<Item_Description></Item_Description> -> descripcion<Item_Payment></Item_Payment> -> importe
</Item></Items>
</Pay></Pays>
- <Collections> -> nodos de Tarjetas de cobranza y códigos de barra- <Collection Trx_id=""> -> nodo de pago (*4)
<Trx_Date> </Trx_Date> -> fecha de pago<Trx_Payment> </Trx_Payment> -> importe pagado
</Collection></Collections>
- <Tickets> -> nodo de boletas de pago- <Ticket> -> nodo de pago (*5)
<Trx_Date> </Trx_Date> -> fecha de pago<Trx_Name> </Trx_Name> -> nombre del pagador<Trx_Payment> </Trx_Payment> -> importe pagado</Ticket>
</Tickets></Report>
45
47
(*1) Estado: el estado recibido en <State> indica el estado de la consulta
0.
los parámetros no respetan el formato requerido.1.
la consulta se realizó
correctamente.2.
los valores son incorrectos para realizar la consulta.
(*2) Nodo Pago: un nodo por cada venta. El atributo trx_id
hace referencia al mismo que previamente envío el comercio en el parámetro trx_id
por medio del botón o carrito de venta, al inicio del circuito de compra.
(*3) Nodo Item: un nodo por cada ítem dentro de una venta. El atributo Item_Code
hace referencia al mismo que previamente envió
el comercio en el parámetro NroItem
por medio del botón o carrito de venta, al inicio del circuito de compra.
(*4) Nodo Collection: un nodo por cada cobranza recibida. El
atributo trx_id
hace referencia al dato que representa el código de barras o a la Tarjeta de cobranza.
(*5) Nodo Tickets: un nodo por cada boleta de pago recibida. En el item
Trx_Name
se encuentra el nombre y apellido previamente cargado por el comercio, que hace referencia a su cliente
46
48
Ejemplo:
• Pedido: (disponible online)
https://mexico.dineromail.com/vender/ConsultaPago.asp?Email=ventas@diner omail.com&Acount=105006&Pin=0&StartDate=20040523&EndDate=20040524 &XML=1
• Respuesta:<?xml
version="1.0" encoding="ISO-8859-1" ?>
-
<Report>
<Email>[email protected]</Email>
<Acount>105006</Acount>
<Pin>0</Pin>
<StartDate>20040523</StartDate>
<EndDate>20040524</EndDate>
<XML>1</XML>
<State>1</State>
- <Pays>
-
<Pay trx_id="7001291">
<Trx_Date>20040523</Trx_Date>
<Trx_Email>[email protected]</Trx_Email>
<Trx_Payment>200.56</Trx_Payment>
<Trx_ShipAddress>Av. Boedo
1324 1°A</Trx_ShipAddress>
<Trx_Comment>De 11 a 23</Trx_Comment>
- <Items>
47
49
-
<Item Item_Code="321">
<Item_Quantity>2</Item_Quantity>
<Item_Description>Shoes</Item_Description>
<Item_Payment>72.50</Item_Payment>
</Item>
+ <Item Item_Code="188">
</Items>
</Pay>+<Pay trx_id="7001292">
</Pays>-
<Collections>-
<Collection Trx_id="00560223"><Trx_Date>20040523</Trx_Date>
<Trx_Payment>300.67</Trx_Payment> </Collection>
+ <Collection Trx_id="00560345"></Collections>
-
<Tickets>-
<Ticket><Trx_Date>20040523</Trx_Date> <Trx_Name>Jose Perez</Trx_Name> <Trx_Payment>100.05</Trx_Payment>
</Ticket>+ <Ticket>
<Trx_Date>20040524</Trx_Date> <Trx_Name>Omar Gomez</Trx_Name> <Trx_Payment>5000.00</Trx_Payment>
</Ticket></Tickets>
</Report>
48
50
..:::
15
Anexo 2: Especificación técnica IPN
49
Para aquellos casos en que los usuarios deseen recibir notificaciones de sus operaciones de manera automática, DineroMail
ha desarrollado IPN.
1. Introducción
2. Descripción general de IPN
IPN v2 es una herramienta que permite a los usuarios vendedores de DineroMail
recibir notificaciones de los últimos movimientos de su cuenta y de ese modo informarse acerca del estado de cada uno de
ellos. IPN permite asimismo que los usuarios vendedores puedan realizar consultas sobre los detalles de dichos movimientos.
Los movimientos que se notificarán son los siguientes:
-
Operación de Venta
-
Acreditación de dinero
-
Cancelación de una operación de venta
3. Requisitos previos a la implementación del sistema.
Para poder implementar el IPN v2, es necesario que tu como usuario vendedor te identifiques mediante un código alfanumérico de hasta veinte (20) caracteres para verificar cada operación de intento de pago.
Para ello, deberás ingresar a la sección “Datos de usuario”
en tu cuenta de DineroMail, y dirigirte a ‘Configurar IPN’. A continuación, ingresa la URL y una contraseña que sólo tú
conozcas. De esta manera, sólo tú
como usuario vendedor tendrás acceso al IPN
exclusivo que identifica a tu comercio.
51
50
4. Modificaciones al formulario de CARRITO/BOTON
Debe incluirse un parámetro (INPUT) del tipo oculto (HIDDEN) que contenga el identificador del intento de pago. El mismo será
llamado “TRX_ID”. Se adjunta un ejemplo de un botón a continuación:
<form action='https://mexico.dineromail.com/Shop/Shop_Ingreso.asp' method='post'><input type='hidden' name='NombreItem' value='Windows XP SP2'><input type='hidden' name='TipoMoneda' value='1'><input type='hidden' name='PrecioItem' value='650.00'><input type='hidden' name='E_Comercio' value='31009'><input type='hidden' name='NroItem' value='GC09821'><input type='hidden' name='image_url' value='http://'><input type='hidden' name='DireccionExito' value='http://'><input type='hidden' name='DireccionFracaso' value='http://'><input type='hidden' name='DireccionEnvio' value='1'><input type='hidden' name='Mensaje' value='1'><input type='hidden' name='MediosPago' value='4,5,6,17,19,20,21,22,13,14,7,2,18'><input type='hidden' name='TRX_ID' value='13461'><input type='image' src='https://mexico.dineromail.com/imagenes/post-login/boton- comprar-01.gif' border='0' name='submit' alt='Pagar con DineroMail'></form>
52
51
5. Especificación de la interfaz de notificación.
En caso de crearse nuevas operaciones o de modificarse el estado
de estas, DineroMail
enviará
por “POST”
un parámetro “NOTIFICACION”
que contiene un XML el cual contendrá
los identificadores de las operaciones que han sido modificadas. La estructura del XML se detalla a continuación:
<NOTIFICACION><TIPONOTIFICACION>1</TIPONOTIFICACION><OPERACIONES>
<OPERACION><TIPO>1</TIPO><ID>31548</ID>
</OPERACION><OPERACION>
<TIPO>1</TIPO><ID>XA5547</ID>
</OPERACION></OPERACIONES>
</NOTIFICACION>
53
52
Descripción de los elementos del documento XML de Notificación
Elemento Descripción
NOTIFICACION Elemento base del documento XML, dentro de este seencuentran todos los elementos de la notificación.
TIPONOTIFICACION Indica el tipo de notificación que se esta enviando.
OPERACIONES Contiene la colección de operaciones.
OPERACIÓN Contiene el detalle de cada operación, pueden ser una omás operaciones.
TIPO Tipo de notificación que se envía.
ID Este valor es el que proporciona el usuario comoidentificador único de la operación de pago.
Valores posibles del elemento TipoNotificacion
1 Notificación de cambio de estado de operaciones
Valores posibles del elemento Tipo
1 Notificación de cambio de estado de una venta de Carrito o Botón de Compras.
54
53
6. Especificación de la interfaz de consulta
Se enviará
a una URL de DineroMail
por “POST”
un parámetro llamado “DATA”
que contenga un XML de consulta, el cual contendrá
el número de cuenta del usuario y el detalle de las operaciones a consultar. Entre los datos que se deben enviar se encuentra el número de cuenta del usuario y la clave (a revisar en nombre del campo)
ingresada en el sitio de DineroMail
para la verificación del usuario. La estructura del XML se detalla a continuación:
<REPORTE><NROCTA>31009</NROCTA><DETALLE>
<CONSULTA><CLAVE>MIPASSWORD001</CLAVE>
<TIPO>1</TIPO><OPERACIONES>
<ID>31548</ID><ID>XA5547</ID>
</OPERACIONES></CONSULTA>
<DETALLE></REPORTE>
URL de consulta:
https://mexico.dineromail.com/Vender/Consulta_IPN.asp
55
54
Descripción de los elementos del documento XML de Consulta.
Elemento Descripción
REPORTE Elemento base del documento XML, dentro de este seencuentran todos los elementos de la consulta.
NROCTA Número cuenta del usuario de DineroMail
DETALLE Elemento que contiene todos los elementos correspondientes ala consulta.
CONSULTA Contiene los elementos correspondientes a la consulta en si.
CLAVE Clave ingresada por el usuario en “Mi Cuenta” para autenticarLa identificación del mismo.
TIPO Tipo de consulta solicitada. Los valores posibles se detallan enLa siguiente tabla.
OPERACIONES Elemento que agrupa todas las operaciones que se solicitan enla consulta.
ID Este valor es el que proporciona el usuario como identificadorúnico de la operación de pago. Es el valor ingresado en el punto 2.
Valores posibles del elemento Tipo
1 Consulta de estado de ventas de Carrito o Botón de Compras.
56
55
7. Especificación de la interfaz de reporte de operaciones
La consulta realizada en el punto 4 por el negocio será
respondida mediante un XML de consulta, el cual contendrá
los detalles de las operaciones consultadas. La estructura del XML se detalla a continuación:
<REPORTE><ESTADOREPORTE></ ESTADOREPORTE ><DETALLE><OPERACIONES>
<OPERACIÓN><ID></ID><FECHA></FECHA><ESTADO></ESTADO><COMPRADOR>
<EMAIL></EMAIL><DIRECCION></DIRECCION><COMENTARIO></COMENTARIO>
</COMPRADOR><MONTO></MONTO><MONTONETO></MONTONETO><METODOPAGO></METODOPAGO><ITEMS>
<ITEM><DESCRIPCION></DESCRIPCION><MONEDA></MONEDA><PRECIOUNITARIO></PRECIOUNITARIO><CANTIDAD></CANTIDAD>
</ITEM></ITEMS>
</OPERACIÓN></OPERACIONES></DETALLE>
</REPORTE>
57
56
Cantidad del ítem.CANTIDAD
Precio unitario del ítem.PRECIOUNITARIO
Tipo de moneda utilizada en el ítem. Se describen los valorescorrespondientes en la tabla siguiente.
MONEDA
Descripción del ítem.DESCRIPCION
Elemento que contiene los elementos correspondientes a los datos decada ítem.
ITEM
Contiene la colección de ítems de la operación.ITEMS
Método de pago seleccionado para el pago de la operación. Sedescriben los valores correspondientes en la tabla siguiente.
METODOPAGO
Monto total de la compra en pesos. Se utiliza punto (.) como separadorde decimales.MONTO
Comentario que ingresa el comprador durante la compra. Es opcional.COMENTARIO
Dirección que ingresa el comprador como destino de la compra. Esopcional durante el pago de la operación de compra.DIRECCION
Dirección de mail del comprador.EMAIL
Contiene los elementos correspondientes a los datos del comprador.COMPRADOR
Estado actual de la operación. Se describen los valorescorrespondientes en la tabla siguiente.ESTADO
FechaFECHA
Identificador único ingresado en el punto 2.ID
Detalle de la operación solicitada.OPERACIÓN
Contiene los elementos correspondientes a la consulta en si. Contienela cantidad solicitada de operaciones que se requieren en la consultadel punto 4.
OPERACIONES
Elemento que contiene todos los elementos correspondientes al reporte.DETALLE
Este elemento devuelve el estado de la operación de consulta. Losvalores que puede devolver se especifican en la tabla siguiente.
ESTADOREPORTE
Elemento base del documento XML, dentro de este se encuentran todoslos elementos de la consulta.
REPORTE
DescripciónElemento
Descripción de los elementos del documento XML de Reporte.
MONTONETO Monto neto de la operación en pesos. Es el valor informado en MONTOcon las comisiones aplicadas.
58
57
Valores posibles del elemento EstadoReporte
1 CORRECTO
2 XML MAL FORMADO
3 NUMERO DE CUENTA INVALIDO (validación de sintaxis)
4 CLAVE INVALIDA (validación de sintaxis)
5 TIPO DE CONSULTA INVALIDO (validación de sintaxis)
6 ID OPERACIÓN INVALIDO (validación de sintaxis)
7 NUMERO DE CUENTA O CLAVE INVALIDO
8 NO SE ENCONTRARON OPERACIONES A REPORTAR
Valores posibles del elemento Estado1 PENDIENTE DE PAGO
2 ACREDITADO
3 CANCELADO
Valores posibles del elemento MetodoPago
1 FONDOS DINEROMAIL
2 EFECTIVO EN BANCOMER, BANAMEX, SANTANDER, BANCO DEL BAJIO, IXE BANCO, SCOTIBANK/INVERLAT
3 TARJETA DE CREDITO
4 TRANSFERENCIA BANCARIA
5 EFECTIVO EN TIENDAS OXXO Y 7ELEVEN
Valores posibles del elemento Moneda
1 PESO
2 DÓLAR
59
Pasos:
1.
El Vendedor deberá
enviar un e-mail solicitando la activación del proceso de compra sin registro a la siguiente dirección de mail: [email protected]
2.
El Vendedor agrega a su Carrito de Compras o Botón de Compras el siguiente código HTML:
..:::
16
Anexo 3: Proceso de Pre-Registro
58
Los usuarios que utilizan DineroMail para comprar por primera vez, podrán optar por no registrarse. Esto facilita el proceso de compras y representa un beneficio para el Vendedor al permitir la concreción de un mayor número de transacciones.Para acceder a la opción de compra sin registro, el Vendedor deberá
realizar algunas pequeñas modificaciones en su Carrito de Compras o Botón de Compras
<input type="hidden" name="usr_nombre" value="xxxx"> Apellido Comprador (AN 50)<input type="hidden" name="usr_apellido" value="xxxx"> Nombre Comprador (AN 50)<input type="hidden" name="usr_tel_numero“ value="xxxx"> Telefono Comprador (AN 20)<input type="hidden" name="usr_email" value="xxxx"> Email Comprador (AN 255)
60
2-
Una vez agregado este código, el vendedor deberá
enviarnos un e-mail a [email protected]
para que le activemos el nuevo proceso.
Recuerda que si el sitio web
ya tiene implementado el proceso de pre-llenado de los campos de registro de DineroMail no es necesario que implementen el punto 1.
59