Server API
Balance & payouts
What Mercestack holds for you, and what has been paid to your bank.
Payments go straight into the workspace's own Bachs account, connected in Settings › Payments, and Bachs pays that account out on its own schedule — Mercestack holds nothing. The balance and payouts here cover only payments taken before a workspace connected its own account: that money is pending for the settlement hold, then available, and the owner requests a payout in Payments → Payouts.
Get your balance
GET
/v1/balanceSecret keypayouts:read
One row per currency.
curl https://api.mercestack.com/v1/balance \
-H "Authorization: Bearer sk_test_…"Response
{
"object": "balance",
"balances": [
{
"currency": "NGN",
"available": "124500.00",
"availableMinor": "12450000",
"pending": "18000.00",
"pendingMinor": "1800000",
"paidOut": "820000.00"
}
]
}List payouts
GET
/v1/payoutsSecret keypayouts:read
requested → processing → paid, or rejected / failed (the amount goes back to your balance).
curl https://api.mercestack.com/v1/payouts \
-H "Authorization: Bearer sk_test_…"Response
{
"object": "list",
"data": [
{
"id": "p_91…",
"amount": "450000.00",
"currency": "NGN",
"status": "paid",
"account": { "bankName": "GTBank", "accountName": "ACME LTD", "accountNumberMasked": "••••6789" },
"paidAt": "2026-09-20T09:00:00.000Z",
"createdAt": "2026-09-19T15:00:00.000Z"
}
],
"hasMore": false,
"nextCursor": null
}