Documentos de Académico
Documentos de Profesional
Documentos de Cultura
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.
2
..::: 1 Introducción
Transferencia Bancaria
3
Tu Carrito de Compras o Botón de Compras:
4
..::: 2 Uso del Manual
- Carrito de Compras
- Botón de Compras
5
..::: 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
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.
7
Tus clientes pueden pagar sus compras a través de diferentes medios de
pago:
8
..::: 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 http://argentina.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.
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 $5. Esto quiere decir que la suma total
del valor de la compra del carrito debe ser mayor o igual a cinco pesos
10
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.
11
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
Para retirar fondos, sigue los siguientes pasos:
13
..::: 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
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 $5. Esto quiere
decir que la suma total del valor de la compra del carrito debe ser
mayor o igual a cinco pesos.
15
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
PASO 6: Presiona CREAR BOTÓN DE COMPRAS.
17
Puedes optar por retirar tus fondos inmediatamente o mantenerlos
en tu Cuenta DineroMail. Dispones de 2 formas de retiros de
fondos:
18
..::: 6 Modificación manual del Código
CARRITO DE COMPRAS
19
CODE DESCRIPTION
20
&DireccionFracaso=http%3ª//www.failur Si deseas agregar una dirección a la que será
e.com 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.
21
Botón “Ver el Carrito”
<a href="#"
onclick="window.open('https://argentina.dineromail.com/carrito/cart.asp?Store=7239','
Cart','width=600,height=275,toolbar=no,location=no,status=no,menubar=no,resizable=
yes,scrollbars=no,directories=no');"><img
src="https://argentina.dineromail.com/imagenes/vender/verCarrito/ver-carrito.gif"
border="0"></a>
CODE DESCRIPTION
22
<img Es la imagen del botón. Puedes cambiar
src="https://argentina.dineromail.com/ima la imagen utilizando la URL de los
genes/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 (incluída la parte verde) por el texto
que desees.
23
BOTON DE COMPRAS
Botón “Comprar/Donar”
<form action='https://argentina.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='25.65'> <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=‘5,6,18,13'> <input
type='image' src='https://argentina.dineromail.com/imagenes/vender/boton/comprar-
gris.gif' border='0' name='submit' alt='Pagar con Dineromail'> </form>
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
name='PrecioItem' value='25.65' 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 “-” .
25
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
..::: 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
PASO 2: (el “Botón de compras” saltea este paso)
PASO 3:
28
Si es un usuario nuevo, ingresa algunos datos básicos para
registrarse. La próxima vez que compre será identificado
automáticamente.
PASO 4:
El comprador debe elegir el método de pago que desea:
29
PASO 5:
Si elige Pago Fácil, Rapipago, Bapro Pagos o Cobro Express, debe
imprimir el cupón y acercarse a alguna de las sucursales para
completar el pago.
30
En caso de pagar con Tarjeta de Crédito, el usuario deberá ingresar
los datos de su tarjeta Visa, Mastercard, Argencard, American
Express, Naranja, Cabal, Shopping e Italcred 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
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
PASO 8:
El comprador recibe por e-mail una notificación de la compra.
33
..::: 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
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 Pago Fácil, Rapipago, Bapro Pagos o Cobro Express o con
transferencias bancarias, son procesadas en dos etapas. El vendedor es
notificado únicamente cuando se acredita el pago, para evitar confusiones.
35
..::: 9 Como utilizar un Carrito de Compras externo
36
<form action='https://argentina.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='35'> <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='image'
src='https://argentina.dineromail.com/imagenes/vender/boton/comprar-gris.gif'
border='0' name='submit' alt='Pagar con Dineromail'> </form>
37
..::: 10 Operaciones en Dólares
38
..::: 11 Cómo vender con montos variables
<form action='https://argentina.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='12'> <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://argentina.dineromail.com/imagenes/vender/boton/comprar-gris.gif'
border='0' name='submit' alt=‘Donar con Dineromail'> </form>
39
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
..::: 12 Costos y Límites
https://argentina.dineromail.com/CostosLimites.asp
41
..::: 13 Contacto
Información General:
Razón Social:
E-PAYMENTS S.A.
Dirección Legal:
Uriarte 2489 Piso 2.
C1425FNI - Ciudad de Buenos Aires
Contacto Telefónico
(011) 5275-1798
Nuestro horario de atención es de Lunes a Viernes de 10 a 22
horas.
42
..::: 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
- Código para agregar a la herramienta de venta DineroMail:
Boletas de pago:
(asociado al nodo <Tickets>, ver mas adelante la estructura XML)
- No requiere modificaciones adicionales
Recepciones de Dinero:
(asociado al nodo <Reception>, ver mas adelante la estructura XML)
- No requiere modificaciones adicionales
Retiro de Fondos:
(asociado al nodo <Retreats>, ver mas adelante la estructura XML)
- No requiere modificaciones adicionales
Créditos:
(Asociado al nodo <Credits>, ver mas adelante la estructura XML)
- No requiere modificaciones adicionales
Débitos:
(Asociado al nodo <Debits>, 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://argentina.dineromail.com/Vender/ConsultaPago.asp
44
Name Type of data Description.
E-mail Alphanumeric E-mail de registro en tu cuenta DineroMail.
(255)
Account 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
La página como respuesta envía un XML. Su estructura es la siguiente:
46
47
48
(*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 item 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.
(*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
• Respuesta:
50
51
52
..::: 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.
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.
53
..::: 4. Modificaciones al formulario de CARRITO/BOTON
<form action='https://argentina.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,14,15,16,17,2,7,13'>
<input type='hidden' name='TRX_ID' value='13461'>
<input type='image' src='https://argentina.dineromail.com/imagenes/post-login/boton-
comprar-01.gif' border='0' name='submit' alt='Pagar con DineroMail'>
</form>
54
..::: 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>
</OPEARACION>
</OPERACIONES>
</NOTIFICACION>
55
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.
56
..::: 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://argentina.dineromail.com/Vender/Consulta_IPN.asp
57
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.
58
..::: 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:
59
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.
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.
FECHA Fecha
ESTADO Estado actual de la operación. Se describen los valores correspondientes en la tabla siguiente.
DIRECCION Dirección que ingresa el comprador como destino de la compra. Es opcional durante el pago de la operación
de compra
MONTO Monto total de la compra en pesos. Se utiliza punto (.) como separador de decimales.
MONTONETO Monto neto de la operación en pesos. Es el valor informado en MONTO con las comisiones aplicadas.
METODOPAGO Método de pago seleccionado para pago de operación. Se describen los valores correspondientes en la
tabla siguiente.
CUOTAS Cantidad de cuotas con las que se realizó un pago con tarjeta de crédito.
ITEM Elemento que contiene los elementos correspondientes a los datos de cada ítem.
MONEDA Tipo de moneda utilizada en el ítem. Se describen los valores correspondientes en la tabla siguiente.
60
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
61
..::: 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:
62
2- Una vez agregado este código deberá enviarnos un e-mail
comercial.ar@dineromail.com para que le activemos el nuevo
proceso.
comercial.ar@dineromail.com
63