Documente Academic
Documente Profesional
Documente Cultură
1
..::: Tabla de Contenidos
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
1
..::: 1 Introducción
Transferencia Bancaria
Tiendas OXXO
Tiendas 7-Eleven 3
2
Tu Carrito de Compras o Botón de Compras:
3
..::: 2 Uso del Manual
- Carrito de Compras
- Botón de Compras
4
..::: 3 Descripción general de pagos de DineroMail
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
Tiendas OXXO
6
Tiendas 7-Eleven
5
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.
6
Tus clientes pueden pagar sus compras a través de diferentes medios de
pago:
7
..::: 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.
..::: Introducción
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.
Código.
Ingresa el código interno o número de producto/servicio. Este
campo es opcional.
8
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.
9
PASO 5: 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.
10
PASO 9: 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.
12
11
Para retirar fondos, completa los siguientes pasos:
13
12
..::: 5 Creación del Botón de compras
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.
..::: Introducción
14
13
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.
15
14
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.
16
15
PASO 6: Presiona CREAR BOTÓN DE COMPRAS.
16
Puedes optar por retirar tus fondos inmediatamente o mantenerlos
en tu Cuenta DineroMail. Dispones de 2 formas de retiros de
fondos:
18
17
..::: 6 Modificación manual del Código
CARRITO DE COMPRAS
19
18
CODE DESCRIPTION
19
&DireccionFracaso=http%3ª//www.fail Si deseas agregar una dirección a la que será enviado el
ure.com 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.
20
Botón “Ver el Carrito”
<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>
CODE DESCRIPTION
22
21
<img Es la imagen del botón. Puedes cambiar
src="https://mexico.dineromail.com/image la imagen utilizando la URL de los
nes/vender/verCarrito/ver-carrito.gif" botones predeterminados. Consulta el
border="0"> 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.
23
22
BOTON DE COMPRAS
Botón “Comprar/Donar”
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.
24
23
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' 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 “-” .
24
name='DireccionEnvio' value='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.
26
25
..::: 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.
PASO 1:
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”.
27
26
PASO 2: (el “Botón de compras” saltea este paso)
PASO 3:
28
27
Si es un usuario nuevo, ingresa algunos datos básicos para
registrarse. La próxima vez que compre será identificado
automáticamente.
PASO 4:
28
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.
30
29
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.
PASO 6:
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.
31
30
PASO 7:
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.
32
31
PASO 8:
El comprador recibe por e-mail una notificación de la compra.
33
32
..::: 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.
PASO 1:
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 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.
34
33
PASO 3:
Ingresando en el “Estado” se ve un detalle de toda la operación. Se
incluye el mensaje y la dirección de envío.
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.
35
34
..::: 9 Como utilizar un Carrito de Compras externo
35
<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>
37
36
..::: 10 Operaciones en Dólares
38
37
..::: 11 Cómo vender con montos variables
39
38
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.
40
39
..::: 12 Costos y Límites
https://mexico.dineromail.com/CostosLimites.asp
41
40
..::: 13 Contacto
Información General:
Razón Social: Digicuenta SA de CV
Dirección Legal:
Av. Cuauhtemoc 1486-401C
Colonia Santa Cruz Atoyac
CP 03310
Mexico DF
Contacto Telefónico
41
..::: 14 Anexo 1: Instrucciones para la consulta
automática de pagos
Proceso:
Botón de pago.
(asociado al nodo <Pays>, ver mas adelante la estructura XML)
43
42
- Código para agregar a la herramienta de venta DineroMail:
Boletas de pago..
(asociado al nodo <Tickets>, ver mas adelante la estructura XML)
Order:
https://mexico.dineromail.com/Vender/ConsultaPago.asp
44
43
Name Type of data Description.
E-mail Alphanumeric E-mail de registro en tu cuenta DineroMail.
(255)
Acount Numerical (8) Número de cuenta DineroMail (la misma la
puedes visualizar luego de loguearte en tu
cuenta DineroMail en la página principal. Enviar
todos dígitos, sin la barra invertida).
(*) El valor PIN se visualiza siempre y cuando el usuario tenga activada las
herramientas de venta.
45
44
La página como respuesta envía un XML. Su estructura es la siguiente:
46
45
(*1) Estado: el estado recibido en <State> indica el estado de 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.
47
46
Ejemplo:
• Respuesta:
<?xml version="1.0" encoding="ISO-8859-1" ?>
- <Report>
<Email>ventas@dineromail.com</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>compras@dineromail.com</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>
48
47
- <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>
49
48
..::: 15 Anexo 2: Especificación técnica IPN
1. Introducción
Para aquellos casos en que los usuarios deseen recibir notificaciones
de sus operaciones de manera automática, DineroMail ha desarrollado
IPN.
49
4. Modificaciones al formulario de CARRITO/BOTON
51
50
5. Especificación de la interfaz de notificación.
<NOTIFICACION>
<TIPONOTIFICACION>1</TIPONOTIFICACION>
<OPERACIONES>
<OPERACION>
<TIPO>1</TIPO>
<ID>31548</ID>
</OPERACION>
<OPERACION>
<TIPO>1</TIPO>
<ID>XA5547</ID>
</OPERACION>
</OPERACIONES>
</NOTIFICACION>
52
51
Descripción de los elementos del documento XML de Notificación
Elemento Descripción
NOTIFICACION Elemento base del documento XML, dentro de este se
encuentran todos los elementos de la notificación.
53
52
6. Especificación de la interfaz de consulta
<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
54
53
Descripción de los elementos del documento XML de Consulta.
Elemento Descripción
REPORTE Elemento base del documento XML, dentro de este se
encuentran todos los elementos de la consulta.
55
54
7. Especificación de la interfaz de reporte de operaciones
55
Descripción de los elementos del documento XML de Reporte.
Elemento Descripción
REPORTE Elemento base del documento XML, dentro de este se encuentran todos
los elementos de la consulta.
ESTADOREPORTE Este elemento devuelve el estado de la operación de consulta. Los
valores que puede devolver se especifican en la tabla siguiente.
DETALLE Elemento que contiene todos los elementos correspondientes al reporte.
OPERACIONES Contiene los elementos correspondientes a la consulta en si. Contiene
la cantidad solicitada de operaciones que se requieren en la consulta
del punto 4.
OPERACIÓN Detalle de la operación solicitada.
ID Identificador único ingresado en el punto 2.
FECHA Fecha
Estado actual de la operación. Se describen los valores
ESTADO
correspondientes en la tabla siguiente.
COMPRADOR Contiene los elementos correspondientes a los datos del comprador.
EMAIL Dirección de mail del comprador.
Dirección que ingresa el comprador como destino de la compra. Es
DIRECCION
opcional durante el pago de la operación de compra.
COMENTARIO Comentario que ingresa el comprador durante la compra. Es opcional.
Monto total de la compra en pesos. Se utiliza punto (.) como separador
MONTO de decimales.
56
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
58
57
..::: 16 Anexo 3: Proceso de Pre-Registro
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
Pasos:
59
58
2- Una vez agregado este código, el vendedor deberá enviarnos un
e-mail a comercial.mx@dineromail.com para que le activemos el
nuevo proceso.
60
59