Recursos para IA
Crear consentimientos de split

Crea una o más invitaciones de consentimiento para el Split de Pagos 1:N. El receptor primario invita a uno o más receptores secundarios por email. Cada invitación genera un receiver_id único en formato UUID que deberás usar al crear orders con split.

POST

https://api.mercadopago.com/v1/split-consent
Request parameters
Header
Authorization
string

REQUERIDO

Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
X-Idempotency-Key
string

REQUERIDO

Clave de idempotencia en formato UUIDv4. Garantiza que una misma solicitud no se procese más de una vez.
x-site-id
string

REQUERIDO

Identificador del sitio de Mercado Libre (por ejemplo: MLA, MLB, MLM, MLC, MCO, MPE, MLU).
Body
invites
array
Response parameters
succeeded
array
Lista de consentimientos creados exitosamente.
failed
array
Lista de invitaciones que no pudieron procesarse. Puede estar vacío si todos fueron exitosos.
Errors

400Todas las invitaciones fallaron por errores de validación.

409Clave de idempotencia reutilizada con payload diferente. Si necesitas reintentar con datos distintos, genera una nueva X-Idempotency-Key. Si la solicitud es idéntica, reutiliza la misma clave.

423Solicitud concurrente con la misma clave de idempotencia en curso. Espera a que la solicitud en curso finalice antes de volver a intentar.

500Todas las invitaciones fallaron debido a un error inesperado del servidor. Si el error persiste, contacta al soporte de Mercado Pago para developers.

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: 912a10bf-925b-47c5-95f5-b4b7ec32e477' \
       -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"
    }
  ]
}