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" } } } }'