Professional Documents
Culture Documents
..::: Tabla de Contenidos 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. Introduccin Uso del Manual Descripcin general de pagos de DineroMail Creacin del Carrito de compras Creacin del Botn de compras Modificacin manual del Cdigo Funcionamiento del Proceso de Compras Notificacin al Vendedor Como utilizar el Carrito de compras externo Operaciones en dlares Cmo vender con montos variables Costos y Lmites Contacto Anexo 1: Instrucciones para la consulta automtica de pagos 15. Anexo 2: Especificacin tcnica IPN 16. Anexo 3: Proceso de Pre-Registro
2
1
..:::
Introduccin
DineroMail, la empresa lder de pagos online, ha desarrollado sistemas de pago electrnicos que se encuentran a la vanguardia mundial en trminos de seguridad, comodidad y conveniencia. Los servicios de venta que se presentan en este documento permiten a cualquier persona o comercio, con conocimientos mnimos de creacin de pginas Web, vender y cobrar en forma fcil 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 caractersticas del producto a vender. DineroMail genera automticamente un cdigo HTML que puedes colocar en tu pgina Web o enviar por e-mail (formato HTML). Este cdigo es un botn de compra que presionarn tus compradores para pagarte.
Las alternativas de pago que tiene un comprador son: Pagos en Efectivo en cualquier sucursal de ServiPag. Tarjetas de Crdito Visa, Mastercard, American Express, Diners Club, Magna, Tarjeta Presto, Tarjeta Ripley, Tarjeta Abc y Tarjeta Din. Fondos disponibles en la Cuenta DineroMail.
3
2
Se arma en pocos minutos. Es muy simple para tus compradores. Integra muchos medios de pago. No requiere PHP y ASP ni caractersticas especiales de hosting. Se puede colocar en cualquier pagina Web, incluso dentro de remates o pginas gratuitas. Se puede colocar en e-mails con formato HTML. Incluye el logo de tu comercio. Permite incluir un mensaje y la direccin de entrega del producto. Permite personalizar las pginas finales de la compra (una para xito, otra para fracaso).
4
3
..:::
El Manual para Vendedores de DineroMail proporciona informacin sobre la mayora 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:
Configurar de manera rpida y sencilla la funcionalidad de comercio electrnico con DineroMail. Por ejemplo, aprende a integrar Carritos de compra y Botones de compra de DineroMail en tu sitio Web en cuestin de minutos. Conocer tcnicas y herramientas ms avanzadas para sacar el mximo partido a las herramientas de venta de DineroMail. Entender cual es el proceso de compra que realizaran tus clientes al pagar a travs de DineroMail. El Manual para Vendedores de DineroMail incluye informacin e instrucciones del uso de las siguientes funciones: Carrito de Compras Botn de Compras
5
4
..:::
Las herramientas de venta que se presentan en este documento permiten a cualquier persona o comercio, con conocimientos mnimos de creacin de pginas web, comenzar a vender y cobrar de manera fcil, rpida y segura en tan solo unos minutos. DineroMail ofrece una amplia gama de herramientas de venta para que puedas cobrar y recibir pagos a travs de Internet. Este documento describe la operatoria de dos de ellas: Carrito de Compras y Botn de Compras Antes de empezar a operar con DineroMail debers activar las herramientas de venta en la seccin DineroTools de nuestro sitio web.
El Carrito de compras de DineroMail es una alternativa econmica de empezar a aceptar pagos en tu sitio web. Se puede integrar totalmente a tu sitio web siguiendo solo unos simples pasos. Ventajas del Carrito de compras: Se implementa en pocos minutos. Es muy simple para tus compradores. Integra los ms importantes medios de pago. Puedes incluir el logo de tu comercio. Fciles 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 travs del sitio de DineroMail. Mejora la experiencia del personalizables y pagos seguros. comprador: con botones
Tus clientes pueden pagar sus compras a travs de diferentes medios de pago: Pagos en Efectivo en cualquier sucursal de ServiPag. Pagos con tarjeta de crdito Visa, Mastercard, American Express, Diners Club, Magna, tarjeta Presto, Tarjeta Ripley, Tarjeta Abc y Tarjeta Din. Fondos disponibles en tu cuenta de DineroMail.
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 ms importantes medios de pago. Se pueden colocar en e-mails con formato HTML. Fciles 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 travs del sitio de DineroMail. Mejorar la experiencia del comprador: con botones personalizables pagos seguros. y
8
7
..:::
Con el Carrito de compras de DineroMail, tus compradores pueden realizar un solo pago al comprar varios artculos. Un Carrito de compras es muy fcil de configurar y utilizar. Slo basta con crear un botn Agregar Carrito para cada producto o servicio a vender, y luego pegar el cdigo HTML generado automticamente para ese botn en tu sitio web junto al artculo. Completa los siguientes pasos para crear tus botones Carrito de compras.
..::: Introduccin
1. Ingresa en https://chile.dineromail.com/index.asp e inicia la sesin en tu cuenta DineroMail con tu e-mail y clave personal. 2. Haz click en la pestaa DineroTools. 3. Haz click en la opcin Carrito de compras.
Monto. Ingresa el monto que desees cobrar por cada unidad de este producto/servicio. Recuerda utilizar el punto (.) como separador de decimales. Introduce slo 2 cifras decimales. No existe monto mnimo en la creacin del botn, pero tienes que tener en cuenta que no podrs completar una compra por menos de $2.500. Esto quiere decir que la suma total del valor de la compra del carrito debe ser mayor o igual a dos mil quinientos pesos chilenos.
10
Para retirar fondos, completa los siguientes pasos: 123Ingresa a tu Cuenta DineroMail. Haz click en Retirar Fondos. Selecciona la opcin preferida para retirar tus fondos.
13
12
..:::
Un Botn de compras se puede utilizar para vender una sola unidad de un determinado tem o servicio; o tambin permite a tus clientes comprar varias unidades de ese mismo tem. Crear un Botn de compras es muy simple. Es fcil de configurar y utilizar. Slo basta con crear un botn de Comprar/Donar para cada producto o servicio a vender, y luego pegar el cdigo HTML generado automticamente para ese botn en tu sitio web junto al artculo.
..::: Introduccin
1. Ingresa en https://chile.dineromail.com/index.asp e inicia la sesin en tu cuenta DineroMail con tu e-mail y clave personal. Haz click en la pestaa DineroTools. Haz click en la opcin Botn de compras.
2. . 3.
14
13
Descripcin. Ingresa el nombre del producto o servicio a vender. Cdigo. Ingresa el cdigo interno o nmero 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 slo 2 cifras decimales. No existe monto mnimo en la creacin del botn, pero tienes que tener en cuenta que no podrs completar una compra por menos de $2.500. Esto quiere decir que la suma total del valor de la compra del carrito debe ser mayor o igual a dos mil quinientos pesos chilenos.
Recomendamos utilizar una imagen en servidor seguro, ya que toda la informacin de DineroMail se encuentra encriptada bajo protocolo SSL y si el logo de tu compaa 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 operacin no es segura. Si deseas que DineroMail realice el hosteo de tu logo, por favor enviarlo a comercial.cl@dineromail.com. El logo deber tener las siguientes caractersticas: formato gif o jpg, 150x50 pxeles y no debe superar los 50 kb.
17
16
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 acreditacin: 48 a 72 horas hbiles. Cheque a domicilio. Podrs cobrarlo en ventanilla en cualquier sucursal de Banco de Chile o bien depositarlo en una cuenta bancaria propia. Tiempo: 1 a 5 das hbiles. Costo: Consultar Costos y Lmites. Para retirar fondos, completa los siguientes pasos: 123Ingresa a tu Cuenta DineroMail. Haz click en Retirar Fondos. Selecciona la opcin preferida para retirar tus fondos.
18
17
..:::
CARRITO DE COMPRAS Botn Agregar al Carrito / Comprar El siguiente es un ejemplo del cdigo HTML:
<a href="#" onclick="window.open('https://chile.dineromail.com/carrito/cart.asp? NombreItem=Televisor+14+pulgadas&TipoMoneda=1&PrecioItem=30000.00&NroItem =IXD443&image_url=http://www.logo.com/logo.jpg&DireccionExito=http%3A//www.exit o.com&DireccionFracaso=http%3A//www.fracaso.com&DireccionEnvio=1&Mensaje=1 &MediosPago=2,21,23&Comercio=7239','Carrito','width=600,height=275,toolbar=no,lo cation=no,status=no,menubar=no,resizable=yes,scrollbars=yes,directories=no');"><im g 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 parmetro. Si est, debe aparecer tal cual se muestra en el ejemplo. Lo que se encuentra en azul puede ser modificado de la siguiente manera:
19
18
CODE NombreItem=Televisor+14+pulgadas
DESCRIPTION Aqu debes poner el nombre o descripcin del producto o servicio. Atencin: El signo + reemplaza el espacio. Es decir, para escribir Televisor 14 pulgadas, ingresa aqu Televisor+14+pulgadas.
TipoMoneda=1 PrecioItem=30000.00
Ingresa 1 para pesos, 2 para dlar. Es el precio del producto o servicio en forma individual. Atencin: Utiliza el punto (.) para separar decimales. La coma (,) ser rechazada. No pongas ms de 2 decimales. Verifica el monto mximo actualmente disponible en DineroMail.
NroItem=-
Opcional. Puedes reemplazar la parte azul por un cdigo interno del producto dentro del comercio. Sirve para aquellos comercios o vendedores que clasifican con cdigo sus productos. Atencin: si no deseas poner cdigo, ingresa un signo -. 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. Atencin: la extensin 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 notificacin de elementos no seguros. Si deseas agregar una direccin 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 pgina indicada. Atencin: En este parmetro, el signo (:) luego de http debe ser reemplazado por %3A.
&image_url=https://www.logo.com/logo.j pg
&DireccionExito=http%3//www.success. com
20
19
&DireccionFracaso=http%3//www.failur e.com
Si deseas agregar una direccin 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 pgina indicada. Atencin: En este parmetro, el signo (:) luego de http debe ser reemplazado por %3A. Ingresa 1 si deseas que el comprador pueda agregar la direccin en la que desea recibir el producto. Ingresa 0 si no deseas que el comprador pueda agregar la direccin. Ingresa 1 si deseas que el comprador pueda enviar un mensaje. Ingresa 0 si no deseas que el comprador pueda enviar un mensaje. No ingreses ningn valor para aceptar todos los medios de pago. Ingresa 2 para ServiPag, 7 para fondos en cuenta DineroMail, 21 para Presto y 23 para Ripley. Pago en 1, 3 y 6 cuotas con tarjeta de crdito ingresa 4, 5 y 6 respectivamente. O combina los mtodos que desees mediante comas (Ej: 4,2,21,7) El nmero de la cuenta DineroMail del comercio o vendedor (sin ceros y sin el dgito final, que es un dgito verificador). Atencin: Debe coincidir con el e-mail del vendedor. Es el ttulo (arriba, izquierda, parte azul del explorador) que tendr la pgina del carrito de compras. Es la imagen del botn. 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 botn en un texto que cumpla la misma funcin, reemplaza todo (incluida la parte verde) por el texto que desees.
DireccionEnvio=1
Mensaje=1
MediosPago=2, 21, 23
Comercio=7239
Carrito
21
20
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 parmetro. 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 Comercio=7239 DESCRIPTION El nmero de la Cuenta DineroMail del comercio o vendedor (sin ceros y sin el dgito final, que es un dgito verificador). Atencin: Debe coincidir con el email del vendedor. Es el ttulo (arriba, izquierda, parte azul del explorador) que tendr la pgina del carrito de compras.
Cart
22
21
Es la imagen del botn. 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 botn en un texto que cumpla la misma funcin, reemplaza todo (incluida la parte verde) por el texto que desees.
La modificacin del cdigo de manera diferente a la detallada en este documento constituye una violacin de los Trminos y Condiciones de Uso. Est expresamente prohibida la utilizacin de URLs propios que no pertenezcan a imgenes o pginas de xito/fracaso. Asimismo, se prohbe la modificacin de cdigo ajeno o el intento de engaar 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 Trminos y Condiciones de Uso de DineroMail Chile S.A
23
22
<form action='https://chile.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=30000.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=2,21,23'> <input type='image' src='https://chile.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
name='NombreItem' value='Televisor'
DESCRIPTION
Aqu debes poner el nombre o descripcin del producto o servicio. Atencin: El signo + reemplaza al espacio. Es decir, para escribir Televisor 14 pulgadas, ingresa aqu Televisor+14+pulgadas. Ingresa 1 para pesos, 2 para dlar. Si este parmetro no se incluye, se supone que la operacin es en pesos.
name='TipoMoneda' value='1'
24
23
name='PrecioItem' value=30000.00'
Es el precio del producto o servicio en forma individual. Atencin: Utiliza el punto (.) para separar decimales. La coma (,) ser rechazada. No pongas ms de 2 decimales. Verifica el monto mximo actualmente disponible en DineroMail El nmero de la DineroMail del comercio o vendedor (sin ceros y sin el dgito final, que es un dgito verificador). Atencin: Debes coincidir con el e-mail del vendedor. Opcional. Puedes reemplazar la parte azul por un cdigo interno del producto dentro del comercio. Sirve para aquellos comercios o vendedores que clasifican con cdigo sus productos. Atencin: si no deseas poner cdigo, ingresa un signo - . 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. Atencin: la extensin 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 notificacin de elementos no seguros, ya que todo el resto de la pgina se encontrar encriptada. Si deseas agregar una direccin 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 pgina indicada. Si deseas agregar una direccin 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 pgina indicada.
name='E_Comercio' value='94'
name='NroItem' value='IIRUUT'
name='DireccionExito' value='http://www.exito.com'
name='DireccionFracaso' value='http://www.fracaso.com'
25
24
name='DireccionEnvio' value='1'
Ingresa 1 si deseas que el comprador pueda agregar la direccin en la que desea recibir el producto. Ingresa 0 si no deseas que el comprador pueda agregar la direccin.
name='Mensaje' value='1'
Ingresa 1 si deseas que el comprador pueda enviar un mensaje. Ingresa 0 si no deseas que el comprador pueda enviar un mensaje. No ingreses ningn valor para aceptar todos los medios de pago. Ingresa 2 para ServiPag, 7 para fondos en cuenta DineroMail, 21 para Presto y 23 para Ripley. Pago en 1, 3 y 6 cuotas con tarjeta de crdito ingresa 4, 5 y 6 respectivamente. O combina los mtodos que desees mediante comas (Ej: 4,2,21,7) Es la imagen del botn. 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. El texto explicativo que aparece en amarillo, cuando el mouse se detiene sobre el botn. Puedes cambiarlo si lo deseas.
name=MediosPago value=2,21,23
src='https://chile.dineromail.com /imagenes/vender/boton/comprar-gris.gif
26
25
..:::
El siguiente es un ejemplo de la secuencia completa del proceso de compra de un usuario que utiliza el Carrito de compras o el Botn de compras de DineroMail. Como todos los ejemplos de paginas web en esta gua, el mismo se basa en la integracin 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 relacin a la que aqu se muestra. A continuacin se describen los pasos que seguir un comprador que elige pagar con DineroMail en tu sitio web:
PASO 1:
El comprador nuevo ingresa en el comercio. Junto al producto que desea comprar, encuentra un botn Agregar al Carrito. Luego de elegir varios productos, puede presionar en el botn Ver Carrito. Los botones mencionados pueden seleccionarse dentro de un grupo de opciones.
27
26
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 email y clave personal.
28
27
Si es un usuario nuevo, ingresa algunos datos bsicos para registrarse. La prxima vez que compre ser identificado automticamente.
PASO 4:
El comprador debe elegir el mtodo de pago que desea: Pagos en Efectivo en cualquier sucursal de ServiPag. Pagos con tarjeta de crdito Visa, Mastercard, American Express, Diners Club, Magna, tarjeta Presto, Tarjeta Ripley, Tarjeta Abc y Tarjeta Din. Fondos disponibles en la Cuenta DineroMail. 29
28
PASO 5:
Si elige ServiPag, debe imprimir el cupn y acercarse a alguna de las sucursales para completar el pago.
30
29
En caso de pagar con Tarjeta de Crdito, el usuario deber ingresar los datos de su tarjeta Visa, Mastercard, American Express, Diners Club, Tarjeta Magna, tarjeta Presto, Tarjeta Ripley, Tarjeta Abc y Tarjeta Din para concretar la transaccin.
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 direccin de entrega del producto.
31
30
PASO 7:
La operacin se procesa y el comprador es enviado a la pgina 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 notificacin de la compra.
33
32
..:::
Notificacin al Vendedor
A continuacin se describe la secuencia de pasos a travs de los cuales quien vende utilizando DineroMail es notificado de la operacin.
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 operacin 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 operacin. Se incluye el mensaje y la direccin de envo.
Nota: Las operaciones que requieren un pago posterior del comprador, como las de los depsitos 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
..:::
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 operacin a travs de nuestro sistema. Las instrucciones y variables de esta seccin permiten que tus compradores puedan pagar con DineroMail una vez hayan agregado todos los artculos a tu Carrito de compras y estn preparados para realizar el pago y envo. El comercio electrnico puede tener el carrito o aplicacin de compras que desee, lo nico importante es que al momento de pagar, los datos sean estandarizados de acuerdo al formato y direccin establecidos por DineroMail en el cdigo HTML estndar. Por ejemplo, suponiendo que un comercio desea utilizar su propio carrito de compras. Un comprador elige productos y la aplicacin del comercio los va registrando. Supongamos que elige:
Cafetera por $9.000 y Tazas por $1.000. La compra, en pesos, es identificada por el comercio con el pedido nro. CVD22 El programador del comercio electrnico debe hacer que el botn Pagar o Checkout de su carrito de compras haga lo siguiente: 12Tome toda la informacin cargada en el carrito . Complete los campos en azul con esa informacin. 36
35
<form action='https://chile.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=10000.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=2,21,23'> <input type='image' src='https://chile.dineromail.com/imagenes/vender/boton/comprar-gris.gif' border='0' name='submit' alt='Pagar con Dineromail'> </form>
Lo que se encuentra en gris no puede ser modificado. Es cdigo estndar. Lo que se encuentra en negro depende del comercio. Por lo general, estos parmetros sern 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 parmetro, NombreItem. Lo mismo se hizo con el precio, que es el valor total de la compra y se introduce en el parmetro PrecioItem, con el Nmero de Pedido y la moneda de la compra.
37
36
..:::
10
Operaciones en Dlares
Las operaciones en dlares permiten dar mayor estabilidad al precio del producto o servicio, sin necesidad de estar modificndolo de manera constante. La acreditacin de fondos al vendedor ser por el equivalente en pesos, al tipo de cambio vigente en el momento de la compra. No se acreditarn dlares en la Cuenta DineroMail del vendedor. De esta manera, si una operacin es en dlares, se mostrar al comprador el equivalente en pesos al momento de realizar la operacin.
38
37
..:::
11
Si tu venta depende de algo variable, como por ejemplo la cantidad de metros de tela o el importe aleatorio de una donacin, puedes hacer que tu pgina web lo determine en el momento de la compra y lo enve a DineroMail. El mecanismo es idntico al explicado en la seccin anterior. Lo importante es que la informacin sea estandarizada de acuerdo al formato y direccin establecidos por DineroMail en el cdigo HTML estndar. Por ejemplo, puedes poner
La persona que paga, ingresa el monto que desea (supongamos $5.000), y al oprimir el botn Donar, se envan los parmetros a DineroMail de la siguiente manera
<form action='https://chile.dineromail.com/Shop/Shop_Ingreso.asp' method='post'> <input type='hidden' name='NombreItem' value=Donacin'> <input type='hidden' name='TipoMoneda' value='1'> <input type='hidden' name='PrecioItem' value=5000.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='hidden' name='MediosPago' value=2,21,23'> <input type='image' src='https://chile.dineromail.com/imagenes/vender/boton/comprar-gris.gif' border='0' name='submit' alt=Donar con Dineromail'> </form>
39
38
Lo que se encuentra en gris no puede ser modificado, es cdigo estndar y obligatorio. Lo que se encuentra en negro depende del comercio. Por lo general, estos parmetros sern siempre los mismos para un comercio. Lo que se encuentra en azul, en este caso slo el monto de la operacin, es lo que el usuario ingres en el casillero correspondiente.
40
39
..:::
12
Costos y Lmites
Para mayor informacin, consulta nuestra seccin Costos y Lmites, en nuestro sitio web:
https://chile.dineromail.com/CostosLimites.asp
41
40
..:::
13
Contacto
Ante cualquier duda o consulta, por favor no dudes en contactarte con nosotros:
Informacin General: Razn Social: DineroMail Chile S.A Direccin Legal: Av. Vitacura 2670 Piso 15 Las Condes Santiago de Chile Contacto va E-mail: Para consultas generales por favor escrbenos a info.cl@dineromail.com Para consultas comerciales por favor escrbenos a comercial.cl@dineromail.com
Contacto Telefnico Para consultas que requieren asistencia telefnica, por favor comuncate a travs de nuestro nmero de Atencin al Cliente.
..:::
14
Proceso: Para automatizar el proceso de actualizacin 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 podrs actualizar tus registros de forma automtica. Requisitos en las Herramientas utilizadas: Botn 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 Trx id
Description ID de transaccin
- Cdigo para agregar a la herramienta de venta DineroMail <input type='hidden' name='trx_id' value=''>
43
42
- Cdigo para agregar a la herramienta de venta DineroMail: <input type='hidden' name='trx_id' value=''>
Tarjetas de cobranza y Cdigos 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://chile.dineromail.com/Vender/ConsultaPago.asp
La pgina ConsultaPago.asp espera recibir los siguientes parmetros obligatorios por String tanto por mtodo POST como GET:
44
43
Name
E-mail Acount
Type of data
Alphanumeric (255) Numerical (8)
Description.
E-mail de registro en tu cuenta DineroMail. Nmero de cuenta DineroMail (la misma la puedes visualizar luego de loguearte en tu cuenta DineroMail en la pgina principal. Enviar todos dgitos, sin la barra invertida). Clave de acceso para consultas. Podrs encontrarlo una vez que te loguees como usuario en la seccin Mi Cuenta. (*) Fecha de inicio de consulta (El formato es aaaammdd Para meses y das de un carcter de longitud, se debe rellenar con cero a izquierda). (**) Fecha de fin de consulta (El formato es aaaammdd Para meses y das de un carcter de longitud, se debe rellenar con cero a izquierda). (**) El comercio debe enviar este parmetro con el valor 1.
EndDate
Alphanumeric (8)
XML
Numerical (1)
(*) El valor PIN se visualiza siempre y cuando el usuario tenga activada las herramientas de venta. (**) El perodo mximo a consultar es de 1 mes, es decir, la diferencia entre StartDate y EndDate no debe superar los 30 das.
45
44
La pgina como respuesta enva 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 -> fecha inicial recibida <StartDate></StartDate> <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) -> fecha de pago <Trx_Date></Trx_Date> <Trx_Email></Trx_Email> -> email de pago <Trx_Payment></Trx_Payment> -> importe total pagado <Trx_ShipAddress></Trx_ShipAddress> -> direccin 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 cdigos 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>
46
45
(*1) Estado: el estado recibido en <State> indica el estado de la consulta 0. los parmetros 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 envo el comercio en el parmetro trx_id por medio del botn 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 parmetro NroItem por medio del botn 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 cdigo 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
47
46
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
1. Introduccin
Para aquellos casos en que los usuarios deseen recibir notificaciones de sus operaciones de manera automtica, DineroMail ha desarrollado IPN.
<form action='https://chile.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,21,23,7,2> <input type='hidden' name='TRX_ID' value='13461'> <input type='image' src='https://chile.dineromail.com/imagenes/vender/boton/comprar.gif' border='0' name='submit' alt='Pagar con DineroMail'> </form>
51
50
<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
Descripcin
Elemento base del documento XML, dentro de este se encuentran todos los elementos de la notificacin. Indica el tipo de notificacin que se esta enviando. Contiene la coleccin de operaciones. Contiene el detalle de cada operacin, pueden ser una o ms operaciones. Tipo de notificacin que se enva. Este valor es el que proporciona el usuario como identificador nico de la operacin de pago.
TIPO ID
53
52
<REPORTE> <NROCTA>31009</NROCTA> <DETALLE> <CONSULTA> <CLAVE>MIPASSWORD001</CLAVE> <TIPO>1</TIPO> <OPERACIONES> <ID>31548</ID> <ID>XA5547</ID> </OPERACIONES> </CONSULTA> <DETALLE> </REPORTE>
Descripcin
Elemento base del documento XML, dentro de este se encuentran todos los elementos de la consulta. Nmero cuenta del usuario de Dineromail Elemento que contiene todos los elementos correspondientes a la consulta. Contiene los elementos correspondientes a la consulta en si. Clave ingresada por el usuario en Mi Cuenta para autenticar La identificacin del mismo. Tipo de consulta solicitada. Los valores posibles se detallan en La siguiente tabla. Elemento que agrupa todas las operaciones que se solicitan en la consulta. Este valor es el que proporciona el usuario como identificador nico de la operacin de pago. Es el valor ingresado en el punto 2.
NROCTA DETALLE
CONSULTA CLAVE
TIPO
OPERACIONES
ID
55
54
56
55
Descripcin
Elemento base del documento XML, dentro de este se encuentran todos los elementos de la consulta. Este elemento devuelve el estado de la operacin de consulta. Los valores que puede devolver se especifican en la tabla siguiente. Elemento que contiene todos los elementos correspondientes al reporte. Contiene los elementos correspondientes a la consulta en si. Contiene la cantidad solicitada de operaciones que se requieren en la consulta del punto 4. Detalle de la operacin solicitada. Identificador nico ingresado en el punto 2. Fecha Estado actual de la operacin. Se describen los valores correspondientes en la tabla siguiente. Contiene los elementos correspondientes a los datos del comprador. Direccin de mail del comprador. Direccin que ingresa el comprador como destino de la compra. Es opcional durante el pago de la operacin de compra. Comentario que ingresa el comprador durante la compra. Es opcional. Monto total de la compra en pesos. Se utiliza punto (.) como separador de decimales. Monto neto de la operacin en pesos. Es el valor informado en MONTO con las comisiones aplicadas. Mtodo de pago seleccionado para el pago de la operacin. Se describen los valores correspondientes en la tabla siguiente. Contiene la coleccin de tems de la operacin. Elemento que contiene los elementos correspondientes a los datos de cada tem. Descripcin del tem. Tipo de moneda utilizada en el tem. Se describen los valores correspondientes en la tabla siguiente. Precio unitario del tem. Cantidad del tem.
OPERACIN ID FECHA ESTADO COMPRADOR EMAIL DIRECCION COMENTARIO MONTO MONTONETO METODOPAGO ITEMS ITEM DESCRIPCION MONEDA PRECIOUNITARIO CANTIDAD
57
56
58
57
..:::
16
Los usuarios que utilizan DineroMail para comprar por primera vez, podrn optar por no registrarse. Esto facilita el proceso de compras y representa un beneficio para el Vendedor al permitir la concrecin de un mayor nmero de transacciones. Para acceder a la opcin de compra sin registro, el Vendedor deber realizar algunas pequeas modificaciones en su Carrito de Compras o Botn de Compras Pasos: 1. El Vendedor deber enviar un e-mail solicitando la activacin del proceso de compra sin registro a la siguiente direccin de mail: comercial.cl@dineromail.com 2. El Vendedor agrega a su Carrito de Compras o Botn de Compras el siguiente cdigo HTML:
<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)
59
58
2- Una vez agregado este cdigo, el vendedor deber enviarnos un e-mail a comercial.cl@dineromail.com 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.
60
59