Integracion_es.pdf

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


Ejemplo online ................................................................................................... 22

One Click to Buy para Tarjeta de Crdito........................................................................ 23

Flujo de Compra................................................................................................. 23

Ejemplo de integracin ...................................................................................... 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

1

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

2

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.

3

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.

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:

4

- 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 [email protected].

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

5

.

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

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

1 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.

6

.

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

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

VARIABLES DEL VENDEDOR LONGITUD OBLIGATORIO VALORES DESCRIPCIN

NombreItem SI Nombre o descripcin del producto o servicio. El signo "+" reemplaza al espacio. Por ejemplo, para escribir "Televisor 14 pulgadas" ingresa "Televisor+14+pulgadas".

Tipo Moneda SI 1 2

Moneda local. Dlares.

PrecioItem SI 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.

NroItem NO 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 "-".

MediosPago NO 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).

2 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.

7

image_url 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.

DireccionExito NO 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".

DireccionFracaso NO 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".

DireccionEnvio NO 1

0

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.

Mensaje NO 1

0

Si deseas que el comprador pueda enviar un mensaje. Si deseas que el comprador no pueda enviar un mensaje.

Comercio SI Nmero de la cuenta DineroMail del comercio o vendedor (sin la barra ni el dgito final).

Carrito NO Ttulo (arriba a la izquierda del explorador) que tendr la pgina del Carrito de compras.

img src NO 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.

trx_id 20 NO 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.

8

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:





- 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.

9

- 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.

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


oText.value = aDec[0] + '.00';

}

if(aDec[1].length >= 2) {

oText.value = aDec[0] + '.' + aDec[1].substr(0,2);

}

else

{

}

}

}

oText.value = aDec + '.00';



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.

Pague en forma segura a travs de

DineroMail

11

}

else

{

}

}

oText.value = aDec + '.00';



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 [email protected].

Para generar el link seguro se deber generar el hash teniendo en cuenta las dos variables descriptas en este cuadro:

VARIABLES DEL COMPRADOR LONGITUD DESCRIPCIN

PARAMETROS OBLIGATORIOS PARA FUNCIONALIDAD SECURE LINK merchant 100 Secure Merchant asignado por DineroMail.

hash 50 Resumen que garantiza la integridad de los valores de los parmetros transmitidos.

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 -> Ejemplo+DVD

buyer_name -> Juan+L.

buyer_email -> 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.

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_currency_1=ars&item_name_1=Order&item_quantity_1=2&merchant=E02DCF4A-2C92-4A5F-8C33-8B4CC56A2FE6&payment_method_available=all&transaction_id=494489441&hash=d58a5a5e4b2ea72a6b46983c93be3d5f

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 [email protected].

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


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

Las variables que figuran en el ejemplo como 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.




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/[email protected]&country_id=1&payment_method_available=all&item_name_1=Ejemplo+DVD&item_quantity_1=1&item_ammount_1=12050&payment_method_1=ar_pagofacil&buyer_name=Demo&buyer_lastname=Test&buyer_sex=m&buyer_document_type=dni&buyer_document_number=12345678&buyer_phone=12345678&[email protected]&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 [email protected].


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 el formulario de tarjeta de crdito para realizar un pago.

Las variables que figuran en el ejemplo como deben completarse dinmicamente. Observacin importante: las dimensiones del tag 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.



VARIABLE LONGITUD VALORES DESCRIPCIN

PARAMETROS OBLIGATORIOS PARA FUNCIONALIDAD IFRAME merchant 100 - 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.

buyer_name 50 Nombre del comprador.

buyer_lastname 50 Apellido del comprador.

20

Mi sitio web

buyer_email 150 Email del comprador. payment_method_1 Ver medios

de pago habilitados para iframe

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.

Checkout_views 20 Iframe Indica la vista a utilizar.

VARIABLE LONGITUD DESCRIPCIN

PARAMETROS OPCIONALES PARA FUNCIONALIDAD IFRAME iframe_background_color 6 Color de fondo del Iframe (ej: FFFFFF).

iframe_font_color 6 Color de la fuente (ej: 000000).

iframe_font_name 50 Nombre de la fuente HTML (ej Times New Roman).

iframe_font_size 4 Tamao de la fuente (ej: 12px). iframe_font_weight 10 Grosor de la fuente (ej: bold).

iframe_font_link_color 6 Color de fuente de los vinculos (ej: FF0000).

iframe_input_border_color 6 Color de borde de las cajas de texto (ej: 000000).

iframe_input_background_color 6 Color de fondo de las cajas de texto (ej: FFFFFF).

iframe_input_font_color 6 Color de fuente de las cajas de texto (ej: FF0000).

iframe_button_border_color 6 Color de borde de los botones (ej: 000000).

iframe_button_font_size 4 Tamao de fuente de los botones (ej 14px).

iframe_button_font_name 50 Nombre de la fuente HTML de los botones (ej: Verdana).

iframe_button_font_weight 10 Grosor de fuente de los botones (ej: bold).

iframe_button_background_color 6 Color de fondo de los botones (ej: FF0000).

21


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 .

https://checkout.dineromail.com/CheckOut?buyer_document_number=12345678&buyer_document_type=dni&[email protected]&buyer_lastname=Test&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_method_available=all&checkout_views=iframe&payment_method_1=ar_visa,1&iframe_background_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 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


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.

Mi sitio web


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 .

https://checkout.dineromail.com/CheckOut?buyer_document_number=12345678&buyer_document_type=dni&[email protected]&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&[email protected]&payment_method_1=ar_visa,1&payment_method_available=all

24

F F

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 pago3 :

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




26

Anexo 2: Tabla explicativa de parmetros

REF. GRFICA VARIABLES LONGITUD OBLIGATORIO VALORES DESCRIPCIN

VARIABLES DEL VENDEDOR 1 tool 8 NO button

cart Identifica un Botn de pago. Identifica un Carrito de compras.

2 merchant 100 SI 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.

3 country_id 2 SI Anexo 3 Pas donde opera el vendedor (merchant).

4 seller_name 50 NO Nombre del vendedor o leyenda que el vendedor quiere mostrar en lugar de su email.

5 language 2 NO es

pt

en

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).

6 transaction_id 20 NO Cdigo de transaccin del vendedor. Sirve para utilizar el sistema de consulta IPN2.

7 currency 3 NO ars mxn clp usd brl

Moneda de Argentina. Moneda de Mxico. Moneda de Chile. Moneda de Estados Unidos. Moneda de Brasil.

8 ok_url 255 NO URL donde se redirecciona al comprador en caso de transaccin exitosa.

9 error_url 255 NO URL donde se redirecciona al comprador en caso de transaccin errnea.

10 pending_url 255 NO URL donde se redirecciona al comprador en caso de transaccin pendiente.

11 url_redirect_enable d

1 NO 1 0

Permite redireccionar automticamente a la url seteada en ok_url, error_url o pending_url. Requiere utilizar una de estas.

12 buyer_message 1 NO 0

1

Permite o no al comprador ingresar un mensaje para el vendedor. Default.

27

13 change_quantity 1 NO 0

1

No permite modificar la cantidad de los tems de compra. Permite modificar la cantidad de los tems de compra. Default.

VARIABLES DE MEDIOS DE PAGO 14 payment_method_

available SI Anexo 3 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).

15 payment_method_ 1

NO Anexo 3 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= .

VARIABLES DE PRODUCTO/ITEM 16 item_name_x 150 SI 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.

17 item_code_x 20 NO 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.

18 item_quantity_x 4 SI Nmero entero

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.

19 item_ammount_x 19 SI Los ltimos

dos dgitos son

decimales

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.

28

20 item_currency_x 3 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.

VARIABLES DEL ENVIO 21 shipping_type_x 2 NO 0

1

2

3

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.

22 shipping_cost_1_x 19 NO Los ltimos

dos dgitos son

decimales.

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.

23 shipping_cost_2_x 19 NO Los ltimos

dos dgitos son

decimales.

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

29

casos de haber ms de un tem de venta. La secuencia numrica se inicia en 1. Ejemplo: shipping_cost_2_1.

24 weight_x 2 NO kg

lb

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.

25 item_weight_x 7 NO Los ltimos

tres dgitos son

decimales

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.

26 shipping_currency 3 NO ars

mxn

clp

usd

brl

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).

VARIABLES DEL COMPRADOR 27 buyer_name 50 NO Nombre del comprador. 28 buyer_lastname 50 NO Apellido del comprador.

29 buyer_sex 1 NO m Masculino.

f Femenino

30 buyer_nacionality 3 NO Anexo 3 Nacionalidad del comprador.

31 buyer_document_t ype

2 NO Anexo 3 Tipo de documento del comprador.

32 buyer_document_n umber

50 NO Nmero de documento del comprador.

33 buyer_email 100 NO Email del comprador. 34 buyer_phone 20 NO Nmero de telfono del comprador. 35 buyer_phone_exte

nsion 5 NO Interno del comprador.

36 buyer_zip_code 10 NO Cdigo postal del comprador.

30

37 buyer_street 50 NO Calle del comprador utilizada para el envo.

38 buyer_number 10 NO Nmero del comprador utilizada para el envo.

39 buyer_complement 20 NO Complemento del comprador utilizada para el envo.

40 buyer_city 50 NO Ciudad del comprador utilizada para el envo.

41 buyer_state 50 NO Provincia del comprador utilizada para el envo.

42 buyer_country 3 NO Anexo 3 Pas del comprador utilizada para el envo.

VARIABLES DEL ADICIONALES 43 additional_fixed_ch

arge 19 NO Los

ltimos dos dgitos

son decimales.

Permite al comprador modificar el importe de la compra con un monto fijo. Acepta valores negativos.

44 additional_fixed_ch arge_currency

3 NO ars

mxn

clp

usd

brl

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).

45 additional_variable _charge

5 NO Los ltimos

dos dgitos son

decimales.

Permite al comprador modificar el importe de la compra con un porcentaje de la misma.

46 additional_var_des cription_x

50 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.

47 additional_var_valu e_x

50 NO 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.

48 additional_var_visi ble_x

1 NO 0 Oculta a additional_var_description_x y a additional_var_value_x.

31

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.

49 additional_var_req uired _x

1 NO 0

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.

VARIABLES DE DISEO 50 header_image 255 NO 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.

51 header_width 1 NO 1

2

Indica que la imagen ocupa slo el margen superior izquierdo del header. Default. Indica que la imagen ocupa todo el header.

52 expanded_step_ PM

1 NO 0

1

Muestra el paso de medios de pago contrado. Default. Muestra el paso de medios de pago desplegado.

53 expanded_step_ AD

1 NO 0

1

Muestra el paso de variables adicionales contrado. Default. Muestra el paso de variables adicionales desplegado.

54 expanded_step_ SC 1 NO 0 1

Muestra el paso de envo contrado. Muestra el paso de envo desplegado. Default.

55 expanded_sale_det ail

1 NO 0

1

Muestra el detalle de costos contrado. Muestra el detalle de costos desplegado. Default.

56 step_color 7 NO Color del fondo de PASOS inactivos y fondo del ttulo del detalle.

57 hover_step_color 7 NO Color del fondo de PASO activo (en estado hover).

58 links_color 7 NO Color de los links, total, subtotal de descuento y flechas de ttulos.

32

59 font_color 7 NO Color de fuente de la pgina. 60 border_color 7 NO Color de bordes de tablas y botones. 61 button_color 7 NO Color del fondo de los botones. 62 display_shipping 1 NO 0

1

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.

63 display_additional_ charge

1 NO 0

1

2

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.

64 image NO Puedes elegir la imagen del botn de pago indicando la URL en donde se encuentra alojada.

65 summary_visible 1 NO 1 0

Puedes ocultar el detalle de la compra (tems, cargos adicionales, precios) en todo el proceso.

66 header_visible 1 NO 1 0

Puedes ocultar el encabezado en todo el proceso de compra.

33

Anexo 3: Variables de Medios de Pago

VALOR COMENTARIO

VALORES VARIABLE MEDIOS DE PAGO - Argentina all Todos los medios de pago (Default) ar_amex American Express en Argentina ar_argencard ArgenCard Argentina ar_banktransfer Transferencia bancaria en Argentina ar_bapropago Bapropago en Argentina ar_cabal Cabal en Argentina ar_cobroexpress CobroExpress en Argentina ar_dm Fondos DineroMail en Argentina ar_italcred Italcred en Argentina ar_master MasterCard en Argentina ar_pagofacil Pago Fcil en Argentina ar_rapipago Rapipago en Argentina ar_tnaranja Tarjeta Naranja en Argentina ar_tshopping Tarjeta Shopping en Argentina ar_visa Visa en Argentina ar_ripsa Ripsa en Argentina

VALORES VARIABLE MEDIOS DE PAGO - Brasil all Todos los medios de pago (Default) br_amex American Express en Brasil br_aura Aura en Brasil br_visa Visa en Brasil br_oipaggo OiPaggo en Brasil br_master MasterCard en Brasil br_hipercard HiperCard en Brasil br_dm Fondos DineroMail en Brasil br_diners Diners en Brasil br_bbancario Boleto bancario en Brasil br_bco_brasil_dd Transferncia online Banco do Brasil br_bco_bradesco_dd Transferncia online Bradesco

VALORES VARIABLE MEDIOS DE PAGO - Chile all Todos los medios de pago (Default) cl_visa Visa en Chile cl_servipag ServiPag en Chile cl_ripley Ripley en Chile cl_presto Presto en Chile cl_master MasterCard en Chile cl_magna Magna en Chile cl_dm Fondos DineroMail en Chile cl_diners Diners en Chile cl_amex American Express en Chile

VALORES VARIABLE MEDIOS DE PAGO - Mxico all Todos los medios de pago (Default)

mx_scotiabank_tc Tarjetas de crdito ScotiaBank mx_scotiabank_tb ScotiaBank Tansfer Bank mx_scotiabank_dr ScotiaBank Referenced Deposit

34

mx_santander_td Tarjetas de dbito Santander mx_santander_tc Santander Credit Card mx_santander_tb Santander Tansfer Bank mx_santander_dr Santander Referenced Deposit mx_oxxo OXXO mx_otherbank_tc Visa / MasterCard mx_ixe_tc Tarjetas de crdito Ixe

mx_ixe_tb Ixe Tansfer Bank mx_ixe_dr Ixe Referenced Deposit mx_hsbc_td Tarjetas de dbito HSBC mx_hsbc_tb HSBC Tansfer Bank mx_dm Fondos DineroMail mx_banorte_td Tarjetas de dbito Banorte mx_bancomer_tc Tarjetas de crdito Bancomer mx_bancomer_tb Bancomer Tansfer Bank mx_bancomer_dr Bancomer Referenced Deposit mx_banamex_td Tarjetas de dbito Banamex mx_amex American Express mx_7eleven 7 Eleven

VALORES VARIABLE NACIONALIDADES arg Argentina mex Mexicana chl Chilena bra Brasilera

VALORES VARIABLE TIPO DE DOCUMENTO dni Argentina cuil Argentina cuit Argentina le Argentina lc Argentina cpf Brasil

cnpj Brasil rut Chile rfc Mxico curp Mxico ife Mxico

lic Mxico

VALORES VARIABLE PAIS 1 Argentina 2 Brasil 3 Chile 4 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

Date post:	28-Oct-2015
Category:	Documents
Upload:	marina-schulzinger
View:	58 times
Download:	0 times

Integracion_es.pdf

Documents