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:
- Agregar el SDK de Mercado Pago al proyecto con tus credenciales configuradas
- 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>
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.
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.
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.