Este endpoint permite criar um lote (payout) com uma ou várias transações de saída de dinheiro de uma conta Mercado Pago para um ou vários destinatários. As transações podem ser transferências entre contas Mercado Pago ou para contas bancárias externas do tipo conta corrente. A conta de origem deve ter saldo suficiente. Um payout pode conter até 1000 transações, que são criadas e enviadas para processamento em uma única requisição. Em caso de sucesso, a requisição retorna o status 202.
POST
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO CONDICIONAL
OBRIGATÓRIO CONDICIONAL
boolean que indica se o integrador enviará ou não a assinatura. Deve ser false para ambiente de teste, true para ambiente produtivo, que é quando é obrigatório o envio da assinatura.OBRIGATÓRIO
-), underlines (_) e espaços; não use pontuação.YYYY-MM-DDTHH:MM:SS), sem fuso horário. O fuso horário é inferido automaticamente com base400Requisição inválida. Os parâmetros enviados não são válidos.
invalid_payout_id
Dados inválidos foram enviados no body da requisição. O payout não foi encontrado. Tente enviar a solicitação novamente, validando todos os campos.
invalid_transaction_id
Dados inválidos foram enviados no body da requisição. A transação não foi encontrada. Tente enviar a solicitação novamente, validando todos os campos.
invalid_signature
Dados inválidos foram enviados no body da requisição. Verifique se a secret foi gerada corretamente e está registrada com o Mercado Pago. Verifique também se o body que está enviando é o que foi criptografado.
idempotency_key_required
Dados inválidos foram enviados no body da requisição. A chave de idempotência (idempotency_key) está ausente. Tente enviar a solicitação novamente, validando todos os campos.
invalid_account
O objeto `account` foi enviado sem os dados obrigatórios para identificar a conta de destino. Informe `email` para uma conta Mercado Pago ou os dados bancários obrigatórios de uma conta externa, incluindo `number` e `bank_id`.
401Erro. Access Token não autorizado.
invalid_token
O Access Token enviado está incorreto. Revise o valor e tente enviar a requisição novamente com a informação correta.
403Proibido. Não tem permissões para acessar este recurso.
forbidden
Sem permissão para acessar o recurso.
404Erro. Payout não encontrado.
not_found
Payout não encontrado. Verifique se o ID enviado está correto.
500Erro interno do servidor.
internal_server_error
Ocorreu um erro inesperado no servidor. Tente enviar a requisição novamente.
502Erro de gateway. Falha na integração com um serviço externo.
bad_gateway
Ocorreu um erro na integração com um serviço externo. 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: d4171739-3308-4b1b-ac3c-15d897658623' \
-H 'X-signature: true' \
-H 'X-enforce-signature: false' \
-H 'X-test-token: false' \
-d '{
"external_reference": "MP0197",
"description": "Payout for seller commissions",
"schedule_date": "2026-12-31T10:00:00",
"config": {
"notification_url": "https://link-your-webhook-notification.com"
},
"transactions": [
{
"external_reference": "MP0197",
"type": "account",
"account": {
"email": "test@testuser.com",
"number": "0000001234567876543210",
"owner_type": "DNI",
"owner_value": "12345678",
"bank_id": "015",
"branch": "0001",
"holder": "María González"
},
"amount": {
"currency": "ARS",
"value": 50
},
"description": "Payment to seller Beltrano"
}
]
}'{
"id": "POP01KKYN1QY2SS1MKAY4KP6SSRCT",
"external_reference": "MP0197",
"idempotency_key": "0d5020ed-1af6-469c-ae06-c3bec19954bb",
"created_date": "2024-01-15T10:30:00Z",
"status": "created",
"schedule_date": "2026-12-31T10:00:00",
"description": "Payout for seller commissions",
"config": {
"notification_url": "https://link-your-webhook-notification.com"
},
"transactions": [
{
"id": "TOP01KV681P6SJ38NQHWX3SF2WM22",
"amount": {
"currency": "ARS",
"value": "50.0"
},
"external_reference": "MP0197"
}
]
}