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 uma ou várias contas Mercado Pago. 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 o e-mail obrigatório para identificar a conta Mercado Pago de destino. Informe o e-mail da conta destinatária em `email`.
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-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
-H 'X-Idempotency-Key: 4ab9c73e-0b70-4189-9782-f9540d497891' \
-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"
},
"amount": {
"currency": "COP",
"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": "COP",
"value": "50.0"
},
"external_reference": "MP0197"
}
]
}