Mercado pago guía-de-integración-v4

Copyright © 2009 MercadoPago.com.ar

Herramientas para tu Sitio

MercadoPago.com.ar

Manual de Integración Argentina

http://www.mercadopago.com/mp-argent

Manual de Integración

Copyright © 2009 MercadoPago.com.ar 2

Índice

Introducción .......................................................................................................................................... 3

Capítulo 1 – Tu Logo y Pie de Página ..................................................................................................... 5

Capítulo 2 – Botón estándar "Comprar Ahora"..................................................................................... 7

Capítulo 2.1 – Botón de Compra de Monto Variable .......................................................................... 15

Capítulo 3 – MercadoPago en Redes Sociales..................................................................................... 16

Capítulo 4 – MercadoPago en E-mails ................................................................................................ 25

Capítulo 5 – Código de usuario y código de seguridad ....................................................................... 31

Capítulo 6 – Integración de Carros de Compra ................................................................................... 34

Capítulo 6.1 – Carrito de Compras de MercadoPago .......................................................................... 34

Capítulo 6.2 – Carrito de Compras propio .......................................................................................... 37

Capítulo 6.3 – Carrito de Compras Magento ...................................................................................... 38

Capítulo 6.4 – Carrito de Compras osCommerce ................................................................................ 42

Capítulo 7 – Integración avanzada ...................................................................................................... 44

Capítulo 7.1 – Información relacionada con el estado de pagos ........................................................ 44

Capítulo 7.2 – Herramientas de Comunicación ................................................................................... 45

Mesa de Ayuda .................................................................................................................................... 47




Introducción

1. Historial de revisión del manual

REVISION DATE SUBJECT APPROVAL

8.0 27/Ene/2011 Transducción al español Mar Fernández

2. Resumen ejecutivo

El propósito de este documento es proporcionar una guía técnica para la implementación de

MercadoPago como servicio de plataforma de pagos on-line.

Los términos & condiciones del servicio están disponibles en www.mercadopago.com.ar

3. Recomendaciones de seguridad

Recuerde la contraseña del usuario que registre en MercadoPago es confidencial.

4. Sobre MercadoPago.com

MercadoPago.com es la plataforma de e-pagos más grande de América Latina. Permite cobrar y

pagar a través de internet en manera fácil, rápida y segura.

En operación desde 2004.

Pertenece a MercadoLibre; compañía listada en NASDAQ desde 2007: MELI.

Presencia regional: Argentina, Brasil, Chile, Colombia, México y Venezuela.

En 2009 MercadoPago procesó 3,1 millones de pagos, por un volumen de USD 383

millones. (Fuente: http://investor.mercadolibre.com).

Beneficios que te acerca MercadoPago:


http://www.mercadopago.com.ar/

http://investor.mercadolibre.com/



El dinero de las compras realizadas con Tarjetas de Crédito se acredita on-line en tu cuenta

MercadoPago.

Recibís todo el dinero de tus ventas en un solo pago, aún cuando hayas financiado a tus

clientes.

Recibís pagos del exterior.

Habilitás un canal de pago seguro y fácil de usar.

Tercerizás la gestión de cobro de tus ventas y con esto, el trabajo administrativo de

verificación de pagos y el riesgo de incobrabilidad o contracargos -ver el Programa de

Protección al Comprador-.

Ofrecés múltiples medios de pago como tarjetas de créditos, cupones de pagos o redes de

cajeros automáticos.

Aumentás la conversión a ventas dentro de tu sitio.

Empezás a vender vía mailings promocionales o banners publicitarios. Capturar el impulso

de compra de los clientes, reducción de la entrega.

Accedés a promociones y beneficios exclusivos para la comunidad de usuarios de

MercadoPago.

Tenés acceso a más de 45 millones de usuarios registrados.

Implementás una plataforma de pagos regulada por SOX.




Capítulo 1 – Tu Logo y Pie de Página

Personalizá la página de pagos adjuntando el logo de la compañía y un mensaje en el pie de página.

Con esto lograrás un aspecto más profesional y generarás confianza en tus compradores.

Paso 1

Para configurar el logotipo de la marca y pie de página, iniciá sesión –log in- en

MercadoPago.com.ar y hacé clic en Herramientas para tu Sitio.

Paso 2

Click en el botón “Apariencia del proceso de pagos”

Paso 3

Upload your logo and type the message for the footer. Click in bottom “Guardar”.




Mediante la configuración de estas opciones, podrás mantener tu imagen de marca durante el

proceso de pago tal como se muestra en la imagen de abajo.




Capítulo 2 – Botón estándar "Comprar Ahora"

Insertando el botón "Comprar Ahora" dentro de tu sitio, el comprador accederá directamente al

sitio de MercadoPago para efectuar el pago. Para integrarlo solo deberás seguir 3 pasos:

1. Configurar la información del producto, el diseño del botón y establecer las opciones de envío.

2. Generar el código HTML del botón.

3. Integrar el código HTML en su sitio.

Paso 1

Log in. Para configurar el botón "Comprar Ahora", tenés que iniciar sesión con tu usuario de MercadoPago y luego hacer clic en la pestaña "Herramientas para tu Sitio".

Si no contás con uno, podés registrarte gratuitamente en www.mercadopago.com.ar

Crear un botón. A continuación, hacé clic en "Botones de Compra" dentro de las opciones de

Herramientas Básicas".





Establecé la información específica del producto a pagar en "Datos del Producto". Configurá al

menos los campos mínimos requeridos (*) y, a continuación, hacé clic en "Continuar" como se

indica a continuación:

Tené en cuenta que nombre del producto no admite caracteres especiales (‘, “, <, >) ni debe

exceder los 100 caracteres.

Configurá el diseño del botón dentro de "Configuración del botón".




Podés utilizar uno de los botones que aparecen dentro de "Elige el diseño del botón" haciendo clic

en el diseño que elijas.

También podés cargar tu propio diseño de botón copiando la URL donde se aloja el diseño dentro

de la caja "Diseño propio".

Definí adonde dirigir a los compradores una vez finalizada la compra.

Podés asignar 3 URL’s de destino con el fin de redirigir adecuadamente los clientes después de la

compra.

1. “Pago exitoso” es un pago que se completó en el mismo momento de la compra. Aquí

deberás cargar la URL adonde dirigir a los clientes que hayan completado el proceso de

pago exitosamente.

2. “Pago en proceso” significa que el pago aún no fue completado. El comprador será dirigido

a esta URL en caso de que su pago necesite un proceso adicional de verificación (tarjetas de

crédito) o necesite completarse de forma off-line (cupones como Pago Fácil, Bapro Pago,

Rapi Pago, Link y Banelco).

3. “Pago cancelado” es un pago que se ha rechazado. El comprador será redirigido a esta URL

en caso de que su pago haya sido denegado por cuestiones de seguridad.




También podés agregar un código interno –a elección- para identificar las transacciones

provenientes de ese botón completando campo identificado con el número 4.

Configurar opciones de envío "Preferencias de envío". En este paso, podés establecer las distintas

alternativas de envío que vas a ofrecer a tus clientes.

Aquí, vas a tener 4 alternativas diferentes para configurar el costo de envío.

Porcentaje: El costo de envío se calculará automáticamente sobre el monto total de la compra.

Costo Fijo: Incluye hasta 6 opciones de costos de envío fijos. El comprador podrá elegir al pagar

el artículo.

Permitir que los compradores ingresen el costo de envío: Tus compradores podrán agregar el

monto del costo de envío al pago del artículo.

No incluir costos de envío en los botones de pagos: Tus compradores no podrán agregar

costos de envío en el proceso de pago del artículo.




Una vez que confirmes la opción que mejor se adapte a tus necesidades, se confirmará que el

proceso fue terminado exitosamente

Paso 2

Generar botón código HTML. Una vez que hayas completado el paso 1 hacé clic en "Continuar". De

esta forma vas a generar el código HTML que tiene los detalles del botón configurado.




El código generado por MercadoPago será como este:

<form target= " _top " action= " https://www.mercadopago.com/mla/buybutton " method= " post "> <input type= " image " src= " https://www.mercadopago.com/org-img/MP3/buy_now_02_mla.gif " border= " 0

" alt= " To buy Now "> <input type= " hidden " name= " acc_id " value= " 99999999 "> <input type= " hidden " name= " enc " value= " xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx "> <input type= " hidden " name= " url_succesfull " value= " http://www.seuSite.com/succesfull "> <input type= " hidden " name= " url_process " value= " http:// www.seuSite.com/process "> <input type= " hidden " name= " url_cancel " value= " http:// www.seuSite.com/cancel "> <input type= " hidden " name= " item_id " value= " 12345 "> <input type= " hidden " name= " name " value= " Item name "> <input type= " hidden " name= " currency " value= " ARG "> <input type= " hidden " name= " price " value= " 10.0 "> <input type= " hidden " name= " shipping_cost " value= ""> <input type= " hidden " name= " ship_cost_mode " value= " FS "> <input type= " hidden " name= " op_retira " value= " B "> <input type= " hidden " name= " extra_part " value= ""> <input type= " hidden " name= " cart_name " value= ""> <input type= " hidden " name= " cart_surname " value= ""> <input type= " hidden " name= " cart_email " value= ""> <input type= " hidden " name= " seller_op_id " value= "">

</form>




Los parámetros de este código se detallan en la tabla siguiente:

Parámetro Descripción Tipo Cant. De Caracteres

image URL for a tailor-made image to be used in the button or basket. Alphanumeric 500

reseller_acc_id (*)

Integrator Number Account Numerical 10

acc_id (**)

Seller Number Account Numerical 10

enc (**)

Security Code ID Alphanumeric --

url_succesfull (***)

URL for which the BUYER are redirected for after a successfully payment.

Alphanumeric 500

url_process (***)

URL of the page for which the BUYER will be redirected in case the status of its payment is hanging of approval

Alphanumeric 150

url_cancel (***)

URL of the page for which the BUYER will be redirected in case occurs a payment cancellation

Alphanumeric 500

item_id Seller Product Code. Alphanumeric 200

name Product Name.No special characters allowed (‘, ”, <,>) Alphanumeric 100

currency Currency Code. For Argl it must be “AR”. Alphabetical 5

price Product Price. Alphabetical 14

shipping_cost Shipment Cost. -- --

ship_cost_mode Shipment Mode. -- --

op_retira Option of personal product withdrawal. -- --

extra_part Seller Reference Code (hold any seller extra information) Alphanumeric 600

cart_name BUYER Name Alphabetical 30

cart_surname BUYER Surname Alphabetical 30

cart_email Email Alphanumeric 100

seller_op_id (****)

Seller Reference Code. It must be unique, since it is necessary to define an operation of univocal form

Alphanumeric 100

(*) Si sos integrador y querés ofrecer MercadoPago para tus clientes, por favor,

completá este parámetro con tu propio "acc_id' código.

(**) Los parámetros "acc_id" y "enc" no pueden ser modificados. En caso de que

el código HTML se genere de forma dinámica, estos datos deben incluidos en el

código. Podés obtenerlos directo en el sitio dentro de la pestaña "Herramientas

para tu sitio”>"Datos de tu Carrito" como se indica en la figura de la página 15.

(***)El cumplimiento de estos campos es muy importante para mejorar la

experiencia de los compradores, ya que estos campos proporcionarán las rutas de

acceso y mensajes que ellos van a estar recibiendo.

(****) "seller_op_id" es única y determinada por el vendedor.

Personalizá el código HTML




Podés generar más botones de forma dinámica simplemente modificando los parámetros dentro

del código del botón "Comprar Ahora" que hayas creado. Esto permitirá una mejor integración de

MercadoPago con tu sitio. Por favor, tené en cuenta que los parámetros "acc_id" y "enc" son los

únicos parámetros que no se pueden modificar. Podés encontrar más detalles en la tabla anterior

(*).

El método para procesar una solicitud de pago en MercadoPago es a través de un código HTML que

es generado por el usuario que deberá contar con ciertos parámetros que se detallan a

continuación.

Ejemplo: un vendedor necesita procesar un pago de $10 que corresponde a un producto

con la identificación "12345" y el nombre de " Item name".

Donde los parámetros utilizados en el código se explican en la siguiente tabla:

Parámetro Descripción Tipo Caracteres

image URL de la imagen propia del botón o carrito de la compra. Alfanumérico

500

acc_id (*)

Número de cuenta del vendedor. Numérico 10

enc (*)

Código validador de seguridad. Alfanumérico

--

url_succesfull (**)

URL donde el comprador es redireccionado cuando el pago sea aprobado.

Alfanumérico

500

url_process (**)

URL para redireccionar al comprador com pago en proceso. Alfanumérico

150

url_cancel (**)

URL donde se redirige al comprador a cancelar el pago. Alfanumérico

500

item_id Código del producto. Alfanumérico

200

name Nombre del producto (no admite caracteres especiales ‘, “, <, >) Alfanumérico

100

currency Código de la Moneda. AR Alfabético 5

price Precio del producto. Alfabético 14

shipping_cost Costo de envío. -- --

ship_cost_mode Medio de envío. -- --

<form target="_top" action="https://www.mercadopago.com/mla/buybutton" method="post"> <input type="image" src="https://www.mercadopago.com/org-img/MP3/buy_now_02_mla.gif" border="0"

alt="Comprar Agora"> <input type="hidden" name="acc_id" value="99999999"> <input type="hidden" name="enc" value="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"> <input type="hidden" name="url_succesfull" value="http://www.seuSite.com/succesfull"> <input type="hidden" name="url_process" value="http:// www.seuSite.com/process"> <input type="hidden" name="url_cancel" value="http:// www.seuSite.com/cancel"> <input type="hidden" name="item_id" value="12345"> <input type="hidden" name="name" value="Item name"> <input type="hidden" name="currency" value="ARG"> <input type="hidden" name="price" value="10.0"> <input type="hidden" name="shipping_cost" value=""> <input type="hidden" name="ship_cost_mode" value="FS"> <input type="hidden" name="op_retira" value="B"> <input type="hidden" name="extra_part" value=""> <input type="hidden" name="cart_name" value=""> <input type="hidden" name="cart_surname" value=""> <input type="hidden" name="cart_email" value=""> <input type="hidden" name="seller_op_id" value=""> </form>




op_retira Opción de retirar personalmente. -- --

extra_part Código de Referencia (Ej: Orden de la solicitud del carrito de compra).

Alfanumérico

600

cart_name Nombre del comprador. Alfabético 30

cart_surname Apellido del comprador. Alfabético 30

cart_email E-mail del comprador. Alfanumérico

100

seller_op_id (***)

Número de operación, el mismo es único y permite identificar cada operación.

Alfanumérico

100

Paso 3

Insertar botón código HTML en su sitio Web.

Es realmente fácil. Basta con copiar y pegar el código HTML que se ha obtenido a su sitio.

2.1 Botón de Compra de Monto Variable

Una vez generado el botón de compra, podrás personalizar su código a fin de generar un Botón de

Compra de Monto Variable como el siguiente:

Este botón, te dará la posibilidad de habilitar un campo en donde el comprador podrá completar

con el monto a abonar y efectuar el pago por el monto que ha indicado.

Para armarlo, deberás modificar la variable relacionada al monto del siguiente modo:

Entonces, la variable relacionada a Precio, pasaría de ser:

<input type="hidden" name="price" value="2">

Al siguiente modo:

<input name="price" value="2">




Capítulo 3 – MercadoPago en Redes Sociales

Cómo integrar MercadoPago para recibir pagos a través de Facebook.

Paso 1























Podés asignar tres URL’s de destino con el fin de redirigir adecuadamente los clientes después de la

compra.



pago exitosamente.

















el artículo.










Paso 2

Generar el link para tu botón. Una vez que hayas completado el paso 1 hacé clic en "Continuar". De

esta forma vas a generar el link que tiene los detalles del botón configurado.




Ahora solo queda que lo incluyas en tu Página de Facebook.

Para esto, deberás seguir los siguientes pasos:

Paso 1:

Ingresa en tu página de Facebook y haz clic en la opción “Editar Página”.

Ingresa en la sección “Aplicaciones”. Tendrás que instalar la aplicación que te permite sumar una

pestaña a tu página, con la posibilidad de editar HTML.




Una vez que hagas clic en la opción “Añadir Aplicaciones”, verás que la misma se agrega a tu

listado de Aplicaciones.




Dentro de la sección “Aplicaciones”, dirígete a la aplicación FBML – FBML, y haz clic en la opción “Ir

a la aplicación”.

Esta aplicación te permitirá contar con una nueva pestaña en tu Página de Facebook, en la cual te

permite publicar la plantilla HTML que desees.




Inserta el Código HTML que desees. Dentro del mismo podrás ingresar la imagen de tu botón de

pago junto con el link que redireccione a MercadoPago.




Capítulo 4 – MercadoPago en E-mails

Incluye Botones de Compra en tus e-mails. Para esto deberás seguir los siguientes pasos:

Paso 1























Podés asignar tres URL’s de destino con el fin de redirigir adecuadamente los clientes después de la

compra.



pago exitosamente.

















el artículo.










Paso 2

Generar el link para tu botón. Una vez que hayas completado el paso 1 hacé clic en "Continuar". De

esta forma vas a generar el link que tiene los detalles del botón configurado.




Luego, sólo deberás incluir el link en tu pieza de E-mail como hipervínculo a la imagen del botón

que prefieras.




Capítulo 5 – Código de usuario y código de seguridad

Cómo localizar el código de vendedor y así poder configurar un botón personalizado.

Paso 1

Para localizar el código de vendedor y almacenarlo primero iniciá la sesión en el sitio web de

MercadoPago.

Paso 2

Seleccioná la pestaña "Herramientas para tu sitio" y, a continuación, hacé clic en "Comunicación del

estado de un pago"




A continuación, hacé clic en "Configuración avanzada" que te mostramos debajo:

Allí encontrarás tu ID de cuenta, el código de seguridad y el token:

Otra forma de acceder al ID de cuenta y código de seguridad

Una vez que obtuviste el código HTML de tu botón “Comprar Ahora”, podés guardar la información

brindada por dos parámetros:




Parámetro 1 – ID de cuenta "Número de Cuenta"

<input type= " hidden " name= " acc_id " value= " 2379154 "> El parámetro "acc_id" es el id único de vendedor-usuario en MercadoPago. Incluso cuando el botón

es personalizado, este parámetro siempre seguirá siendo idéntico al número informado en la

cuenta privada de MercadoPago.

Parámetro 2 – Código de Seguridad

<input type= " hidden " name= " enc " value= " xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx “> El parámetro "enc" es el único código de seguridad de vendedor almacenado en MercadoPago.

Incluso cuando el botón es personalizado, este parámetro siempre seguirá siendo idéntico al

número informado en la cuenta de MercadoPago privada.

IMPORTANTE: Tené en cuenta que estos datos son personales y confidenciales. No los compartas

con nadie.




Capítulo 6 – Integración de Carros de Compra

6.1 Carrito de compras de MercadoPago

El Carrito de Compras es una herramienta que permitirá que tus compradores puedan elegir entre

distintos productos, cargarlos en una cesta y pagarlos todos juntos en un solo paso.

Paso 1

Para configurar el botón de “Comprar Ahora”, ingresa en MercadoPago y hacé clic en

“Herramientas para tu sitio”.

Paso 2

Luego, seleccioná “Carrito de MercadoPago” en la sección “Carritos de compra”.




Paso 3

Detallá en cada uno de los campos, la información correspondiente al artículo que querés describir:

Paso 4

En este paso podrás elegir un diseño para tu carrito y configurar el destino al cual vas a dirigir a tus

compradores cuando finalicen el pago.




Paso 5

En “Preferencias de envío”, tendrás que configurar las diferentes opciones de envío para tu

producto:

Paso 6

Generación del Código HTML. Podrás ver que se generaron dos códigos, uno que permite que los

compradores agreguen artículos al carrito; y el otro que permite visualizar el contenido del mismo.

Copialos y agregalos a tus artículos en tu sitio web para poder visualizar los botones.




6.2 Carrito de compras propio

Si ya tenés un sitio web con un carrito de compras, también podrás integrar MercadoPago.

Paso 1

Creá un botón de “Pagar Ahora” siguiendo los pasos ya explicados en el manual. Luego utilizaremos

esta plantilla para tu sitio.

Vas a obtener un código similar al siguiente:

Paso 2

El siguiente paso es implementar en tu sitio la plantilla del botón generada y hacerla funcional para

que permita que tus compradores puedan pagar cualquier compra. Deberás generar un botón de

pago en base al template obtenido y teniendo en cuenta los siguientes parámetros:

<form target="_top" action="https://www.mercadopago.com/mla/buybutton" method="post">

<input type="image" src="https://www.mercadopago.com/org-img/MP3/buy_now.gif" border="0"

alt="">

<input type="hidden" name="acc_id" value="592998">

<input type="hidden" name="url_cancel" value="http://www.mercadopago.com/">

<input type="hidden" name="item_id" value="1234">

<input type="hidden" name="name" value="1234">

<input type="hidden" name="currency" value=“ARG">

<input type="hidden" name="price" value="200.0">

<input type="hidden" name="url_process" value="http://www.mercadopago.com/">

<input type="hidden" name="url_succesfull" value="http://www.mercadolibre.com/">

<input type="hidden" name="shipping_cost" value="">

<input type="hidden" name="enc" value="lgTGvhc1VSaGTJzmRYdHjQIeW68%3D">

<input type="hidden" name="ship_cost_mode" value="">

<input type="hidden" name="op_retira" value="O">

<input type="hidden" name="extra_part" value="CheckOut">

</form>




Parámetro Descripción Tipo

shipping_cost “” (No completar) -

ship_cost_mode “” (No completar) -

op_retira “” (No completar) -

item_id Código del artículo Alfanumérico

name Nombre del artículo Alfanumérico

price Precio del artículo Numérico

extra_part Código de referencia (Ej.: Número de orden de pedido del carrito de

compras)

Alfanumérico

image URL de la imagen propia del botón Alfanumérico

url_succesfull URL donde redireccionar al comprador luego de completar el pago con éxito Alfanumérico

url_process URL donde redireccionar al comprador luego de completar el pago y que este

se encuentre pendiente.

Alfanumérico

url_cancel URL donde redireccionar al comprador luego de cancelar el proceso de pago Alfanumérico

cart_name Nombre del comprador Alfabético.

cart_surname Apellido del comprador Alfabético.

cart_email E-mail del comprador Alfanumérico.

acc_id* Nro. de cuenta del vendedor. Numérico

enc* Código validador de seguridad Alfanumérico

currency* Código de moneda Alfabético

De esta forma sólo resta que tu carrito de compras muestre el botón de “Pagar Ahora” generado y

la integración está lista.

6.3 Carrito de compras Magento

Integrando MercadoPago en tu carrito de compras de Magento (*), podrás aumentar la calidad del

proceso de pago y mejorar tu sistema de venta.

Paso 1

Para configurar el Botón “Comprar Ahora”, ingresá en MercadoPago y hacé clic en “Herramientas

para tu sitio”.

Paso 2

Luego, hacé clic en la opción “Magento” en la sección “Carritos de compra”.

El módulo de MercadoPago está diseñado para funcionar correctamente con la

versión 1.4.0.1 de Magento




Paso 3

Luego podrás realizar la instalación de MercadoPago en tu carrito de compras de Magento:

Descargá el archivo mercadopago.zip

Extraé los archivos en tu computadora,

manteniendo la estructura de los

directorios.

Copiá la carpeta MercadoPago a la

carpeta de instalación app de tu tienda

Magento. Ejemplo: Magento->app-

>code->community.

Cortá y pegá el archivo de

configuración con el nombre

MercadoPago.xml que encontrarás

dentro de la carpeta MercadoPago.

Quedará en la carpeta de tu tienda

Magento: Magento->app->code->etc-

>modules.




Ingresá al Administrador de Magento para configurar MercadoPago como uno de los métodos

de pago de tu tienda: System->Configuration->Payment Methods.




Configura los parámetros de tu cuenta de MercadoPago:

Podrás encontrar los datos de configuración de tu cuenta ingresando en:

https://www.mercadopago.com/mla/cartdata. En esta sección encontrarás tu Número de Cuenta y

el Código Validador de Seguridad (Código Validador).

También podrás encontrar estos mismos datos generando un Código HTML de un botón “Comprar

Ahora” ingresando en https://www.mercadopago.com/mla/homeTools, y utilizando los datos de

configuración de tu botón, del siguiente modo:

Número de Cuenta.

La encontrarás bajo el código “acc_id” el cual se obtiene de la generación del botón de

pago.

Código Validador

Corresponde al código “enc” el cual se obtiene de la generación del botón de pago.

URL de Pago Pendiente.

Es la URL a la cual MercadoPago redirecciona a tus clientes luego de que realicen un pago

en proceso -pendiente de acreditación-.

URL de Pago Exitoso.

Es la URL a la cual MercadoPago redirecciona a tus clientes luego de que realicen un pago el

cual ha sido aprobado.




Completado este proceso, tus compradores ya podrán pagar utilizando MecadoPago.

6.4 Carrito de compras osCommerce

Integrar MercadoPago a osCommerce es muy simple. Seguí estos pasos y ofrecé a tus compradores

un medio de pago fácil, simple y seguro.

Paso 1

Descargá mercadopago.zip

Paso 2

Extraé los dos archivos a tu computadora manteniendo la estructura de directorios:

Paso 3

Copia cada archivo al mismo directorio dentro del hosting donde está instalado osCommerce.

Paso 4

Ingresá al administrador de osCommerce y dirigite al Módulo de Pagos. Seleccioná MercadoPago y

hacé clic en instalar.

> ##DISCO LOCAL##\includes\languages\espanol\modules\payment\mercadopago.php > ##DISCO LOCAL##\includes\modules\payment\mercadopago.php

<form target="_top" action="https://www.mercadopago.com/mla/buybutton" method="post">

<input type="image" src="http://fdf" border="0" alt="Comprar Agora">

<input type="hidden" name="acc_id" value="5865960">

<input type="hidden" name="url_cancel" value="http://www.myurl.com.br">

<input type="hidden" name="item_id" value="fdf">

<input type="hidden"name="enc" value="W1gd8zSVA96%0B0qPwBEc%2FRLQWFo%3D">

<input type="hidden" name="name" value="dfdf">

<input type="hidden" name="reseller_acc_id" value="">

<input type="hidden" name="currency" value="REA">

<input type="hidden" name="price" value="4545.0">

<input type="hidden" name="url_process" value="http://www.myurl.com.br">

<input type="hidden" name="url_succesfull" value="http://www.myurl.com.br">

<input type="hidden" name="shipping_cost" value="">

<input type="hidden" name="ship_cost_mode" value="">

<input type="hidden" name="op_retira" value=" ">

<input type="hidden" name="extra_part" value="4321">

<input type="hidden" name="cart_name" value="">

<input type="hidden" name="cart_surname" value="">

<input type="hidden" name="cart_email" value="">

<input type="hidden" name="cart_doc_nbr" value="">

</form>


http://www.mercadopago.com/org-img/MP3/oscommerce/mercadopago_MLA.zip



Paso 5

Configura los 2 parámetros. Para ello, obtené los datos en Configuración Avanzada.

Completado este proceso, tus compradores podrán pagarte utilizando MercadoPago.


https://www.mercadopago.com/mla/cartdata



Capítulo 7 – Integración avanzada

Como se indica en el capítulo 2, es posible personalizar el código HTML para lograr una mejor

integración de MercadoPago a tu sitio Web. Esta sección te mostrará cómo obtener un código

dinámico y cómo MercadoPago informa el estado de un pago.

7.1 Información relacionada con el Estado de Pagos

MercadoPago ofrece tres alternativas para comunicar el estado de un pago:

Comunicación Online,

Comunicación Off-line,

Respuesta “On-demand”– mediante un Web Service llamado IPN-.

Entrando a "Herramientas para tu Sitio" y, a continuación, haciendo clic en "Comunicación del

estado de los pagos" vas a encontrar información detallada acerca de las 3 posibilidades de

comunicación de estado de un pago:

Una vez allí, hacé clic en "Configuración avanzada" y encontrarás un número de token que se

denomina "Clave de Sonda". Esa contraseña confidencial te servirá para ejecutar consultas en línea

a MercadoPago.

También encontrarás dos campos para completar con direcciones dos URL, uno para las

comunicaciones en línea y la otra para comunicaciones fuera de línea. MercadoPago utilizará estas

direcciones URL para informar el estado de los pagos utilizando el método POST.

Podés comprobar tu token –Clave de Sonda- y establecer las direcciones URL de comunicación

como aparece en la imagen:




Figure 1: sonda_key and online / off-line answer URLs.

Las 3 formas de comunicación devuelven los siguientes datos relacionados a un pago:

Parámetro Descripción Tipo Cant de Caracteres

seller_op_id Código Único de Identificación del vendedor para una transacción Alphanumeric 100

mp_op_id Código único de referencia de de MercadoPago para la identificación de una transacción

Numerical 10

acc_id Número de cuenta del vendedor Numerical 10

status Status de un pago (A: Approved; P: Pending of Analysis and C: Cancelled or Refused)

Alphabetical --

item_id Código de Producto o Servicio configurado x el vendedor Alphanumeric 200

name Descripción de Producto o Servicio configurado x el vendedor Alphanumeric 100

price Precio de Producto o Servicio configurado x el vendedor Numerical 14

shipping_ amount Costo de envío del producto. Numerical --

total_amount Costo Total pagado x el comprador. Numerical --

extra_part Info adicional disponible para el vendedor Alphanumeric 600

payment_method Método de pago utilizado x el comprador CC: Credit Card, BTR: Bank Transfer and BTI: Bank Tickets.

Alphanumeric --

7.2 Herramientas de Comunicación

Comunicación Online

Las comunicaciones en línea se liberan automáticamente cada vez que se ha completado un

proceso de pago. Esta comunicación se realiza a través de un pedido POST que devuelve al

vendedor el estado de final de un pago -aprobado, rechazado o en-proceso-. Esta herramienta de

comunicación requiere del enlace URL en línea registrado bajo el nombre de "estado de los pagos",

como vimos en la figura 1, sección 5.1. Si durante el envío del POST falla la comunicación, nuestro

sistema de back-end registra el fracaso y reenvía el mensaje tan pronto como se restauran las

comunicaciones.




Comunicación Off-line

Las comunicaciones fuera de línea se utilizan cuando un pago "en-proceso " finalmente se convierte

en un pago Acreditado o Rechazado. Estas comunicaciones también se utilizan cuando un pago no

pudo ser notificado en línea. MercadoPago comunicará este pago vía POST utilizando la dirección

URL que se presentó en la figura 1, sección 5.1.

Comunicación vía Web Service -IPN-

El Servicio Web IPN proporciona información sobre el estado de un pago cuando lo requieras. Para

invocar el servicio Web es necesario enviar un conjunto de datos –propios del vendedor- tal como

se muestra a continuación:

<form target= " _top " action= " https://www.mercadopago.com/mla/sonda " method= " post "> <input type= " image " src= " https://www.mercadopago.com/org-img/MP3/buy_now.gif " border= " 0 " alt= " To buy Now "> <input type= " hidden " name= " mp_op_id " value= " 12345678 "> <input type= " hidden " name= " seller_op_id " value= " ID12345 "> <input type= " hidden " name= " acc_id " value= " 99999999 "> <input type= " hidden " name= " sonda_key " value= " xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx “>

</form>

Donde cada parámetro se define como:

Parámetro Descripción Tipo Cant. de Caracteres

seller_op_id Código Único de Identificación del vendedor para una transacción Alphanumeric 100

mp_op_id Código único de referencia de de MercadoPago para la identificación de una transacción

Numerical 10

acc_id Número de cuenta del vendedor Numerical 10

sonda_key Código de Seguridad para consultas vía Web Service Alphanumeric --

Los parámetros mp_op_id y seller_op_id no pueden ser nulos, y, por otra parte, el sonda_key y

número de cuenta del vendedor acc_id son campos que no pueden estar vacíos.

Este servicio Web devuelve un conjunto de datos XML donde se describe la información propia de

un pago y además muestra el estado del proceso de comunicación ("mensaje") con sus posibles

valores ("OK" o “error”), como se muestra en los ejemplos siguientes:

Ejemplo de Pago “en proceso” XML <xml version= " 1,0 " encoding= " ISO-8859-1 "?> <result> <message>OK</message> <operation> <seller_op_id>ID12345</seller_op_id> <mp_op_id>12345678</mp_op_id> <acc_id>99999999</acc_id> <status>P</status> <item_id>A1234</item_id> <name>My Product</name> <price>199.0</price>

<shipping_amount>21</shipping_amount >

< additional_amount >0</additional_amount >

< total_amount>220</total_amount>

<extra_part>< /extra_part>




<payment_method>BTI</payment_method> </operation> </result>

Ejemplo de pago “acreditado” XML:

<xml version= " 1,0 " encoding= " ISO-8859-1 "?> <result> <message>OK</message> <operation> <seller_op_id>ID12345</seller_op_id> <mp_op_id>12345678</mp_op_id> <acc_id>99999999</acc_id> <status>[[A]]</status> <item_id>A1234</item_id> <name>My Product</name> <price>199.0</price> <shipping_amount>21</shipping_amount >



<extra_part>< /extra_part> <payment_method>CC</payment_method> </operation> </result>

Ejemplo de pago “Rechazado” XML:

<xml version= " 1,0 " encoding= " ISO-8859-1 "?> <result> <message>OK</message> <operation> <seller_op_id>ID12345</seller_op_id> <mp_op_id>12345678</mp_op_id> <acc_id>99999999</acc_id> <status>C</status> <item_id>A1234</item_id> <name>My Product</name> <price>199.0</price> <shipping_amount>21</shipping_amount >



<extra_part>< /extra_part> <payment_method>BTR</payment_method> </operation> </result>

¿Necesitás ayuda? Escribinos a [email protected]

¡Bienvenido a la plataforma de pagos por internet más grande de América Latina!


mailto:[email protected]

Documents

Mercado pago guía-de-integración-v4