Antes de comenzar, ten en cuenta que en esta versión sólo puedes integrar el SDK mobile para Argentina, México, Brasil y Colombia*.
Si necesitas integrarte desde otro lugar, puedes ver qué países soportamos en la nueva versión.

*En Colombia sólo soportamos pagos con tarjetas de crédito, por lo que deberás excluir los demás medios de pago.


¿Qué ofrecemos para que personalices tu checkout?


Componentes visuales

Te ayudarán a recolectar la información necesaria para hacer el pago.

Empezar
Nuestros servicios

Te conectarán con nuestras APIs para que puedas personalizar al máximo tu experiencia.

Empezar

Información obligatoria para cobrar

Al momento de hacer el pago necesitamos que sí o sí nos envíes los siguientes datos desde tu servidor:

  • Monto a cobrar.
  • Mail del comprador: Sólo por si algo extraño sucediera durante o luego del pago. Es una protección al comprador para mejorar así tu servicio posventa.
  • Medio de pago: Marca de la tarjeta o entidad de cobro en efectivo (ya sea un cajero automático o por ventanilla). Notar que cada medio de pago tiene sus particularidades. Por ejemplo: para pagos que no son con tarjeta (offline), tenemos el tiempo de acreditación o para los pagos con tarjeta, longitud del número de tarjeta, del código de seguridad, entre otros.
  • Banco (solo para tarjetas): Es el emisor de la tarjeta. Con quienes establecemos planes de cuotas sin interes para que tus usuarios tengan la mejor financiación.
  • Cuotas (solo para tarjetas): La cantidad de cuotas seleccionadas por tu usuario. Nosotros nos encargamos de saber si el pago debe ser procesado con o sin interés dependiendo del medio de pago y el banco de la tarjeta.
  • Token (solo para tarjetas): Necesitamos el número, el nombre, la fecha de expiración y el código de seguridad de la tarjeta de tu usuario. En algunos países también es necesario que nos indiques su tipo y número de documento. Mercado Pago tokeniza estos datos para proteger la información sensible de la tarjeta.

¿Qué necesitas para empezar?

Modo sandbox y productivo

Con el Checkout personalizado puedes recibir pagos en modo sandbox o productivo. La diferencia entre uno y otro está en el tipo de credenciales que uses para autenticarte en la API.
Desarrolla tu aplicación usando tus credenciales para modo sandbox. Cuando esté lista para recibir pagos productivos, deberás pasar un proceso de homologación y reemplazar las credenciales por las de producción. No necesitas cambiar nada más de tu código. De esta forma puedes realizar pagos de prueba mientras tus clientes están procesando pagos productivos con sólo utilizar las claves correspondientes.
El entorno de sandbox es una réplica exacta de producción, diseñado con el objetivo de facilitar las pruebas durante la integración. El uso de este modo no genera ningún tipo de cargo real. Además de las credenciales correspondientes, en modo sandbox debes utilizar las tarjetas de prueba que te brindamos.

Usa tus credenciales

Existen dos tipos de claves:

  • Claves públicas: identifican tu cuenta de Mercado Pago y no son secretas. Se utilizan en el frontend.
  • Claves privadas (o access token): permiten acceder a operaciones privadas de tu cuenta. La mismas deben ser mantenidas confidencialmente en tus servidores de backend y nunca deben ser publicadas.
Para estas claves existen dos modos de uso:
  • Modo sandbox: te permiten realizar pagos de prueba.
  • Modo producción: te permiten realizar pagos reales.
Con la clave pública puedes acceder a los siguientes recursos mediante nuestra SDK: Además, con la clave privada, puedes acceder a estos recursos:

*Accede a tus credenciales

Recibe notificaciones de pagos

Cada vez que recibes un pago o se modifique uno que te hicieron, te podemos avisar mediante Notificaciones de Pagos que se envían desde los servidores de Mercado Pago a los tuyos. Esto te permitirá conocer el estado del pago, administrar tu stock o saber quién te está pagando.
Te mostramos un ejemplo sencillo de cómo recibir notificaciones de pagos, que puedes utilizar.