Transactions via Checkout API - Applying the Platform ID to your transactions - Mercado Pago Developers
What are you looking for?

Do not know how to start integrating? 

Check the first steps

Transactions via Checkout API

After receiving your corresponding PLATFORM_ID for your platform, you can add it to the request header for payment (/v1/payments) when creating a transaction with Mercado Pago.

Example:

curl

curl --location --request POST 'https://api.mercadopago.com/v1/payments' \
--header 'x-platform-id: {{PLATFORM_ID provided by the Partners team}}' \
--header 'Authorization: Bearer {{ACCESS_TOKEN}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "transaction_amount": 100,
    "installments": 1,
    "statement_descriptor": "Seller's store",
    "capture": true,
    "binary_mode": false,
    "sponsor_id": {{ID of your Mercado Pago account related to your platform.}},
    "payment_method_id": "{{payment_method_id}}",
    "token": {{card_token_id}},
    "external_reference": "Platform identifier",
    "notification_url": "{{notification_url}}",
    "description": "Seller's product description",
    "payer": {
        "first_name": "Name. Example: John",
        "last_name": "Last name. Example: Jones",
        "email": "test_user_1677272335@testuser.com",
        "identification": {
            "type": "Type. Example: CPF",
            "number": "Document number. Example: 19119119100"
        },
        "address": {
            "zip_code": "Zip code. Example: 06233-200",
            "street_name": "Street name. Example: Av. das Nações Unidas",
            "street_number": "Street number. Example: 3003",
            "neighborhood": "Neighborhood. Example: Bonfim",
            "city": "City. Example: Osasco",
            "federal_unit": "Federal unit. Example: SP"
        }
    },
    "additional_info": {
        "referral_url": "Referral URL. Example: www.sellertest123.com",
        "drop_shipping": true,
        "delivery_promise": "2022-11-20",
        "contrated_plan": "premium",
        "items": [
            {
                "id": "1941",
                "title": "Seller's product",
                "description": "Description of the seller's product",
                "picture_url": null,
                "category_id": "Category. Example: electronics",
                "quantity": 1,
                "unit_price": 100.00
            }
        ],
        "payer": {
            "first_name": "Name. Example: John",
            "last_name": "Last name. Example: Jones",
            "is_prime_user": "1",
            "is_first_purchase_online": "1",
            "last_purchase": "2019-10-25T19:30:00.000-03:00",
            "phone": {
                "area_code": "Area code. Example: 11",
                "number": "Phone number. Example: 987654321"
            },
            "address": {
                "zip_code": "Zip code. Example: 06233-200",
                "street_name": "Street name. Example: Av. das Nações Unidas",
                "street_number": "Number. Example: 3003"
            },
            "registration_date": "2013-08-06T09:25:04.000-03:00"
        },
        "shipments": {
            "express_shipment": "0",
            "pick_up_on_seller": "1",
            "receiver_address": {
                "zip_code": "Zip code. Example: 95630000",
                "street_name": "Street name. Example: São Luiz",
                "street_number": "Street number. Example: 15",
                "floor": "Floor (if it's an apartment). Example: Second",
                "apartment": "Apartment number (if it's an apartment). Example: 93"
            }
        }
    }
}'