AI resources
Create split consentshttps://api.mercadopago.com/v1/split-consent
Creates one or more consent invitations for 1:N Split Payments. The primary seller invites one or more secondary sellers by email. Each invitation generates a unique receiver_id in UUID format to be used when creating split orders.
POST
Request parameters
Header
Authorization
string
REQUIRED
Access Token obtained through the developer panel. Must be sent in all requests.
X-Idempotency-Key
string
REQUIRED
Idempotency key in UUIDv4 format. Ensures the same request is not processed more than once.
x-site-id
string
REQUIRED
Mercado Libre site identifier (e.g., MLA, MLB, MLM, MLC, MCO, MPE, MLU).
Body
invites
array
Response parameters
succeeded
array
List of successfully created consents.
failed
array
List of invitations that could not be processed. May be empty if all succeeded.
Errors
400All invites failed due to validation errors.
409Idempotency key reused with a different payload. If you need to retry with different data, generate a new X-Idempotency-Key. If the request is identical, reuse the same key.
423Concurrent request with the same X-Idempotency-Key in progress. Wait for the in-progress request to complete before retrying.
500All invites failed due to an unexpected server error. If the error persists, contact Mercado Pago developer support.
Request
curl -X POST \
'https://api.mercadopago.com/v1/split-consent'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********88776-122*********fc20dede6*********a497d7225*********64' \
-H 'X-Idempotency-Key: f61c5a4d-1009-4b90-9ff7-868b12df233a' \
-H 'x-site-id: MLA' \
-d '{
"invites": [
{
"seller_email": "vendedor@example.com",
"expiration_days": 30
}
]
}'Response
{
"succeeded": [
{
"seller_email": "vendedor@example.com",
"receiver_id": "550e8400-e29b-41d4-a716-446655440001",
"invite_url": "https://www.mercadopago.com/split-consent/accept?token=abc123"
}
],
"failed": [
{
"seller_email": "vendedor@example.com",
"error": "VALIDATION_ERROR",
"message": "seller_email already has an active consent"
}
]
}