Skip to main content
GET
Get merchant balance

Overview

Returns your current merchant balances. The response includes the USD collection balance and withdrawal balances for USD, NGN, SOL, and BNB. The collection balance can be transferred to the USD withdrawal balance through the balance transfer endpoint. Merchant funding deposits go directly to a withdrawal balance. NGN deposits credit withdrawal_balance_usd under the default USD_BALANCE preference, or withdrawal_balance_ngn when the merchant selects NGN_BALANCE.

Authentication

string
required
Your merchant API key

Request Examples

Response

object
Current merchant balance details.

Success Response

Error Responses

This endpoint may return:
  • 401: Unauthorized
  • 500: Internal server error

Next Steps

Transfer Balance

Move funds from collection to withdrawal balance

Withdraw Balance

Transfer withdrawal balance to an on-chain address

Merchant Funding

View funding instructions to top up your balance