Mercado Pago Fast Payments

​

Availability

• Full checkout (mountCheckout)
• Lite checkout (mountCheckoutLite) with paymentMethodType: 'MERCADO_PAGO_SUPERTOKEN', supporting both element and modal render modes (Mercado Pago recommends element).

​

Requirements

• A Yuno account with Dashboard access and a Web SDK integration on the new Yuno SDK using Full checkout or Lite checkout.
• Fast Payments enabled on your Mercado Pago application: Mercado Pago enables Fast Payments per application. If not enabled, the section displays “Mercado Pago is not available right now”.
• Mercado Pago connection fully authorized: In the Yuno Dashboard, complete Connect with Mercado Pago until you are redirected back to the Dashboard. Providing the public key alone is not sufficient; payments require the seller access token generated during authorization.
• Public key configured per country: Add the Mercado Pago public key of your Mercado Pago account to the connection. One public key belongs to one Mercado Pago site (for example Argentina, Brazil, or Mexico); if you sell across multiple countries, add the public key for each site tagged with its country (using GLOBAL as a fallback).

• Notification webhook configured in Mercado Pago: Set the Notification URL in your Mercado Pago application to https://prod.y.uno/mercadopago-webhook/v1/orders/events and subscribe to the Order (Mercado Pago) event.
• The MERCADO_PAGO_SUPERTOKEN payment method enabled for your checkout in your routing rules.

​

How it works for the shopper

​

Full checkout

​

Lite checkout

​

Integration

​

Full checkout

​

Lite checkout

await yuno.startCheckout({
  checkoutSession,
  elementSelector: '#root',
  countryCode: 'AR',
  // Mercado Pago recommends element render mode
  renderMode: {
    type: 'element', // or 'modal'
    elementSelector: {
      apmForm: '#apm-form',
      actionForm: '#action-form',
    },
  },
  // ...your callbacks
});

await yuno.mountCheckoutLite({
  paymentMethodType: 'MERCADO_PAGO_SUPERTOKEN',
});

await yuno.startPayment();

​

One-time token and payment creation

{
  "payment_method": {
    "type": "MERCADO_PAGO_SUPERTOKEN",
    "wallet": {
      "third_party_token": "<token issued by Mercado Pago for this payment>",
      "provider_method_id": "master",
      "provider_method_type": "credit_card"
    },
    "installment": { "value": 1, "id": null }
  }
}

• third_party_token is the token Mercado Pago issues for the method the shopper chose. Yuno uses it to charge the payment; you never see card data.
• provider_method_id and provider_method_type identify the method inside the shopper’s Mercado Pago account (a card brand such as master, or account_money for the account balance).
• installment is sent for cards, with the number of installments the shopper picked from Mercado Pago’s options. It is omitted for account_money.

​

Countries

​

Testing