Vous êtes sur la page 1sur 38

Manual de integracin

DineroMail 2011

Index
Acerca de este manual .........................................................................................................2 Integracin Estndar ............................................................................................................3 Botn de pago .................................................................................................................. 3 Flujo de Compra................................................................................................... 3 Ejemplo de integracin ........................................................................................ 4 Explicacin del ejemplo ....................................................................................... 5 Ejemplo online ..................................................................................................... 5 Carrito de compras ........................................................................................................... 6 Ejemplo de integracin - Botn Agregar al carrito ........................................... 6 Ejemplo de integracin - Botn Ver carrito ..................................................... 7 Botn de pago con montos variables ............................................................................... 9 Integracin avanzada ......................................................................................................... 14 Link Seguro ..................................................................................................................... 14 Frmula para obtener el hash ........................................................................... 14 Ejemplo de integracin va POST ....................................................................... 15 Ejemplo de integracin va GET ......................................................................... 15 Express Checkout ........................................................................................................... 16 Flujo de Compra................................................................................................. 16 Ejemplo de integracin ...................................................................................... 17 Explicacin del ejemplo ..................................................................................... 18 Ejemplo online ................................................................................................... 18 Iframe para tarjeta de crdito ........................................................................................ 19 Flujo de Compra................................................................................................. 19 Ejemplo de Integracin...................................................................................... 20 Explicacin del ejemplo ..................................................................................... 22 Ejemplo online ................................................................................................... 22 One Click to Buy para Tarjeta de Crdito........................................................................ 23 Flujo de Compra................................................................................................. 23 Ejemplo de integracin ...................................................................................... 24 Explicacin del ejemplo ..................................................................................... 24 Ejemplo online ................................................................................................... 24 Anexo 1: Cdigo HTML estndar completo.......................................................................... 25 Anexo 2: Tabla explicativa de parmetros ........................................................................... 27 Anexo 3: Variables de Medios de Pago ............................................................................... 34 Anexo 4: Referencias grficas ............................................................................................. 36 Anexo 5: Glosario .............................................................................................. 37

Acerca de este manual


Nuestras herramientas de venta pueden ser integradas de dos formas: A travs del Asistente de configuracin disponible en la solapa Soluciones para vendedores una vez logueado en DineroMail. Generando manualmente el cdigo HTML que enva los datos a DineroMail cuando se realiza una transaccin a travs del sitio y con el que cada usuario interacta al momento de concretar un pago.

En este manual se explica cmo generar el cdigo HTML para integrar las siguientes herramientas configurando los valores y las variables involucradas en el proceso de pago: Botn de pago Carrito de compras Botn de pago con montos variables Link seguro Express checkout Iframe para tarjeta de crdito One click to buy para tarjeta de crdito

S DE INTEGR

Integracin Estndar
Botn de pago
Flujo de Compra
El flujo de compra del botn de pago es el siguiente:

El comprador selecciona el producto que desea y hace click en el botn Comprar ubicado en el sitio del vendedor.

El comprador es redirigido al proceso de compra (checkout) de DineroMail donde deber elegir el medio de pago con el que desea pagar.

Pago con tarjeta de crdito

Pago en efectivo

Ejemplo de integracin
El Botn de Pago redirige siempre al usuario al checkout de DineroMail para completar el flujo de compra, por lo que los datos deben enviarse a la URL https://checkout.dineromail.com/CheckOut. El ejemplo a continuacin incluye nicamente las variables obligatorias que el checkout de DineroMail espera recibir para realizar una operacin. Estas variables deben ser trasmitidas parmetros por string, ya sea por mtodo POST como por mtodo GET.
<form action="https://checkout.dineromail.com/CheckOut" method="post" > <!-- Variables Obligatorias --> <input type="hidden" name="merchant" value="1721561" /> <input type="hidden" name="country_id" value="1" /> <input type="hidden" name="payment_method_available" value="all" /> <input type="hidden" name="item_name_1" value="Ejemplo DVD" /> <input type="hidden" name="item_quantity_1" value="1" /> <input type="hidden" name="item_ammount_1" value="12050" /> <!-- Boton --> <input type='image' src='https://argentina.dineromail.com/imagenes/botones/pagar-medios_c.gif' border='0' name='submit' alt='Pagar con DineroMail'> </form>

El texto en azul no forma parte del cdigo HTML, son ttulos explicativos que ayudan a clasificar las variables. El texto en rojo puede ser modificado considerando los valores requeridos por cada variable en el Anexo 2. Todas las variables disponibles para enviar y sus definiciones pueden encontrarse en el Anexo 2 de este manual. El conjunto total de variables puede utilizarse para customizar el proceso de compra mediante la modificacin de:

La informacin personal que se le solicita al comprador. Los medios de pago habilitados para realizar la compra. El diseo de la pgina del checkout. Las opciones de envo del producto. Otras opciones avanzadas.

Explicacin del ejemplo


merchant: se utiliz el nmero de cuenta de DineroMail. Tambin es posible utilizar el email asociado a la cuenta, en este caso dineromail.test.checkout.001@gmail.com. country_id: se utiliza en el ejemplo el id 1 correspondiente a Argentina. payment_method_available: se utiliza el valor all el cual permite realizar un pago por todos los medios de pago. tem_name_1: correspondiente al nombre del producto a detallar en la compra. tem_quantity_1: especifica la cantidad de tems. tem_ammount_1: especifica el monto del tem.

Ejemplo online
Desde esta URL puede accederse al checkout al que sera redirigido el usuario desde el botn generado en el ejemplo anterior. https://checkout.dineromail.com/CheckOut?merchant=1721561&country_id=1&payment_m ethod_available=all&item_name_1=Ejemplo+DVD&item_quantity_1=1&item_ammount_1=1 2050

Carrito de compras
Para integrar la plataforma de pagos de DineroMail a tu propio Carrito de compras debers tener en cuenta que: Se podr pagar con DineroMail slo cuando se hayan agregado al carrito todos los productos que se quieran comprar. Al momento de pagar, lo nico importante es que los datos sean estandarizados de acuerdo al formato y direccin establecidos por DineroMail en el cdigo HTML.

El botn de pago del carrito de compras debe indefectiblemente: Tomar toda la informacin cargada en el carrito. Enviar los datos que correspondan para cada campo a la URL del checkout de DineroMail: https://checkout.dineromail.com/CheckOut. El checkout de DineroMail espera recibir los siguientes parmetros por string, tanto por mtodo POST como GET.

Para mayor informacin sobre el botn de pago recomendamos ver el ejemplo de la pgina 4 de este manual. A diferencia del Botn de pago, para integrar un Carrito de compras de DineroMail a un sitio es necesario otro tipo de cdigo HTML.

Ejemplo de integracin - Botn Agregar al carrito


El siguiente es un ejemplo del cdigo HTML necesario para generar un botn que permita Agregar al carrito un producto.1
.

<a href="#" onclick="window.open('https://argentina.dineromail.com/Carrito/cart.asp?NombreItem=Impresora&am p;TipoMoneda=1&amp;PrecioItem=450%2E00&amp;NroItem=%2D&amp;image_url=https://argentina.d ineromail.com/imagenes/LogosVendedores/1466897.jpg &amp;DireccionExito=http://www.ok.com&amp;DireccionFracaso=http://www.error.com&amp;Direccio nEnvio=1&amp;Mensaje=1&amp;MediosPago=4%2C5%2C6%2C14%2C15%2C16%2C17%2C18%2C2%2C 7&amp;Comercio=1466897','Carrito','width=600,height=275,toolbar=no,location=no,status=no,menubar =no,resizable=yes,scrollbars=yes,directories=no');"><img src="https://argentina.dineromail.com/imagenes/botones/agregar_c.gif"border="0"> </a>

El texto en rojo puede ser modificado considerando los valores requeridos por cada variable en el Anexo 2.

Este HTML ilustra un botn Agregar al carrito para Argentina. Para utilizarlo en otro pas, se debern modificar las variables correspondientes teniendo en cuenta las tablas que siguen.

Ejemplo de integracin - Botn Ver carrito


El siguiente es un ejemplo del cdigo HTML necesario para generar un botn que permita Ver el carrito y acceder a los productos agregados con el botn anterior.2
.

<a href="#" onclick="window.open('https://argentina.dineromail.com/Carrito/cart.asp?Comercio=1466897','Carrito', 'width=600,height=275,toolbar=no,location=no,status=no,menubar=no,resizable=yes,scrollbars=no,direc tories=no');"><img src="https://argentina.dineromail.com/imagenes/botones/ver_c.gif" border="0"></a>

El texto en rojo puede ser modificado considerando los valores requeridos por cada variable en el Anexo 2. VARIABLES DEL VENDEDOR
NombreItem

LONGITUD

OBLIGATORIO VALORES
SI

DESCRIPCIN
Nombre o descripcin del producto o servicio. El signo "+" reemplaza al espacio. Por ejemplo, para escribir "Televisor 14 pulgadas" ingresa "Televisor+14+pulgadas". Moneda local. Dlares. Precio del producto o servicio en forma individual. Utiliza el punto (.) para separar los decimales. La coma (,) ser rechazada. No escribas ms de 2 decimales. Verifica el monto mximo actualmente disponible en DineroMail. Cdigo interno del producto dentro del comercio. Sirve para aquellos comercios o vendedores que clasifican con cdigo sus productos. Si no deseas poner un cdigo, ingresa un signo "-". Si quieres aceptar todos los medios de pago, no ingreses ningn. Ingresa 2 para cdigos de barras, 7 para fondos en cuenta DineroMail, 13 para transferencia bancaria. Pago en 1, 3, 6, 9, 12, 18 y 24 cuotas con tarjeta de crdito ingresa 4, 5, 6, 14, 15, 16 y 17 respectivamente. Para Plan Z ingresa 18. O combina los mtodos que desees mediante comas (Ej: 4,5,6,13).

Tipo Moneda PrecioItem

SI SI

1 2

NroItem

NO

MediosPago

NO

Este HTML ilustra un botn Ver carrito para Argentina. Para utilizarlo en otro pas, se debern modificar las variables correspondientes teniendo en cuenta las tablas que siguen.

image_url

NO

DireccionExito

NO

DireccionFracaso

NO

DireccionEnvio

NO

0 Mensaje NO 1 0 Comercio SI

Carrito

NO

img src

NO

trx_id

20

NO

Logo propio de tu comercio. Reemplazar por la URL de la imagen de tu logo. La extensin debe ser JPG o GIF. Su dimensin no debe exceder los 150x50 pxeles. Se recomienda el uso de una imagen en servidor seguro (https) para evitar que el comprador reciba una notificacin de elementos no seguros. Direccin a la que ser enviado el comprador en las compras exitosas. Reemplazar por la URL de la pgina indicada. En este parmetro el signo (:) luego de "http" debe ser reemplazado por "%3A". Direccin a la que ser enviado el comprador en las compras canceladas. Reemplazar por la URL de la pgina indicada. En este parmetro el signo (:) luego de "http" debe ser reemplazado por "%3A". Si deseas que el comprador pueda agregar la direccin en la que desea recibir el producto. Si deseas que el comprador no pueda agregar la direccin. Si deseas que el comprador pueda enviar un mensaje. Si deseas que el comprador no pueda enviar un mensaje. Nmero de la cuenta DineroMail del comercio o vendedor (sin la barra ni el dgito final). Ttulo (arriba a la izquierda del explorador) que tendr la pgina del Carrito de compras. Imagen del botn. Puedes cambiar la imagen utilizando la URL de los botones predeterminados. Alternativamente puedes ingresar la URL de una imagen propia o enviarla a DineroMail para que la hostee. Si deseas convertir el botn en un texto que cumpla la misma funcin, reemplaza la URL por el texto que desees. Cdigo de transaccin del vendedor. Sirve para utilizar el sistema de consulta IPN2.

Est prohibida la modificacin del cdigo de manera diferente a la detallada en este documento y 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 E-PAYMENTS S.A.

Botn de pago con montos variables


Si se desea permitir que el usuario modifique a discrecin el monto a pagar o donar debe utilizarse un Botn de pago con montos variables.

El Botn de pago con montos variables acepta los mismos parmetros que el Botn de pago estndar, explicado en la pgina 4. El ejemplo a continuacin incluye nicamente las variables obligatorias que el checkout de DineroMail espera recibir para realizar una operacin. Estas variables deben ser trasmitidas parmetros por string, ya sea por mtodo POST como por mtodo GET. Los parmetros del Botn de pago con montos variables se envan a DineroMail de la siguiente manera:

<!--Variables obligatorias--> <form action="https://checkout.dineromail.com/CheckOut" method="post" > <input type="hidden" name="merchant" value="0915726" /> <input type="hidden" name="item_name_1" value="Donacion" /> <input type="hidden" name="item_quantity_1" value="1" /> <input type="text" onKeyPress="return SoloNumerico(event, this);" Onblur="AplicoFormato(this)" id="item_ammount_1" name="item_ammount_1"> <input type="hidden" name="payment_method_available" value="all" /> <input type="hidden" name="country_id" value="1" /> <input type="hidden" name="seller_name" value="Nombre del Comercio" /> <input type='image' src="https://argentina.dineromail.com/imagenes/botones/donar_c.gif" border=0 name=submit> <input type="hidden" name="header_image" value="https://argentina.dineromail.com/imagenes/LogosVendedores/1466897.gif" /></form>

El texto en azul no forma parte del cdigo HTML, son ttulos explicativos que ayudan a clasificar las variables. El texto en rojo puede ser modificado considerando los valores requeridos por cada variable en el Anexo 2. Todas las variables disponibles para enviar y sus definiciones pueden encontrarse en el Anexo 2 de este manual. El conjunto total de variables puede utilizarse para customizar el proceso de compra mediante la modificacin de: La informacin personal que se le solicita al comprador. Los medios de pago habilitados para realizar la compra. El diseo de la pgina del checkout.

Las opciones de envo del producto. Otras opciones avanzadas.

En el siguiente ejemplo se ofrece el cdigo del Botn de montos variables anterior con un JavaScript evitar que los usuarios deban ingresar el valor de los decimales.

<!--Variables obligatorias--> <form action="https://checkout.dineromail.com/CheckOut" method="post" > <input type="hidden" name="merchant" value="0915726" /> <input type="hidden" name="item_name_1" value="Donacion" /> <input type="hidden" name="item_quantity_1" value="1" /> <input type="text" onKeyPress="return SoloNumerico(event, this);" Onblur="AplicoFormato(this)" id="item_ammount_1" name="item_ammount_1"> <input type="hidden" name="payment_method_available" value="all" /> <input type="hidden" name="country_id" value="1" /> <input type="hidden" name="seller_name" value="Nombre del Comercio" /> <input type="hidden" name="header_image" value="https://argentina.dineromail.com/imagenes/LogosVendedores/1466897.gif" /> <input type='image' src="https://argentina.dineromail.com/imagenes/botones/donar_c.gif" border=0 name=submit> </form> <!--Javascript para aceptar decimales--> <script language="javascript"> function SoloNumerico(e, obj) { var sKey = -1; var bResult = true; var bPunto = (obj.value.indexOf(".") != -1); var lCantChars = obj.value.length; if (window.event) { sKey = e.keyCode; } else if (e.which) { sKey = e.which; } if (sKey > 10) { if (((sKey < 48 || sKey > 57) && (sKey != 46 || bPunto)) || (!bPunto && lCantChars > 6 && sKey != 46)) { bResult = false; } } return bResult; } function AplicoFormato(oText) { var aDec = oText.value.split('.'); if(aDec.length > 1) { if(aDec[1].length == 1) { oText.value = aDec[0] + '.' + aDec[1].split('.')[0] + '0'; }

10

if(aDec[1].length oText.value } if(aDec[1].length oText.value } } else {

== 0) { = aDec[0] + '.00'; >= 2) { = aDec[0] + '.' + aDec[1].substr(0,2);

oText.value = aDec + '.00'; } } </script>

El texto en azul no forma parte del cdigo HTML, son ttulos explicativos que ayudan a clasificar las variables. El texto en rojo puede ser modificado considerando los valores requeridos por cada variable en el Anexo 2. El texto en verde identifica las funciones JavaScript. En el siguiente ejemplo se ofrece el cdigo del Botn de montos variables con un diseo aplicado y un Javascript que permitir que los usuarios ingresen el valor de los decimales.
<!--Variables para ubicar el botn dentro de un marco--> <BODY> <table width="45%" align="center" style="border:1px solid #999999;"> <tr> <td height="10"></td> <td align="center"></td> </tr> <tr> <td align="left" height="10" style="padding-left:25px;"> <a href="https://argentina.dineromail.com"><img src="https://checkout.dineromail.com/Content/Images/logo_es.jpg" border="0"></a></td> <td align="right" style="padding-right:25px;"></td> </tr> <tr> <td colspan="2"> <table bgcolor="#EFEFEF" width="90%" align="center" style="border:1px solid #999999;"> <tr> <td align="center" height="10"></td> </tr> <tr> <td align="center" style="font-size:14px; font-weight:bold; color:#999999; font-family:Arial, Helvetica, sans-serif;">Pague en forma segura a travs de DineroMail</td> </tr> <tr> <td align="center" height="10"></td> </tr> <tr> <td width="100%" align="center"> <form action="https://checkout.dineromail.com/CheckOut" method="post" > <!--Variables obligatorias--> <input type="hidden" name="merchant" value="0915726" /> <input type="hidden" name="item_name_1" value="Donacion" /> <input type="hidden" name="item_quantity_1" value="1" /> <input type="text" onKeyPress="return SoloNumerico(event, this);" Onblur="AplicoFormato(this)" id="item_ammount_1" name="item_ammount_1">

11

<input type="hidden" name="payment_method_available" value="all" /> <input type="hidden" name="country_id" value="1" /> <input type="hidden" name="seller_name" value="Nombre del Comercio" /> <input type="hidden" name="header_image" value="https://argentina.dineromail.com/imagenes/LogosVendedores/1466897.gif" /> <br><br><INPUT type=image alt="Pagar con DineroMail" src="https://argentina.dineromail.com/imagenes/botones/donar_c.gif" border=0 name=submit> </FORM> </td> </tr> </table> </td> </tr> <tr> <td colspan="2" height="20"></td> </tr> </table> </BODY></HTML> <!--Javascript para aceptar decimales--> <script language="javascript"> function SoloNumerico(e, obj) { var sKey = -1; var bResult = true; var bPunto = (obj.value.indexOf(".") != -1); var lCantChars = obj.value.length; if (window.event) { sKey = e.keyCode; } else if (e.which) { sKey = e.which; } if (sKey > 10) { if (((sKey < 48 || sKey > 57) && (sKey != 46 || bPunto)) || (!bPunto && lCantChars > 6 && sKey != 46)) { bResult = false; } } return bResult; } function AplicoFormato(oText) { var aDec = oText.value.split('.'); if(aDec.length > 1) { if(aDec[1].length oText.value } if(aDec[1].length oText.value } if(aDec[1].length oText.value } == 1) { = aDec[0] + '.' + aDec[1].split('.')[0] + '0'; == 0) { = aDec[0] + '.00'; >= 2) { = aDec[0] + '.' + aDec[1].substr(0,2);

12

} else { oText.value = aDec + '.00'; } } </script>

El texto en azul no forma parte del cdigo HTML, son ttulos explicativos que ayudan a clasificar las variables. El texto en rojo puede ser modificado considerando los valores requeridos por cada variable en el Anexo 2. . El texto en verde identifica las funciones JavaScript.

13

Integracin avanzada
Link Seguro
Esta configuracin permite encriptar la informacin que se enva a DineroMail a travs del cdigo html, evitando que los datos puedan ser alterados por terceros. DineroMail sugiere fuertemente que tanto los botones de pago como los carritos de compra tengan implementada esta configuracin para asegurar la integridad de los datos. Es requisito solicitar la configuracin de esta funcionalidad a integration@dineromail.com. Para generar el link seguro se deber generar el hash teniendo en cuenta las dos variables descriptas en este cuadro: VARIABLES DEL COMPRADOR
merchant hash

LONGITUD
100 50

DESCRIPCIN
Secure Merchant asignado por DineroMail. Resumen que garantiza la integridad de los valores de los parmetros transmitidos.

PARAMETROS OBLIGATORIOS PARA FUNCIONALIDAD SECURE LINK

Frmula para obtener el hash


Para el clculo del hash se deber: 1 Realizar UrlEncode a los valores de los parmetros que se enviarn al checkout de DineroMail.
item_name_1 buyer_name buyer_email -> Ejemplo+DVD -> Juan+L. -> dineromail.text.checkout.002%40gmail.com

2 Ordenar los parmetros alfabticamente separados por el caracter & de forma key1=value1&key2=value2&key3=value3.
buyer_document_number=12345678&buyer_document_type=dni&buyer_email=din eromail.text.checkout.002%40gmail.com&buyer_lastname=Perez&buyer_name= Juan+L.&buyer_phone=12345678&buyer_sex=m&country_id=1&item_ammount_1=1 2050&item_name_1=Ejemplo+DVD&item_quantity_1=1&merchant=SECURE_MERCHAN T_001&payment_method_available=all

3 Utilizar la Secret Key proporcionada por DineroMail concatenndola al final del string ordenado y realizar el MD5.
MD5(buyer_document_number=12345678&buyer_document_type=dni&buyer_email =dineromail.text.checkout.002%40gmail.com&buyer_lastname=Perez&buyer_n ame=Juan+L.&buyer_phone=12345678&buyer_sex=m&country_id=1&item_ammount _1=12050&item_name_1=Ejemplo+DVD&item_quantity_1=1&merchant=SECURE_MER CHANT_001&payment_method_available=allSECURE_PASSWORD_001)

14

Ejemplo de integracin va POST


Los smbolos %2c, %3f, %3 y similares debern ser utilizados en minscula para poder generar el hash correctamente. En el siguiente ejemplo se aplica esta funcionalidad, se agrega el parmetro hash y se envan los datos va POST. En este caso, a los valores de los parmetros a enviar tambin se les ha realizado el UrlEncode.

<form action="https://checkout.dineromail.com/CheckOut" method="POST" > <!-- Variables Obligatorias --> <input type="hidden" name="merchant" value="E02DCF4A-2C92-4A5F-8C33-8B4CC56A2FE6"/> <input type="hidden" name="country_id" value="1" /> <input type="hidden" name="payment_method_available" value="all" /> <input type="hidden" name="item_name_1" value="Order" /> <input type="hidden" name="item_quantity_1" value="1" /> <input type="hidden" name="item_ammount_1" value="500" /> <!-- Variables Obligatorias para funcionalidad Secure Link --> <input type="hidden" name="hash" value="a76dc023a4473cc362055f0bb30383e4" /> <input type="hidden" name="buyer_email" value="integrationdm02%40gmail.com" /> <input type="hidden" name="buyer_lastname" value="Demo" /> <input type="hidden" name="buyer_name" value="Test" /> <input type="hidden" name="buyer_phone" value="123456789" /> <!-- Variable No Obligatoria --> <input type="hidden" name="item_currency_1" value="ars" /> <input type="hidden" name="transaction_id" value="494489441" /> <!-- Boton --> <input type='image' src='https://argentina.dineromail.com/imagenes/botones/pagarmedios_c.gif' border='0' name='submit' alt='Pagar con DineroMail'> </form>

Ejemplo de integracin va GET


En el siguiente ejemplo online se agrega el parmetro hash al final de la url y los datos viajan va GET al checkout de DineroMail. En este caso tambin se les ha realizado el UrlEncode a los valores de los parmetros a enviar. https://checkout.dineromail.com/CheckOut?buyer_email=integrationdm02%40gmail.com&buyer_lastname =Demo&buyer_name=Test&buyer_phone=123456789&country_id=1&item_ammount_1=500&item_curren cy_1=ars&item_name_1=Order&item_quantity_1=2&merchant=E02DCF4A-2C92-4A5F-8C338B4CC56A2FE6&payment_method_available=all&transaction_id=494489441&hash=d58a5a5e4b2ea72a6b4 6983c93be3d5f

15

Express Checkout
Flujo de Compra
Esta funcionalidad reduce la cantidad de pasos necesarios para concretar el pago al permitir al usuario la seleccin del medio de pago en el sitio del merchant. Al ser redirigido a DineroMail el usuario slo ver el formulario correspondiente al medio elegido en el paso anterior. La configuracin de esta funcionalidad debe solicitarse a international@dineromail.com.

El comprador selecciona el producto que desea y hace click en el botn Comprar ubicado en el sitio del vendedor.

El comprador elige luego el medio de pago en el sitio del vendedor.

16

Pago con tarjeta de crdito

Pago en efectivo

Ejemplo de integracin
El ejemplo a continuacin incluye nicamente las variables obligatorias que el checkout de DineroMail espera recibir para realizar una operacin.

<form action="https://checkout.dineromail.com/CheckOut" method="post" > <!-- Variables Obligatorias --> <input type="hidden" name="merchant" value="integrationdm01@gmail.com" /> <input type="hidden" name="country_id" value="1" /> <input type="hidden" name="payment_method_available" value="all" /> <input type="hidden" name="item_name_1" value="Ejemplo DVD" /> <input type="hidden" name="item_quantity_1" value="1" /> <input type="hidden" name="item_ammount_1" value="12050" /> <!-- Variables Obligatorias para funcionalidad Express Checkout --> <input type="hidden" name="payment_method_1" value="ar_pagofacil" /> <input type="hidden" name="buyer_name" value="Demo" /> <input type="hidden" name="buyer_lastname" value="Test" /> <input type="hidden" name="buyer_sex" value="m" /> <input type="hidden" name="buyer_document_type" value="dni" /> <input type="hidden" name="buyer_document_number" value="12345678" /> <input type="hidden" name="buyer_phone" value="12345678" /> <input type="hidden" name="buyer_email" value="integrationdm02@gmail.com" /> <!-- Boton --> <input type='image' src='https://argentina.dineromail.com/imagenes/botones/pagarmedios_c.gif' border='0' name='submit' alt='Pagar con DineroMail'> </form>

Las variables que figuran en el ejemplo como <Variables Obligatorias para funcionalidad Express Checkout> deben completarse dinmicamente. El texto en azul no forma parte del

17

cdigo HTML, son ttulos explicativos que ayudan a clasificar las variables. El texto en rojo puede ser modificado considerando los valores requeridos por cada variable en el Anexo 2. Todas las variables disponibles para enviar y sus definiciones pueden encontrarse en el Anexo 2 de este manual. El conjunto total de variables puede utilizarse para customizar el proceso de compra mediante la modificacin de: La informacin personal que se le solicita al comprador. Los medios de pago habilitados para realizar la compra. El diseo de la pgina del checkout. Las opciones de envo del producto. Otras opciones avanzadas.

Explicacin del ejemplo


payment_method_1: especifica el medio de pago seleccionado para dirigirse automticamente a la pantalla de resultados. En este ejemplo se utiliza el medio de pago ar_pagofacil mostrando directamente el cdigo de barras. buyer_name, buyer_lastname, buyer_sex, buyer_document_type, buyer_document_number, buyer_phone, buyer_email:detallan los datos del usuario comprador. Son obligatorios debido a que el proceso de compra se ejecutar automticamente dirigindose a la pantalla de resultados. Las variables obligatorias son las mismas utilizadas en el ejemplo de integracin del Botn de pago estndar de la pgina XX.

Ejemplo online
Desde esta URL puede accederse al checkout al que sera redirigido el usuario desde el botn generado en el ejemplo anterior.

https://checkout.dineromail.com/CheckOut?merchant=integrationdm01@gmail.com&country_id=1&payme nt_method_available=all&item_name_1=Ejemplo+DVD&item_quantity_1=1&item_ammount_1=12050&pay ment_method_1=ar_pagofacil&buyer_name=Demo&buyer_lastname=Test&buyer_sex=m&buyer_documen t_type=dni&buyer_document_number=12345678&buyer_phone=12345678&buyer_email=integrationdm02 @gmail.com&submit.x=104&submit.y=15

18

Iframe para tarjeta de crdito


Flujo de Compra
Esta funcionalidad reduce la cantidad de pasos necesarios para concretar el pago al permitirle al usuario completar los datos de su tarjeta de crdito en el sitio del merchant si la seleccion anteriormente como medio de pago. El flujo de compra se realiza en un nico sitio a travs de un iframe de DineroMail. La configuracin de esta funcionalidad debe solicitarse a integration@dineromail.com.

El comprador selecciona el producto que desea y hace click en el botn Comprar ubicado en el sitio del vendedor.

El comprador completa los datos de su tarjeta de crdito en el sitio del vendedor si la eligi como medio de pago.

19

Ejemplo de Integracin
El ejemplo a continuacin incluye nicamente las variables obligatorias que el checkout de DineroMail espera recibir para realizar una operacin y permite incrustar en un sitio web mediante el tag <iframe> el formulario de tarjeta de crdito para realizar un pago.
<h1>Mi sitio web</h1> <iframe src="https://checkout.dineromail.com/CheckOut?buyer_document_number=12345678&b uyer_document_type=dni&buyer_email=integrationdm01@gmail.com&buyer_lastname=Te st&buyer_name=Demo&buyer_phone=12345678&buyer_sex=m&country_id=1&item_ammount_ 1=12050&item_name_1=Ejemplo+DVD&item_quantity_1=1&merchant=1769592&payment_met hod_available=all&checkout_views=iframe&payment_method_1=ar_visa,1&iframe_back ground_color=CCC&iframe_font_size=14px&iframe_font_link_color=FFF&iframe_font_ color=FFF" height="600" width="400"> </iframe>

Las variables que figuran en el ejemplo como <Variables Obligatorias para funcionalidad Express Checkout> deben completarse dinmicamente. Observacin importante: las dimensiones del tag <iframe> tienen que tener un ancho >= 600 y un alto >= 400. Todos los medios de pago estn habilitados para tarjeta de crdito y de dbito. Deben especificarse las cuotas. Por ejemplo, Visa en una cuota ar_visa,1. Todas las variables disponibles para enviar y sus definiciones pueden encontrarse en el Anexo 2 de este manual. El conjunto total de variables puede utilizarse para customizar el proceso de compra mediante la modificacin de: La informacin personal que se le solicita al comprador. Los medios de pago habilitados para realizar la compra. El diseo de la pgina del checkout. Las opciones de envo del producto. Otras opciones avanzadas.

VARIABLE

LONGITUD
100

VALORES

DESCRIPCIN

PARAMETROS OBLIGATORIOS PARA FUNCIONALIDAD IFRAME


merchant - Nmero de cuenta de DineroMail sin la barra ni el ltimo dgito. - Identificador alfanumrico para operar de forma segura(proporcionado por DineroMail). - Email asociado a la cuenta de DineroMail. Nombre del comprador. Apellido del comprador.

buyer_name buyer_lastname

50 50

20

buyer_email payment_method_1

150 Ver medios de pago habilitados para iframe

Email del comprador. Medio de pago preseleccionado para visualizar automticamente el formulario de checkout de tarjeta de crdito reducido para funcionalidad Iframe. En el caso de medios de pago con cuotas, stas deben especificarse con un valor numrico, por ejemplo: pago con tarjeta de crdito Visa en una cuota ar_visa,1. Indica la vista a utilizar.

Checkout_views

20

Iframe

VARIABLE
iframe_background_color iframe_font_color iframe_font_name 6 6

LONGITUD

DESCRIPCIN
Color de fondo del Iframe (ej: FFFFFF). Color de la fuente (ej: 000000). Nombre de la fuente HTML (ej Times New Roman). Tamao de la fuente (ej: 12px). Grosor de la fuente (ej: bold). Color de fuente de los vinculos (ej: FF0000). Color de borde de las cajas de texto (ej: 000000). Color de fondo de las cajas de texto (ej: FFFFFF). Color de fuente de las cajas de texto (ej: FF0000). Color de borde de los botones (ej: 000000). Tamao de fuente de los botones (ej 14px). Nombre de la fuente HTML de los botones (ej: Verdana). Grosor de fuente de los botones (ej: bold). Color de fondo de los botones (ej: FF0000).

PARAMETROS OPCIONALES PARA FUNCIONALIDAD IFRAME


50

iframe_font_size iframe_font_weight iframe_font_link_color

4 10 6

iframe_input_border_color

iframe_input_background_color

iframe_input_font_color

iframe_button_border_color

iframe_button_font_size

iframe_button_font_name

50

iframe_button_font_weight iframe_button_background_color

10 6

21

Explicacin del ejemplo


payment_method_1: especifica el medio de pago a visualizar en la vista Iframe. checkout_views: especifica que la vista a visualizar ser del tipo Iframe. Iframe_background_color: modifica el color de fondo del formulario. En este caso ser #CCC. Iframe_font_size: modifica el tamao de la fuente del formulario. En este caso ser de 14px. Iframe_font_link_color: modifica el color de la fuente para los vnculos del formulario. En este caso ser #FFF. Iframe_font_color: modifica el color de la fuente del formulario. En este caso ser #FFF. Las variables obligatorias son las mismas utilizadas en el ejemplo de integracin del Botn de pago estndar de la pgina XX. Las variables de diseo que no sean especificadas, como en el caso del ejemplo, tomarn el valor de diseo default de DineroMail.

Ejemplo online
Desde esta URL puede accederse al iframe generado en el ejemplo anterior, por lo que debe ser utilizada en un tag <iframe>. https://checkout.dineromail.com/CheckOut?buyer_document_number=12345678&buyer_d ocument_type=dni&buyer_email=integrationdm01@gmail.com&buyer_lastname=Test&buy er_name=Demo&buyer_phone=12345678&buyer_sex=m&country_id=1&item_ammount_1= 12050&item_name_1=Ejemplo+DVD&item_quantity_1=1&merchant=1769592&payment_me thod_available=all&checkout_views=iframe&payment_method_1=ar_visa,1&iframe_backgro und_color=CCC&iframe_font_size=14px&iframe_font_link_color=FFF&iframe_font_color=FFF

22

One Click to Buy para Tarjeta de Crdito


Flujo de Compra
Esta configuracin permite almacenar los datos de las tarjetas de crdito para que en operaciones posteriores el usuario slo deba ingresar el cdigo de seguridad (CCV) de su tarjeta si vuelve a elegirla como medio de pago. El usuario deber elegir entre permitir reutilizar los datos de su tarjeta de crdito en el comercio en el que est realizando la operacin o en todos los comercios que operan a travs de DineroMail.

El comprador selecciona el producto que desea y hace click en el botn Comprar ubicado en el sitio del vendedor.

El comprador completa, siempre en el sitio del vendedor, todos los datos de su tarjeta de crdito o slo el CCV dependiendo de si es la primera vez que la elige como medio de pago.

23

Ejemplo de integracin
La funcionalidad 1c2b que almacena los datos de las tarjetas de crdito en DineroMail tambin puede ser utilizada en la integracin de vista Iframe descripta en la pgina 19. Para poder integrar esta solucin se requiere: 1. Utilizar las variables obligatorias explicadas en la integracin de Iframe para tarjeta de crdito en la pgina 19; 2. Enviar los datos de la tarjeta de crdito.

<h1>Mi sitio web</h1> <iframe src=https://checkout.dineromail.com/CheckOut?buyer_document_number=12345678& buyer_document_type=dni&buyer_email=Test@gmail.com&buyer_lastname=Test&buyer_ name=Demo&buyer_phone=12345678&buyer_sex=m&checkout_views=iframe&country_id=1 &item_ammount_1=12050&item_name_1=DVD&item_quantity_1=1&merchant=integrationd m01@gmail.com&payment_method_1=ar_visa,1&payment_method_available=all height=400 width=300> </iframe>

Explicacin del ejemplo


checkout_views: se agrega el parmetro para visualizar la operacin como Iframe. merchant: se podra haber utilizado tambin el merchant seguro para permitir almacenar tarjetas y reutilizar las que fueron previamente cargadas sin requerir que el usuario se loguee en DineroMail. Las variables de diseo que no fueron especificadas en el ejemplo tomarn el valor de diseo default de DineroMail.

Ejemplo online
Desde esta URL puede accederse al iframe generado en el ejemplo anterior, por lo que debe ser utilizada en un tag <iframe>. https://checkout.dineromail.com/CheckOut?buyer_document_number=12345678&buyer_doc ument_type=dni&buyer_email=Test@gmail.com&buyer_lastname=Test&buyer_name=Demo& buyer_phone=12345678&buyer_sex=m&checkout_views=iframe&country_id=1&item_ammou nt_1=12050&item_name_1=DVD&item_quantity_1=1&merchant=integrationdm01@gmail.co m&payment_method_1=ar_visa,1&payment_method_available=all

24

Anexo 1: Cdigo HTML estndar completo


El Botn de Pago, es redirigido siempre al proceso de compra (checkout) de DineroMail, para ello se debe enviar los datos a la siguiente URL: https://checkout.dineromail.com/CheckOut. El checkout de DineroMail espera recibir los siguientes parmetros por string, tanto por mtodo POST como GET. El siguiente es un ejemplo del cdigo HTML que ilustra un Botn de pago 3 :
F F

<form action="https://checkout.dineromail.com/CheckOut" method="post" > <!-- VARIABLES DEL VENDEDOR --> <input type="hidden" name="tool" value="button" /> <input type="hidden" name="merchant" value="1466897" /> <input type="hidden" name="country_id" value="1" /> <input type="hidden" name="seller_name" value="Nombre del Vendedor" /> <input type="hidden" name="language" value="es" /> <input type="hidden" name="transaction_id" value="111222333" /> <input type="hidden" name="currency" value="ars" /> <input type="hidden" name="ok_url" value="http://www.ok.com" /> <input type="hidden" name="error_url" value="https://www.error.com" /> <input type="hidden" name="pending_url" value="www.pending.com" /> <input type="hidden" name="buyer_message" value="1" /> <input type="hidden" name="change_quantity" value="1" /> <input type="hidden" name="display_shipping" value="1" /> <input type="hidden" name="display_additional_charge" value="1" /> <!-- VARIABLES DE MEDIOS DE PAGO--> <input type="hidden" name="payment_method_available" value="ar_visa;ar_amex;ar_master,1,3;ar_pagofacil;ar_dm;" /> <input type="hidden" name="payment_method_1" value="" /> <!-- VARIABLES DEL PRODUCTO/ITEM --> <!-- Item 1 --> <input type="hidden" name="item_name_1" value="Ejemplo DVD" /> <input type="hidden" name="item_code_1" value="001" /> <input type="hidden" name="item_quantity_1" value="1" /> <input type="hidden" name="item_ammount_1" value="20000" /> <input type="hidden" name="item_currency_1" value="ars" /> <!-- VARIABLES DE ENVO --> <input type="hidden" name="shipping_type_1" value="3" /> <input type="hidden" name="weight_1" value="kg" /> <input type="hidden" name="item_weight_1" value="0400" /> <input type="hidden" name="shipping_currency_1" value="ars" /> <input type="hidden" name="shipping_cost_1_1" value="5000" /> <!-- VARIABLES DEL COMPRADOR --> <input type="hidden" name="buyer_name" value="Juan Jose" /> <input type="hidden" name="buyer_lastname" value="Herrera" /> <input type="hidden" name="buyer_sex" value="M" /> <input type="hidden" name="buyer_nacionality" value="arg" /> <input type="hidden" name="buyer_document_type" value="dni" /> <input type="hidden" name="buyer_document_number" value="12456111" /> <input type="hidden" name="buyer_email" value="jjherrera@buyeremail.com" />

3 Este HTML ilustra un ejemplo de Botn de pago para Argentina. Para utilizarlo en otro pas, se debern modificar las variables correspondientes al pas teniendo en cuenta las tablas que siguen a continuacin.

25

<input <input <input <input <input <input <input <input <input

type="hidden" type="hidden" type="hidden" type="hidden" type="hidden" type="hidden" type="hidden" type="hidden" type="hidden"

name="buyer_phone" value="55555555" /> name="buyer_phone_extension" value="123" /> name="buyer_zip_code" value="1234" /> name="buyer_street" value="Arenales" /> name="buyer_number" value="123" /> name="buyer_complement" value="hola" /> name="buyer_city" value="Capital Federal" /> name="buyer_state" value="Buenos Aires" /> name="buyer_country" value="arg" />

<!-- VARIABLES ADICIONALES --> <!-- Item 1 --> <input type="hidden" name="additional_fixed_charge" value="10000" /> <input type="hidden" name="additional_fixed_charge_currency" value="ars" /> <input type="hidden" name="additional_var_description_1" value="XXX" /> <input type="hidden" name="additional_var_value_1" value="" /> <input type="hidden" name="additional_var_visible_1" value="1" /> <input type="hidden" name="additional_var_required_1" value="0" /> <!-- VARIABLES DE DISEO--> <input type="hidden" name="header_image" value="https://argentina.dineromail.com/imagenes/LogosVendedores/1466897.gif" /> <input type="hidden" name="header_width" value="1" /> <input type="hidden" name="expanded_step_PM" value="0" /> <input type="hidden" name="expanded_step_AD" value="0" /> <input type="hidden" name="expanded_step_SC" value="0" /> <input type="hidden" name="expanded_sale_detail" value="1" /> <input type="hidden" name="step_color" value="F6F6F6" /> <input type="hidden" name="hover_step_color" value="E8FFD3" /> <input type="hidden" name="links_color" value="669900" /> <input type="hidden" name="font_color" value="666666" /> <input type="hidden" name="border_color" value="999999" /> <input type="hidden" name="button_color" value="7DBE0B" /> <input type='image'src='https://argentina.dineromail.com/imagenes/botones/pagarmedios_c.gif' border='0' name='submit' alt='Pagar con DineroMail'> </form>

El texto en azul no forma parte del cdigo HTML, son ttulos explicativos que ayudan a clasificar las variables. El texto en rojo puede ser modificado considerando los valores requeridos por cada variable en el Anexo 2.

26

Anexo 2: Tabla explicativa de parmetros


REF. GRFICA
1 2

VARIABLES
tool merchant

LONGITUD
8 100

OBLIGATORIO
NO SI

VALORES
button cart

DESCRIPCIN
Identifica un Botn de pago. Identifica un Carrito de compras. Distintos tipos de merchant: - Nmero de cuenta de DineroMail sin la barra ni el ltimo dgito. - Identificador alfanumrico para operar de forma segura (proporcionado por DineroMail). - Email asociado a la cuenta de DineroMail. Pas donde opera el vendedor (merchant). Nombre del vendedor o leyenda que el vendedor quiere mostrar en lugar de su email. Idioma por default del proceso de compra en espaol. Idioma por default del proceso de compra en portugus. Idioma por default del proceso de compra en ingls. (En caso de no recibir el dato, se usar el idioma del pas del vendedor). Cdigo de transaccin del vendedor. Sirve para utilizar el sistema de consulta IPN2. Moneda de Argentina. Moneda de Mxico. Moneda de Chile. Moneda de Estados Unidos. Moneda de Brasil. URL donde se redirecciona al comprador en caso de transaccin exitosa. URL donde se redirecciona al comprador en caso de transaccin errnea. URL donde se redirecciona al comprador en caso de transaccin pendiente. Permite redireccionar automticamente a la url seteada en ok_url, error_url o pending_url. Requiere utilizar una de estas. Permite o no al comprador ingresar un mensaje para el vendedor. Default.

VARIABLES DEL VENDEDOR

3 4

country_id seller_name

2 50

SI NO

Anexo 3

language

NO

es pt en

transaction_id

20

NO

currency

NO

ars mxn clp usd brl

ok_url

255

NO

error_url

255

NO

10

pending_url

255

NO

11

url_redirect_enable d

NO

1 0

12

buyer_message

NO

0 1

27

13

change_quantity

NO

0 1

No permite modificar la cantidad de los tems de compra. Permite modificar la cantidad de los tems de compra. Default. Medios de pago a mostrar en el proceso de pago (checkout). Separa los medios de pago elegidos por ; sin espacios y las cuotas con ,. Por ejemplo, si quieres ofrecer Visa slo en 6 cuotas, debers escribir lo siguiente: "ar_visa,6; ar_amex" "ar_visa;ar_amex; ar_master,1,3; ar_pagofacil;ar_dm;". Si se escribe slo el medio de pago, sin segmentar en cuotas, por default se ofrecern todas las cuotas disponibles (1, 3, 6, 9, 12 y 18). Medio de pago preseleccionado por default. Por ejemplo, si quieres que aparezca preseleccionado VISA: payment_method_1= ar_visa. Si no quieres preseleccionar ningn medio de pago por default, deja el campo vaco: payment_method_1= . Nombre del tem de venta. x es un identificador numrico ya que esta variable puede repetirse en caso de haber ms de un tem de venta. La secuencia numrica se inicia en 1. Ejemplo: item_name_1. Cdigo del tem de venta. x es un identificador numrico ya que esta variable puede repetirse en casos de haber ms de un tem de venta. La secuencia numrica se inicia en 1. Ejemplo: item_code_1. Cantidad de tems solicitados. x es un identificador numrico ya que esta variable puede repetirse en casos de haber ms de un tem de venta. La secuencia numrica se inicia en 1. Ejemplo: item_quantity_1. Valor del tem de venta. x es un identificador numrico ya que esta variable puede repetirse en casos de haber ms de un tem de venta. La secuencia numrica se inicia en 1. Ejemplo: item_ammount_1.

VARIABLES DE MEDIOS DE PAGO


14 payment_method_ available SI Anexo 3

15

payment_method_ 1

NO

Anexo 3

VARIABLES DE PRODUCTO/ITEM
16 item_name_x 150 SI

17

item_code_x

20

NO

18

item_quantity_x

SI

Nmero entero

19

item_ammount_x

19

SI

Los ltimos dos dgitos son decimales

28

20

item_currency_x

NO

ars mxn clp usd brl

Moneda del tem de venta en peso argentino. Moneda del tem de venta en peso mexicano. Moneda del tem de venta en peso chileno. Moneda del tem de venta en dlar estadounidense. Moneda del tem de venta en real brasilero. x es un identificador numrico ya que esta variable puede repetirse en casos de haber ms de un tem de venta. La secuencia numrica se inicia en 1. Producto sin envo disponible. Default. Envo con costo fijo. Se utiliza siempre el valor establecido en la variable shipping_cost_1_x por cada unidad del item_x. Envo con costo fijo segn la cantidad de tems. Utiliza el valor establecido en la variable shipping_cost_1_x por una unidad del item_x. En caso de que la cantidad del tem_x sea mayor a 1, utiliza el valor establecido en la variable shipping_cost_2_x por una unidad del item_x. Flete por peso. El costo se calcula automticamente teniendo en cuenta el peso del tem_x. Este valor est establecido en la variable item_weight_x. x es un identificador numrico ya que esta variable puede repetirse en casos de haber ms de un tem de venta. La secuencia numrica se inicia en 1. Ejemplo: shipping_type_1. Costo de envo del producto por 1 cantidad. Obligatorio si shipping_type_x = 1 o shipping_type_x = 2. x es un identificador numrico ya que esta variable puede repetirse en casos de haber ms de un tem de venta. La secuencia numrica se inicia en 1. Ejemplo: shipping_cost_1_1. Costo de envo de producto por ms de una cantidad. Obligatorio si shipping_type_x = 2. x es un identificador numrico ya que esta variable puede repetirse en

VARIABLES DEL ENVIO


21 shipping_type_x 2 NO 0 1

22

shipping_cost_1_x

19

NO

Los ltimos dos dgitos son decimales.

23

shipping_cost_2_x

19

NO

Los ltimos dos dgitos son decimales.

29

24

weight_x

NO

kg lb

25

item_weight_x

NO

Los ltimos tres dgitos son decimales

26

shipping_currency

NO

ars mxn clp usd brl

casos de haber ms de un tem de venta. La secuencia numrica se inicia en 1. Ejemplo: shipping_cost_2_1. Define la unidad de peso como kilogramo. Define la unidad de peso como libra. Obligatorio si existe shipping_type_x= 3. x es un identificador numrico ya que esta variable puede repetirse en casos de haber ms de un tem de venta. La secuencia numrica se inicia en 1. Ejemplo: weight_1. Peso del tem de venta. Obligatorio si shipping_type_x = 3. Valor mnimo para kg: 0,300. Valor mximo kg: 30. Valor mnimo para lb: 0,700. Valor mximo lb: 66. x es un identificador numrico ya que esta variable puede repetirse en casos de haber ms de un tem de venta. La secuencia numrica se inicia en 1. Ejemplo: item_weight_1. Moneda del costo de envo en peso argentino. Moneda del costo de envo en peso mexicano. Moneda del costo de envo en peso chileno. Moneda del costo de envo en dlar estadounidense. Moneda del costo de envo en real brasilero. (En caso de no recibir el dato, se usar la moneda del pas del merchant). Nombre del comprador. Apellido del comprador.

VARIABLES DEL COMPRADOR


27 28 29 30 31 32 33 34 35 36 buyer_name buyer_lastname buyer_sex buyer_nacionality buyer_document_t ype buyer_document_n umber buyer_email buyer_phone buyer_phone_exte nsion buyer_zip_code 50 50 1 3 2 50 100 20 5 10 NO NO NO NO NO NO NO NO NO NO m f Anexo 3 Anexo 3 Masculino. Femenino Nacionalidad del comprador. Tipo de documento del comprador. Nmero de documento del comprador. Email del comprador. Nmero de telfono del comprador. Interno del comprador. Cdigo postal del comprador.

30

37 38 39 40 41 42

buyer_street buyer_number buyer_complement buyer_city buyer_state buyer_country

50 10 20 50 50 3

NO NO NO NO NO NO Anexo 3

Calle del comprador utilizada para el envo. Nmero del comprador utilizada para el envo. Complemento del comprador utilizada para el envo. Ciudad del comprador utilizada para el envo. Provincia del comprador utilizada para el envo. Pas del comprador utilizada para el envo. Permite al comprador modificar el importe de la compra con un monto fijo. Acepta valores negativos.

VARIABLES DEL ADICIONALES


43 additional_fixed_ch arge 19 NO Los ltimos dos dgitos son decimales. ars mxn clp usd brl

44

additional_fixed_ch arge_currency

NO

45

additional_variable _charge

NO

Los ltimos dos dgitos son decimales.

Moneda del costo adicional en peso argentino. Moneda del costo adicional en peso mexicano. Moneda del costo adicional en peso chileno. Moneda del costo adicional en dlar estadounidense. Moneda del costo adicional en real brasilero. (En caso de no recibir el dato, se usar la moneda del pas del vendedor). Permite al comprador modificar el importe de la compra con un porcentaje de la misma.

46

additional_var_des cription_x

50

NO

47

additional_var_valu e_x

50

NO

48

additional_var_visi ble_x

NO

Nombre de la variable adicional. x es un identificador numrico ya que esta variable puede repetirse en casos de haber ms de una variable adicional. La secuencia numrica se inicia en 1. Ejemplo: additional_var_description_1. Valor de la variable adicional (no editable por el comprador). En caso de no existir, el comprador s podr editar este valor. x es un identificador numrico ya que esta variable puede repetirse en casos de haber ms de una variable adicional. La secuencia numrica se inicia en 1. Ejemplo: additional_var_value_1. Oculta a additional_var_description_x y a additional_var_value_x.

31

49

additional_var_req uired _x

NO

0 1

Hace visible a additional_var_description_x y a additional_var_value_x. Default. x es un identificador numrico ya que esta variable puede repetirse en casos de haber ms de una variable adicional. La secuencia numrica se inicia en 1. Ejemplo: additional_var_visible_1. El parmetro additional_var_value_x no es obligatorio. Default. Valida, al momento de realizar el pago, que el parmetro additional_var_value_x no est vaco. x es un identificador numrico ya que esta variable puede repetirse en casos de haber ms de una variable adicional. La secuencia numrica se inicia en 1. Ejemplo: additional_var_required_1. URL de la imagen a mostrar en el header. El tamao mximo permitido para el logo alineado a la izquierda es de 200x100 pxeles y para header completo es de 760x100 pxeles en formato JPG o GIF. Recomendamos hostear la imagen en un sitio seguro (https) o enviarla a DineroMail para que la hostee. Indica que la imagen ocupa slo el margen superior izquierdo del header. Default. Indica que la imagen ocupa todo el header. Muestra el paso de medios de pago contrado. Default. Muestra el paso de medios de pago desplegado. Muestra el paso de variables adicionales contrado. Default. Muestra el paso de variables adicionales desplegado. Muestra el paso de envo contrado. Muestra el paso de envo desplegado. Default. Muestra el detalle de costos contrado. Muestra el detalle de costos desplegado. Default. Color del fondo de PASOS inactivos y fondo del ttulo del detalle. Color del fondo de PASO activo (en estado hover). Color de los links, total, subtotal de descuento y flechas de ttulos.

VARIABLES DE DISEO
50 header_image 255 NO

51

header_width

NO

2 52 expanded_step_ PM 1 NO 0 1 53 expanded_step_ AD 1 NO 0 1 54 expanded_step_ SC 1 NO 0 1 0 1 56 57 58 step_color hover_step_color links_color 7 7 7 NO NO NO

55

expanded_sale_det ail

NO

32

59 60 61 62

font_color border_color button_color display_shipping

7 7 7 1

NO NO NO NO

0 1

63

display_additional_ charge

NO

0 1 2

64

image

NO

65

summary_visible

NO

1 0 1 0

66

header_visible

NO

Color de fuente de la pgina. Color de bordes de tablas y botones. Color del fondo de los botones. Oculta el paso de envo de flete. Default. Muestra el paso de envo de flete. En caso de existir shipping_type_x, el default de display_shipping = 1. Oculta el detalle de cargos adicionales. Default. Muestra el detalle de cargos adicionales Fijo. Muestra el detalle de cargos adicionales Variable. En caso de existir additional_fixed_charge el default de display_additional_charge = 1. En caso de existir additional_variable_charge el default de display_additional_charge = 2. SI existen ambos el default es el 1. Puedes elegir la imagen del botn de pago indicando la URL en donde se encuentra alojada. Puedes ocultar el detalle de la compra (tems, cargos adicionales, precios) en todo el proceso. Puedes ocultar el encabezado en todo el proceso de compra.

33

Anexo 3: Variables de Medios de Pago


VALOR
all ar_amex ar_argencard ar_banktransfer ar_bapropago ar_cabal ar_cobroexpress ar_dm ar_italcred ar_master ar_pagofacil ar_rapipago ar_tnaranja ar_tshopping ar_visa ar_ripsa all br_amex br_aura br_visa br_oipaggo br_master br_hipercard br_dm br_diners br_bbancario br_bco_brasil_dd br_bco_bradesco_dd all cl_visa cl_servipag cl_ripley cl_presto cl_master cl_magna cl_dm cl_diners cl_amex all mx_scotiabank_tc mx_scotiabank_tb mx_scotiabank_dr

COMENTARIO

VALORES VARIABLE MEDIOS DE PAGO - Argentina


Todos los medios de pago (Default) American Express en Argentina ArgenCard Argentina Transferencia bancaria en Argentina Bapropago en Argentina Cabal en Argentina CobroExpress en Argentina Fondos DineroMail en Argentina Italcred en Argentina MasterCard en Argentina Pago Fcil en Argentina Rapipago en Argentina Tarjeta Naranja en Argentina Tarjeta Shopping en Argentina Visa en Argentina Ripsa en Argentina

VALORES VARIABLE MEDIOS DE PAGO - Brasil


Todos los medios de pago (Default) American Express en Brasil Aura en Brasil Visa en Brasil OiPaggo en Brasil MasterCard en Brasil HiperCard en Brasil Fondos DineroMail en Brasil Diners en Brasil Boleto bancario en Brasil Transferncia online Banco do Brasil Transferncia online Bradesco

VALORES VARIABLE MEDIOS DE PAGO - Chile


Todos los medios de pago (Default) Visa en Chile ServiPag en Chile Ripley en Chile Presto en Chile MasterCard en Chile Magna en Chile Fondos DineroMail en Chile Diners en Chile American Express en Chile

VALORES VARIABLE MEDIOS DE PAGO - Mxico


Todos los medios de pago (Default) Tarjetas de crdito ScotiaBank ScotiaBank Tansfer Bank ScotiaBank Referenced Deposit

34

mx_santander_td mx_santander_tc mx_santander_tb mx_santander_dr mx_oxxo mx_otherbank_tc mx_ixe_tc mx_ixe_tb mx_ixe_dr mx_hsbc_td mx_hsbc_tb mx_dm mx_banorte_td mx_bancomer_tc mx_bancomer_tb mx_bancomer_dr mx_banamex_td mx_amex mx_7eleven arg mex chl bra dni cuil cuit le lc cpf cnpj rut rfc curp ife lic 1 2 3 4

Tarjetas de dbito Santander Santander Credit Card Santander Tansfer Bank Santander Referenced Deposit OXXO Visa / MasterCard Tarjetas de crdito Ixe Ixe Tansfer Bank Ixe Referenced Deposit Tarjetas de dbito HSBC HSBC Tansfer Bank Fondos DineroMail Tarjetas de dbito Banorte Tarjetas de crdito Bancomer Bancomer Tansfer Bank Bancomer Referenced Deposit Tarjetas de dbito Banamex American Express 7 Eleven

VALORES VARIABLE NACIONALIDADES


Argentina Mexicana Chilena Brasilera

VALORES VARIABLE TIPO DE DOCUMENTO


Argentina Argentina Argentina Argentina Argentina Brasil Brasil Chile Mxico Mxico Mxico Mxico

VALORES VARIABLE PAIS


Argentina Brasil Chile Mxico

35

Anexo 4: Referencias grficas

36

Anexo 5: Glosario
PCI Compliance: Estndar de Seguridad de Datos para la Industria de Tarjeta de Pago. Este estndar ha sido desarrollado por un comit conformado por las compaas de tarjetas (dbito y crdito) ms importante como una gua que ayude a las organizaciones que procesan, almacenan y/o transmiten datos de titulares de tarjeta, a asegurar dichos datos, con el fin de prevenir los fraudes que involucran tarjetas de pago dbito y crdito. Las compaas que procesan, guardan o trasmiten datos de tarjetas deben cumplir con el estndar.

37