Cómo integrar el checkout en marketplace

Marketplace es un sitio/plataforma de comercio electrónico que conecta a vendedores y compradores en un mismo entorno de ventas, permitiendo la venta de productos y/o servicios online con mayor alcance y posibilidad de conversión.

Además de la estructura necesaria para realizar las ventas, algunos marketplaces se encargan de la disposición de productos, formas de pago y envío, optimizando el proceso de venta y facilitando la gestión comercial.

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 API: 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 del pago sin necesidad de ninguna acción por parte del vendedor.

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 API ) 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.

    {
    "items": [
        {
            "id": "item-ID-1234",
            "title": "Meu produto",
            "currency_id": "BRL",
            "quantity": 1,
            "unit_price": 75.76
        }
    ],
    "marketplace_fee": 10
    }

• Si es Checkout API , completa el parámetro application_fee con el monto que se cobrará por cada pago creado en la API /payments.

    {
    "description": "API TRANSPARENTE MARKETPLACE",
    "installments": 1,
    "token": "{{card_token}}",
    "payer": {
        "id": "{{payer_id}}"
    },
    "marketplace": "{{marketplace_id}}",
    "payment_method_id": "master",
    "application_fee": 2,
    "transaction_amount": 10
    }

Al completar estos pasos, el checkout se habrá integrado en el marketplace y estará listo para procesar pagos.