This endpoint allows generating a batch of money out operations from a Mercado Pago account to other accounts (internal or external), as long as the withdrawal account has funds. The payout can contain up to 1000 transactions that are created and processed in a single request. In case of success, the request will return a response with status 202.
POST
REQUIRED
REQUIRED
REQUIRED
REQUIRED
REQUIRED
400Bad request. The parameters sent are not valid.
bad_request
Invalid data was sent in the request body. Try sending the request again, validating all fields.
401Unauthorized. Invalid or missing credentials.
unauthorized
The value sent as Access Token is incorrect. Please check and try again with the correct value.
403Forbidden. You don't have permissions to access this resource.
forbidden
No permission to access the resource.
404Not found. The requested resource does not exist.
not_found
The requested resource was not found or the value sent for its identification does not exist. Validate the information sent in the parameters and try the request again.
500Internal server error.
internal_server_error
An unexpected error occurred on the server. Try the request again.
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: 897750ac-7407-46b3-a687-4f41b2e85477' \
-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"
}
}