Cria um ou mais convites de consentimento para o Split de Pagamento 1:N. O receptor primário convida um ou mais receptores secundários por e-mail. Cada convite gera um receiver_id único no formato UUID que deve ser usado ao criar orders com split.
POST
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
400Todos os convites falharam por erros de validação.
409Chave de idempotência reutilizada com payload diferente. Se precisar retentar com dados distintos, gere uma nova X-Idempotency-Key. Se a solicitação for idêntica, reutilize a mesma chave.
423Requisição concorrente com a mesma chave de idempotência em andamento. Aguarde a conclusão da requisição em curso antes de tentar novamente.
500Todos os convites falharam devido a um erro inesperado do servidor. Se o erro persistir, entre em contato com o suporte do Mercado Pago para developers.
curl -X POST \
'https://api.mercadopago.com/v1/split-consent'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
-H 'X-Idempotency-Key: c49faaae-265c-4627-95ab-624083a57d5f' \
-H 'x-site-id: MLA' \
-d '{
"invites": [
{
"seller_email": "vendedor@example.com",
"expiration_days": 30
}
]
}'{
"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"
}
]
}