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.

Integrar el checkout en Split de Pagos - ConfiguraciĂłn de la integraciĂłn - Mercado Pago Developers

BĂșsqueda inteligente powered by OpenAI 

Integrar el checkout en Split de pagos (marketplace)

Si eliges vender a través de un marketplace, es posible integrar dos tipos de checkout de Mercado Pago para procesar los pagos realizados.

  • Checkout Pro: en este modelo de checkout, el comprador es dirigido a una pĂĄgina de Mercado Pago para completar el pago.
  • Checkout Transparente: este modelo de pago permite al comprador realizar el pago dentro del entorno del marketplace.

Ambos checkouts reparten automåticamente los importes entre el vendedor y el marketplace a través del split de pagos sin necesidad de ninguna acción por parte del vendedor.

Importante
La comisiĂłn de Mercado Pago se descuenta de los fondos recibidos por el vendedor. Es decir, primero se descuenta la comisiĂłn de Mercado Pago, y la comisiĂłn del marketplace se descuenta del saldo restante.

Para realizar la integración deberås seguir el flujo de integración habitual del checkout elegido, utilizando necesariamente el token de acceso para cada vendedor que fue obtenido a través de OAuth. A continuación, enumeramos los pasos necesarios para integrar una caja con el marketplace.

  1. Sigue los pasos descritos en la documentaciĂłn de OAuth para obtener cada access_token. Esta informaciĂłn serĂĄ necesaria durante el proceso de integraciĂłn de pago en el marketplace.
  2. Elige el checkout que deseas (Checkout Pro o Checkout Transparente) y sigue todo el flujo de integraciĂłn.
  3. En la integraciĂłn del checkout, usa la public_key de tu cuenta de integrador en el frontend e inserta el access_token del vendedor (obtenido en el paso 1) en el backend o en el header de la solicitud.
  4. Para determinar el porcentaje de comisiĂłn del marketplace:
  • Si es Checkout Pro, completa el parĂĄmetro marketplace_fee con el monto que se cobrarĂĄ por cada preferencia de pago creada en la API /checkout/preferences.

Ejemplo

json

    {
    "items": [
        {
            "id": "item-ID-1234",
            "title": "Meu produto",
            "currency_id": "BRL",
            "quantity": 1,
            "unit_price": 75.76
        }
    ],
    "marketplace_fee": 10
    }
  • Si es Checkout Transparente, completa el parĂĄmetro application_fee con el monto que se cobrarĂĄ por cada pago creado en la API /payments.

Ejemplo

curl

curl --location 'https://api.mercadopago.com/v1/payments' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'Authorization: Bearer {{oauth_access_token}}' \
--data-raw '{
    "description": "Pago de prueba 3",
    "installments": 1,
    "token": "{{card_token}}",
    "payer": {
        "email": "{{payer_email}}"
    },
    "payment_method_id": "master",
    "transaction_amount": 25,
    "application_fee": 10
}'

Al completar estos pasos, el checkout se habrĂĄ integrado en el marketplace y estarĂĄ listo para procesar pagos. Ten en cuenta que la soluciĂłn Split de pagos sĂłlo permite realizar pagos con dinero en cuenta entre cuentas de Mercado Pago. No se permiten transferencias de instituciones financieras externas.

Importante
En caso de reembolso, el valor adeudado al cliente final serĂĄ dividido y restado de la cuenta del vendedor y de la cuenta del Marketplace, de forma proporcional para las partes involucradas. AdemĂĄs, en modelos 1:1, el Marketplace no podrĂĄ realizar el reembolso total si el vendedor no tuviera dinero en la cuenta. En ese caso, corresponde a la cuenta del Marketplace reembolsar el equivalente a su parte y decidir si devolverĂĄ el restante, que es responsabilidad del vendedor, por otro medio.