Ejemplo de código (Cuenta de Mercado Pago)
Para facilitar y optimizar su proceso de integración, ve a continuación un ejemplo completo de cómo incluir la Cuenta de Mercado Pago como medio de pago con Payment Brick.
Crea tu preferencia
Server-Side
<?php
// SDK de Mercado Pago
require __DIR__ . '/vendor/autoload.php';
// Agregar credenciales
MercadoPago\SDK::setAccessToken('PROD_ACCESS_TOKEN');
?>
// Crear un objeto de preferencia
$preference = new MercadoPago\Preference();
// Crear un elemento en la preferencia
$item = new MercadoPago\Item();
$item->title = 'Mi producto';
$item->quantity = 1;
$item->unit_price = 75.56;
$preference->items = array($item);
// el $preference->purpose = 'wallet_purchase'; solo permite pagos registrados
// para permitir pagos de guest, puede omitir esta propiedad
$preference->purpose = 'wallet_purchase';
$preference->save();
?>
// SDK de Mercado Pago
const mercadopago = require ('mercadopago');
// Agregar credenciales
mercadopago.configure({
access_token: 'PROD_ACCESS_TOKEN'
});
// Crear un objeto de preferencia
let preference = {
// el "purpose": "wallet_purchase" solo permite pagos registrados
// para permitir pagos de guest, puede omitir esta propiedad
"purpose": "wallet_purchase",
"items": [
{
"id": "item-ID-1234",
"title": "Mi producto",
"quantity": 1,
"unit_price": 75.76
}
]
};
mercadopago.preferences.create(preference)
.then(function (response) {
// Este valor es el ID de preferencia que se enviará al ladrillo al inicio
const preferenceId = response.body.id;
}).catch(function (error) {
console.log(error);
});
// SDK de Mercado Pago
import com.mercadopago.MercadoPagoConfig;
// Agregar credenciales
MercadoPagoConfig.setAccessToken("PROD_ACCESS_TOKEN");
// Crear un objeto de preferencia
PreferenceClient client = new PreferenceClient();
// Crear un elemento en la preferencia
List<PreferenceItemRequest> items = new ArrayList<>();
PreferenceItemRequest item =
PreferenceItemRequest.builder()
.title("Mi producto")
.quantity(1)
.unitPrice(new BigDecimal("100"))
.build();
items.add(item);
PreferenceRequest request = PreferenceRequest.builder()
// el .purpose('wallet_purchase') solo permite pagos registrados
// para permitir pagos de guest, puede omitir esta línea
.purpose('wallet_purchase')
.items(items).build();
client.create(request);
# SDK de Mercado Pago
require 'mercadopago'
# Agregar credenciales
sdk = Mercadopago::SDK.new('PROD_ACCESS_TOKEN')
# Crear un objeto de preferencia
preference_data = {
# el purpose: 'wallet_purchase', solo permite pagos registrados
# para permitir pagos de guests, puede omitir esta propiedad
purpose: 'wallet_purchase',
items: [
{
title: 'Mi producto',
unit_price: 75.56,
quantity: 1
}
]
}
preference_response = sdk.preference.create(preference_data)
preference = preference_response[:response]
# Este valor es el ID de preferencia que usará en el HTML en el inicio del Brick
@preference_id = preference['id']
// SDK de Mercado Pago
using MercadoPago.Config;
// Agregar credenciales
MercadoPagoConfig.AccessToken = "PROD_ACCESS_TOKEN";
// Crear el objeto de request de preferencia
var request = new PreferenceRequest
{
// el Purpose = 'wallet_purchase', solo permite pagos registrados
// para permitir pagos de invitados, puede omitir esta propiedad
Purpose = 'wallet_purchase',
Items = new List<PreferenceItemRequest>
{
new PreferenceItemRequest
{
Title = "Mi producto",
Quantity = 1,
CurrencyId = "BRL",
UnitPrice = 75.56m,
},
},
};
// Crea la preferencia usando el cliente
var client = new PreferenceClient();
Preference preference = await client.CreateAsync(request);
# SDK de Mercado Pago
import mercadopago
# Agregar credenciales
sdk = mercadopago.SDK("PROD_ACCESS_TOKEN")
# Crear un elemento en la preferencia
preference_data = {
# el "purpose": "wallet_purchase", solo permite pagos registrados
# para permitir pagos de invitados, puede omitir esta propiedad
"purpose": "wallet_purchase",
"items": [
{
"title": "Mi elemento",
"quantity": 1,
"unit_price": 75.76
}
]
}
preference_response = sdk.preference().create(preference_data)
preference = preference_response["response"]
curl -X POST \
'https://api.mercadopago.com/checkout/preferences' \
-H 'Content-Type: application/json' \
-H 'cache-control: no-cache' \
-H 'Authorization: Bearer **PROD_ACCESS_TOKEN**' \
-d '{
"purpose": "wallet_purchase",
"items": [
{
"title": "Mi producto",
"quantity": 1,
"unit_price": 75.76
}
]
}'
Configurar la integración
Client-Side
NOTAAtenciónSi es necesario cerrar y volver a abrir el Brick (cuando un usuario vuelve al carrito para cambiar algún detalle de compra, por ejemplo) es necesario eliminar la instancia actual del Brick y crear una nueva cuando sea necesario mostrarlo otra vez.
Para ello, utilice el método
unmount disponible en el controller de Brick, en este caso: window.paymentBrickController.unmount().html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Bricks</title>
</head>
<body>
<div id="paymentBrick_container"></div>
<script src="https://sdk.mercadopago.com/js/v2"></script>
<script>
const mp = new MercadoPago('YOUR_PUBLIC_KEY');
const bricksBuilder = mp.bricks();
const renderPaymentBrick = async (bricksBuilder) => {
const settings = {
initialization: {
amount: 100, // monto a ser pago
preferenceId: '<PREFERENCE_ID>', // preferenceId generado en el backend
},
callbacks: {
onReady: () => {
/*
Callback llamado cuando Brick está listo
Aquí puedes ocultar loadings de su sitio, por ejemplo.
*/
},
onSubmit: ({ selectedPaymentMethod, formData }) => {
// callback llamado al hacer clic en el botón de envío de datos
// en este caso, el usuario fue redirigido a
// la página de Mercado Pago para realizar el pago
},
onError: (error) => {
// callback llamado para todos los casos de error de Brick
console.error(error);
},
},
};
window.paymentBrickController = await bricksBuilder.create(
'payment',
'paymentBrick_container',
settings
);
};
renderPaymentBrick(bricksBuilder);
</script>
</body>
</html>Los pagos con Cuenta de Mercado Pago no necesitan ser enviados a través del backend. Si el usuario selecciona esta opción como medio de pago, el
preferenceId enviado en la inicialización del Brick es el encargado de redirigir al comprador al sitio web de Mercado Pago, donde el pago se realizará directamente en nuestro sitio. Para redirigir al comprador a tu sitio, puede configurar back_urls como se describe
en este artículo.