Guía de Integración 2015 - Botón en tu Sitio vía API

Guía de
Integración
2015
Guía de Integración
Te damos la bienvenida al mundo de MercadoPago. En estas páginas encontrarás una serie de tareas
que deberás completar para comenzar a operar correctamente con nosotros. El objetivo es asegurarte el
funcionamiento óptimo de la plataforma de pagos, tanto para vos como para tus compradores.
Ver Guía de integración para cobro de Pagos Regulares
Ver Guía de integración para cobro de Pagos Recurrentes
Ver Guía de integración para cobro por modelo Marketplace
Guía de Integración
Botón de pago en tu sitio para cobro de Pagos Regulares
1
Ingresá a nuestro sitio para desarrolladores
Allí encontrarás toda la documentación técnica necesaria para ejecutar la integración:
Te ofrecemos SDKs en los 6 lenguajes de programación de mayor demanda en el mercado como la
alternativa más práctica para integrar.
También encontrarás un módulo con documentación sobre las diferentes APIs disponibles.
Si tu sitio web está desarrollado en las plataformas de e-commerce más usadas, también te ofrecemos
5 módulos prediseñados.
2
Obtené las credenciales de tu cuenta (client_id y client_secret) y autenticate
3
Completá todos los atributos de la preferencia de pago (Ver glosario de atributos ).
De esta forma, en caso que corresponda, podremos incluirte en nuestro Programa de Protección al Vendedor, mantener los
riesgos de fraude bajo control y asegurar los mejores índices de aprobación de pagos.
4
Idealmente utilizá el modo de apertura “redirect” para desplegar el Checkout. Si quisieras utilizar alguna otra modalidad de
Checkout (lightbox, iframe) recomendamos que hagas pruebas de performance (A/B testing) y elijas la modalidad que mejor
convierta. Nuestra experiencia muestra que esta modalidad tradicional “redirect” es la que mejor convierte en la mayoría de
los sitios web de distintas industrias.
5
Cargá el logo de tu empresa en el Checkout.
MercadoPago | Kit de integración | 2
6
Al finalizar el pago, redirigí a una página de felicitación por la compra. También sería bueno que aproveches este momento
para realizar cross-selling. Ofrecele a tu cliente productos relacionados a su última compra y maximizá tus ingresos.
7
Sincronizá tu sistema de administración de cobros en tiempo real para recibir notificaciones instantáneas de los pagos con
nuestro servicio de mensajes IPN 2.0.
8
Por temas legales-regulatorios de los Bancos Centrales y medios de pago habilitados en cada país, estás obligado a
mostrar correctamente los medios de pago y promociones disponibles en el sitio a través de MercadoPago.
En la home page
Los logos de medios de pago o bancos siempre deben mostrarse como parte de la oferta de MercadoPago y no en
forma independiente. Debemos asegurar que el comprador entienda que MercadoPago es el responsable de la
relación con cada medio de pago. Utilizá el banner oficial.
En la selección del medio de pago
La opción de pagar con MercadoPago debe aparecer a través del banner oficial y no redactado en texto. Al igual que
en la Home Page, los medios de pago disponibles deben quedar claramente relacionados con el logo de
MercadoPago. En caso de que cuentes con más de un proveedor de soluciones pagos, deberás posicionar a
MercadoPago en la primera o segunda posición para optimizar la visualización y conversión.
Además el comprador debe contar con la información actualizada de promociones y condiciones legales relacionadas.
Para brindar esta información debés habilitar la landing de promociones oficial de MercadoPago desde tu sitio.
MercadoPago se encarga de actualizar diariamente las promociones vigentes, con los costos de financiación y CFT
correspondiente para cada caso. En ningún caso, pueden recortarse las condiciones, o utilizar landings propias ya que
usualmente muestran errores o desactualizaciones en las condiciones de la promociones.
9
Prueba tu integración utilizando el ambiente Sandbox.
10
Al finalizar la integración usa este checklist de correcta integración para confirmar:
ITEM
HOME PAGE
Comunicación de medios de pago
DETALLE DE LA OFERTA
Comunicación de medios de pago
Uso de banners de MercadoPago para la selección
SELECCIÓN DEL MEDIO DE PAGO
Acceso a la Landing de Promociones
MercadoPago en la primera o segunda posición
Enviar descripción, foto y categoría del producto
PREFERENCIA DE PAGO
Enviar mail del comprador
Enviar datos del envío
Enviar URL de retorno a tu plataforma
Modo de apertura “Redirect”
CHECKOUT MERCADOPAGO
Incluir logo de la empresa
MercadoPago | Kit de integración | 3
SI
NO
¡Recordá! Si tu integración no cumple con todos los puntos del checklist, tu usuario podría ser inhabilitado. Si tenés dudas sobre
los puntos anteriores, te recomendamos, contactarnos antes de salir en producción. De esta forma aseguramos la mejor experiencia para vos y tus clientes.
Muchas gracias.
Guía de Integración
Botón de pago en tu sitio para cobro de Pagos Recurrentes
1
Ingresá a nuestro sitio para desarrolladores
Allí encontrarás toda la documentación técnica necesaria para ejecutar la integración:
Te ofrecemos SDKs en los 6 lenguajes de programación de mayor demanda en el mercado como la
alternativa más práctica para integrar.
También encontrarás un módulo con documentación sobre las diferentes APIs disponibles.
Si tu sitio web está desarrollado en las plataformas de e-commerce más usadas, también te ofrecemos
5 módulos prediseñados.
2
Obtené las credenciales de tu cuenta (client_id y client_secret) y autenticate
3
Completá todos los atributos de la preferencia de pago (Ver glosario de atributos ).
De esta forma, en caso que corresponda, podremos incluirte en nuestro Programa de Protección al Vendedor, mantener los
riesgos de fraude bajo control y asegurar los mejores índices de aprobación de pagos.
4
Idealmente utilizá el modo de apertura “redirect” para desplegar el Checkout. Si quisieras utilizar alguna otra modalidad de
Checkout (lightbox, iframe) recomendamos que hagas pruebas de performance (A/B testing) y elijas la modalidad que mejor
convierta. Nuestra experiencia muestra que esta modalidad tradicional “redirect” es la que mejor convierte en la mayoría de
los sitios web de distintas industrias.
5
Cargá el logo de tu empresa en el Checkout.
6
Al finalizar el pago, redirigí a una página de felicitación por la compra. También sería bueno que aproveches este momento
para realizar cross-selling. Ofrecele a tu cliente productos relacionados a su última compra y maximizá tus ingresos.
7
Sincronizá tu sistema de administración de cobros en tiempo real para recibir notificaciones instantáneas de los pagos con
nuestro servicio de mensajes IPN 2.0.
MercadoPago | Kit de integración | 4
8
Por temas legales-regulatorios de los Bancos Centrales y medios de pago habilitados en cada país, estás obligado a
mostrar correctamente los medios de pago y promociones disponibles en el sitio a través de MercadoPago.
En la home page
Los logos de medios de pago o bancos siempre deben mostrarse como parte de la oferta de MercadoPago y no en
forma independiente. Debemos asegurar que el comprador entienda que MercadoPago es el responsable de la
relación con cada medio de pago. Utilizá el banner oficial.
En la selección del medio de pago
La opción de pagar con MercadoPago debe aparecer a través del banner oficial y no redactado en texto. Al igual que
en la Home Page, los medios de pago disponibles deben quedar claramente relacionados con el logo de
MercadoPago. En caso de que cuentes con más de un proveedor de soluciones pagos, deberás posicionar a
MercadoPago en la primera o segunda posición para optimizar la visualización y conversión.
Además el comprador debe contar con la información actualizada de promociones y condiciones legales relacionadas.
Para brindar esta información debés habilitar la landing de promociones oficial de MercadoPago desde tu sitio.
MercadoPago se encarga de actualizar diariamente las promociones vigentes, con los costos de financiación y CFT
correspondiente para cada caso. En ningún caso, pueden recortarse las condiciones, o utilizar landings propias ya que
usualmente muestran errores o desactualizaciones en las condiciones de la promociones.
9
Prueba tu integración utilizando el ambiente Sandbox.
10
Al finalizar la integración usa este checklist de correcta integración para confirmar:
ITEM
HOME PAGE
Comunicación de medios de pago
DETALLE DE LA OFERTA
Comunicación de medios de pago
SI
NO
Uso de banners de MercadoPago para la selección
SELECCIÓN DEL MEDIO DE PAGO
Acceso a la Landing de Promociones
MercadoPago en la primera o segunda posición
Enviar razón de la suscripción
PREFERENCIA DE PAGO
Enviar mail del comprador
Indicar frecuencia y fecha de inicio
Enviar URL de retorno a tu plataforma
Modo de apertura “Redirect”
CHECKOUT MERCADOPAGO
Incluir logo de la empresa
¡Recordá! Si tu integración no cumple con todos los puntos del checklist, tu usuario podría ser inhabilitado. Si tenés dudas sobre
los puntos anteriores, te recomendamos, contactarnos antes de salir en producción. De esta forma aseguramos la mejor experiencia para vos y tus clientes.
Muchas gracias.
MercadoPago | Kit de integración | 5
Guía de Integración
Botón de pago en tu sitio para cobro por modelo Marketplace
1
Ingresá a nuestro sitio para desarrolladores, allí encontrarás toda la documentación técnica necesaria para ejecutar la
integración.
2
Crea una aplicación de MercadoPago. Asegúrate de marcar la opción para indicar que deseas operar en modo marketplace.
3
Solicita autorización a tus vendedores y obtiene su primer acces_token y refresh_token. Para poder crear una preferencia
de pago (paso 4) requerirás utilizar el acces_token de tu vendedor. Dado que el mismo sólo es válido durante 3 horas,
deberás usar el refresh_token para generar un nuevo par de acces_token y refresh_token.
4
Completá todos los atributos de la preferencia de pago (Ver glosario de atributos ).
De esta forma, podremos incluirte en nuestro Programa de Protección al Vendedor , mantener los riesgos de fraude bajo
control y asegurar los mejores índices de aprobación de pagos.
5
Idealmente utilizá el modo de apertura “redirect” para desplegar el Checkout. Si quisieras utilizar alguna otra modalidad de
Checkout (lightbox, iframe) recomendamos que hagas pruebas de performance (A/B testing) y elijas la modalidad que mejor
convierta. Nuestra experiencia muestra que esta modalidad tradicional “redirect” es la que mejor convierte en la mayoría de
los sitios web de distintas industrias.
6
Cargá el logo de tu empresa en el Checkout.
7
Al finalizar el pago, redirigí a una página de felicitación por la compra. También sería bueno que aproveches este momento
para realizar cross-selling. Ofrecele a tu cliente productos relacionados a su última compra y maximizá tus ingresos.
8
Sincronizá tu sistema de administración de cobros en tiempo real para recibir notificaciones instantáneas de los pagos con
nuestro servicio de mensajes IPN 2.0.
9
Por temas legales-regulatorios de los Bancos Centrales y medios de pago habilitados en cada país, estás obligado a
mostrar correctamente los medios de pago y promociones disponibles en el sitio a través de MercadoPago.
En la home page
Los logos de medios de pago o bancos siempre deben mostrarse como parte de la oferta de MercadoPago y no en
forma independiente. Debemos asegurar que el comprador entienda que MercadoPago es el responsable de la
relación con cada medio de pago. Utilizá el banner oficial.
En la selección del medio de pago
La opción de pagar con MercadoPago debe aparecer a través del banner oficial y no redactado en texto. Al igual que
en la Home Page, los medios de pago disponibles deben quedar claramente relacionados con el logo de
MercadoPago. En caso de que cuentes con más de un proveedor de soluciones pagos, deberás posicionar a
MercadoPago | Kit de integración | 6
MercadoPago en la primera o segunda posición para optimizar la visualización y conversión.
Además el comprador debe contar con la información actualizada de promociones y condiciones legales relacionadas.
Para brindar esta información debés habilitar la landing de promociones oficial de MercadoPago desde tu sitio.
MercadoPago se encarga de actualizar diariamente las promociones vigentes, con los costos de financiación y CFT
correspondiente para cada caso. En ningún caso, pueden recortarse las condiciones, o utilizar landings propias ya que
usualmente muestran errores o desactualizaciones en las condiciones de la promociones.
10
Prueba tu integración utilizando usuarios de testeo. Para esto, deberás crear usuarios de testeo que cumplan
los roles de:
Propietario del market place: Necesitarás dar de alta una aplicación de testeo (repetir paso 2)
Vendedor
Comprador
Luego, podrás pagar con usuarios de testeo.
11
Al finalizar la integración usa este checklist de correcta integración para confirmar:
ITEM
HOME PAGE
Comunicación de medios de pago
DETALLE DE LA OFERTA
Comunicación de medios de pago
SI
NO
Uso de banners de MercadoPago para la selección
SELECCIÓN DEL MEDIO DE PAGO
Acceso a la Landing de Promociones
MercadoPago en la primera o segunda posición
Enviar descripción, foto y categoría del producto
SUSCRIPCIÓN DE PAGO
Enviar mail del comprador
Enviar datos del envío
Enviar URL de retorno a tu plataforma
Modo de apertura “Redirect”
CHECKOUT MERCADOPAGO
Incluir logo de la empresa
¡Recordá! Si tu integración no cumple con todos los puntos del checklist, tu usuario podría ser inhabilitado. Si tenés dudas sobre
los puntos anteriores, te recomendamos, contactarnos antes de salir en producción. De esta forma aseguramos la mejor experiencia para vos y tus clientes.
Muchas gracias.
MercadoPago | Kit de integración | 7