Mercado Pago

Getting Started with Mercado Pago Wallet

This page provides a complete guide to successfully integrate Mercado Pago Wallet with DEUNA.

Mercado Pago is Mercado Libre's payment platform, designed to securely process transactions in Latin America. Through its Wallet, users can store funds and cards to make payments quickly and efficiently.

How it Works

Mercado Pago Checkout

  • Supports multiple payment methods
    • Credit and debit cards
    • Cash payments (OXXO, Pago Fácil, etc.)
    • Bank transfers (SPEI, PSE, etc.)
    • Buy Now Pay Later (Mercado Crédito) – available for authenticated users
    • Mercado Pago account balance – available for authenticated users

Requirements

The following content lists all the requirements for a successful integration with Mercado Pago Wallet.

  • Environments:
    • Sandbox: https://api.sandbox.deuna.io
    • Production: https://api.deuna.io

Integration Steps

Now that the technical requirements are defined, you can begin the integration.

1. Configure the payment processor

  1. Add Mercado Pago Wallet to your Connections in the DEUNA Admin.
  2. Search for Mercado Pago Wallet and enter your business account credentials.

2. Create an order

To make a purchase, you must first create an order in DEUNA.

Follow the steps to Create an Order.

The API will return an order_token that is used throughout the flow.

Required fields:

FieldDescriptionValue
order.store_codeUnique store codeall
order.payment_methodDEUNA's payment method type.mercadopago_wallet
order.items_total_amountTotal amount of items without taxes or discounts.2000

Considerations:

  • About order.items:
    • total_amount.original_amount must be unit_price.amount * quantity.
    • total_amount.amount must be ((unit_price.amount + tax_amount.amount) * quantity) - total_amount.total_discounts.
    • total_amount.total_discounts is the total value of discounts for the quantity of items.
  • order.items_total_amount is the sum of the unit prices of the items. This amount, plus order.total_tax_amount and minus order.discount_amount, must match order.total_amount.
  • order.sub_total is the sum of the unit price of the items minus the discounts. This amount, plus order.total_tax_amount, must match order.total_amount.

3. Choose the integration type

After creating an order, choose the integration type that best suits your needs: