Inicio
DocumentaciĂłn
Recursos
Partners
Comunidad

Recursos

Revisa las actualizaciones de nuestras soluciones y operatividad del sistema o pide soporte técnico.

Partners

Conoce nuestro programa para agencias o desarrolladores que ofrecen servicios de integraciĂłn y vendedores que quieren contratarlos.

Comunidad

Recibe las Ășltimas novedades, pide ayuda a otros integradores y comparte tus conocimientos.

IntegraciĂłn Web - Checkout Pro - Mercado Pago Developers

BĂșsqueda inteligente powered by OpenAI 

Añadir checkout

Client-Side

Primero, asegĂșrate de haber creado la preferencia en tu backend.

Luego, deberĂĄs instalar el SDK de frontend de Mercado Pago en tu proyecto para agregar el botĂłn de pago.

La instalaciĂłn se realiza, bĂĄsicamente, en dos pasos:

  1. Agregar el SDK de Mercado Pago al proyecto con tus credenciales configuradas
  2. Iniciar el checkout desde la preferencia

Agregar el SDK de Mercado Pago al proyecto

Client-Side

Para incluir el SDK de Mercado Pago.js, agrega el siguiente cĂłdigo al HTML del proyecto o instala la biblioteca para ReactJs.

          
// SDK MercadoPago.js
<script src="https://sdk.mercadopago.com/js/v2"></script>

        
          
npm install @mercadopago/sdk-react

        

Luego, inicializa la integraciĂłn configurando tu clave pĂșblica usando el siguiente cĂłdigo JavaScript.

          
const mp = new MercadoPago('YOUR_PUBLIC_KEY');
const bricksBuilder = mp.bricks();

        
          
import { initMercadoPago, Wallet } from '@mercadopago/sdk-react'
initMercadoPago('YOUR_PUBLIC_KEY');

        

Para las integraciones de JavaScript/HTML, a través de CDN, deberås crear un contenedor de identificador para definir la ubicación donde se insertarå el botón en la pantalla. La creación del contenedor se realiza insertando un elemento en el código HTML de la pågina en la que se representarå el componente.

html

 <div id="wallet_container"></div>
AtenciĂłn
El valor que se muestra en la propiedad de ID a continuaciĂłn es solo un ejemplo y se puede cambiar, pero siempre debe coincidir con el ID indicado en el paso de renderizado.

Iniciar el checkout desde la preferencia

Client-Side

Al finalizar el paso anterior, inicializa tu checkout usando el ID de la preferencia previamente creada con el identificador del elemento donde se debe mostrar el botĂłn, si estĂĄs usando la integraciĂłn Javascript/HTML, o instanciando el componente, en el caso de la biblioteca React, como se muestra en los ejemplos a continuaciĂłn.

          
mp.bricks().create("wallet", "wallet_container", {
   initialization: {
       preferenceId: "<PREFERENCE_ID>",
   },
customization: {
 texts: {
  valueProp: 'smart_option',
 },
 },
});

        
          
<Wallet initialization={{ preferenceId: '<PREFERENCE_ID>' }} customization={{ texts:{ valueProp: 'smart_option'}}} />

        

A continuaciĂłn, encontrarĂĄs el botĂłn de pago que se muestra en tu pĂĄgina.

wallet-render

En el ejemplo anterior, se renderizarå un botón de pago que serå responsable por abrir el Checkout Pro. Si deseas que la experiencia con Checkout Pro se realice en una pestaña externa, consulta la sección Esquema de apertura

Configurar las back_url

Al final del proceso de pago, es posible redirigir al comprador a otro entorno del sitio a través del atributo back_urls que se configura al crear la preferencia. Las back_urls serån las encargadas de guiar el flujo de regreso a tu sitio web cuando se complete el pago. Es posible definir tres URL de retorno diferentes que corresponden a escenarios de pago pendiente, éxito o error.

Para obtener mĂĄs informaciĂłn, consulta la secciĂłn URL de retorno.

Importante
No utilices dominios locales en el valor back_urls, tales como 'localhost/' o '127.0.0.1' con o sin puerto especificado. Recomendamos usar un servidor con dominio nombrado (DNS) o IPs de desarrollo para poder regresar al sitio después del pago. De lo contrario, aparecerå el mensaje de "Algo ha salido mal" al finalizar el proceso de compra.

Recibir estados de pago

Al crear un pago es posible recibir 3 estados diferentes: Pendiente, Rechazado y Aprobado. Para mantenerse al dĂ­a con las actualizaciones, debes configurar tu sistema para recibir notificaciones de pago y otras actualizaciones de estado. Consulta Notificaciones para obtener mĂĄs detalles.

Ejemplo de implementaciĂłn

Consulta el ejemplo de integraciĂłn completa en GitHub para PHP o NodeJS para descargar un proyecto bĂĄsico para una implementaciĂłn rĂĄpida de Checkout Pro en tu sitio.