Este endpoint permite gerar um lote com múltiplas transações de saídas de dinheiro desde uma conta do Mercado Pago a outras contas (internas ou externas), contanto que a conta de retirada tenha fundos. O payout pode conter até 1000 transações que são criadas e processadas em uma única requisição. Em caso de sucesso, a requisição retornará uma resposta com o status 202.
POST
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
400Requisição inválida. Os parâmetros enviados não são válidos.
bad_request
Dados inválidos foram enviados no body da requisição. Tente enviar a solicitação novamente, validando todos os campos.
401Não autorizado. Credenciais inválidas ou ausentes.
unauthorized
O valor enviado como Access Token está incorreto. Verifique e tente a enviar requisição novamente com o valor correto.
403Proibido. Não tem permissões para acessar este recurso.
forbidden
Sem permissão para acessar o recurso.
404Não encontrado. O recurso solicitado não existe.
not_found
O recurso solicitado não foi encontrado ou o valor enviado para identificá-lo é inexistente. Valide as informações enviadas nos parâmetros e tente realizar a requisição novamente.
500Erro interno do servidor.
internal_server_error
Ocorreu um erro inesperado no servidor. Tente enviar a requisição novamente.
curl -X POST \
'https://api.mercadopago.com/v1/payouts'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
-H 'X-Idempotency-Key: b5ac1280-8ac5-42bb-ae3d-123849f95f47' \
-H 'X-signature: true' \
-H 'X-Enforce-Signature: undefined' \
-H 'X-Test-Token: false' \
-d '{
"external_reference": "MP0197",
"description": "Payout for seller commissions",
"schedule_date": "2025-12-25T10:00:00",
"config": {
"notification_url": "http://example.ar/notification"
},
"transactions": [
{
"external_reference": "MP0197",
"type": "account",
"account": {
"email": "test_user_ar@testuser.com",
"number": "0000003100025957669623",
"owner_type": "DNI",
"owner_value": "95871050",
"bank_name": "Mercado Pago",
"bank_id": "003",
"branch": "0001",
"holder": "María González",
"account_type": "account"
},
"amount": {
"currency": "ARS",
"value": 24.5
},
"description": "Payment to seller Beltrano"
}
]
}'{
"id": "123456",
"idempotency_key": "0d5020ed-1af6-469c-ae06-c3bec19954bb",
"created_date": "2024-01-15T10:30:00Z",
"status": "created",
"schedule_date": "2025-12-25T10:00:00",
"description": "Payout for seller commissions",
"config": {
"notification_url": "http://example.ar/notification"
}
}