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-4*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
-H 'X-Idempotency-Key: 9dad64d2-4265-4259-a67e-e78dcf505840' \
-H 'X-signature: true' \
-H 'X-Enforce-Signature: undefined' \
-H 'X-Test-Token: false' \
-d '{
"external_reference": "000197",
"description": "Payout for seller commissions",
"schedule_date": "2025-12-25T10:00:00",
"config": {
"notification_url": "http://example.ar/notification"
},
"transactions": [
{
"external_reference": "000197",
"type": "account",
"account": {
"email": "test_user_mx@testuser.com",
"number": "0000003100025957669623",
"owner_type": "CURP",
"owner_value": "95871050",
"bank_name": "Mercado Pago",
"bank_id": "003",
"branch": "0001",
"holder": "Miguel Hernández",
"account_type": "account"
},
"amount": {
"currency": "MXN",
"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"
}
}