Académique Documents
Professionnel Documents
Culture Documents
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
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 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.
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.
<a href="#" onclick="window.open('https://argentina.dineromail.com/Carrito/cart.asp?NombreItem=Impresora&am p;TipoMoneda=1&PrecioItem=450%2E00&NroItem=%2D&image_url=https://argentina.d ineromail.com/imagenes/LogosVendedores/1466897.jpg &DireccionExito=http://www.ok.com&DireccionFracaso=http://www.error.com&Direccio nEnvio=1&Mensaje=1&MediosPago=4%2C5%2C6%2C14%2C15%2C16%2C17%2C18%2C2%2C 7&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.
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).
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.
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.
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
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
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.
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
<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>
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.
16
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.
Ejemplo online
Desde esta URL puede accederse al checkout al que sera redirigido el usuario desde el botn generado en el ejemplo anterior.
18
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
buyer_name buyer_lastname
50 50
20
buyer_email payment_method_1
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).
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
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
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>
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
<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
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
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.
3 4
country_id seller_name
2 50
SI NO
Anexo 3
language
NO
es pt en
transaction_id
20
NO
currency
NO
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.
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
28
20
item_currency_x
NO
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
22
shipping_cost_1_x
19
NO
23
shipping_cost_2_x
19
NO
29
24
weight_x
NO
kg lb
25
item_weight_x
NO
26
shipping_currency
NO
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.
30
37 38 39 40 41 42
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.
44
additional_fixed_ch arge_currency
NO
45
additional_variable _charge
NO
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
55
expanded_sale_det ail
NO
32
59 60 61 62
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
COMENTARIO
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
35
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