Account balance


Check account balance

When you have money on your account, you can check your balance with the MercadoPago Account resource. Example:
curl -X GET{User_id}/mercadopago_account/balance?access_token=$ACCESS_TOKEN
You will notice that you’ll find various amounts separated by status and availability in the response. The parameter “unavailable_balance_by_reason” shows the amounts ​​unavailable and it will tell you the reason why it’s unavailable. You can also see amounts available for transfer, withdrawal, and payment (credit in MercadoPago) in the parameter “available_balance_by_transaction_type.”


  • dispute – Amount blocked while the order is in dispute.
  • fraud – Amount blocked due to suspected fraud.
  • ml_debt – Amount destined only to MercadoLibre cost.
  • time_period – Amount blocked by default time processing MercadoPago.
  • restriction – Amount blocked for other reasons.
That’s all you need to know about it. If you want to know further about working with MercadoPago, check the MercadoPago Developers Site.

Be part of our community