merce.STACK
merce.STACK
Skip to content
PricingWhat's new
Log inGet started
{}Developers
GuidesAPI referenceChangelogGet API keys →
  • Get started

    • Quickstart
    • Keys & authentication
  • Storefront

    • Products & catalog
    • Carts
    • Checkout & payment
    • Customer accounts
    • Digital products
    • Without a build step
    • Bookings
    • Courses
    • Drop-in components
  • Server API

    • Server API
    • Customers
    • Payment links & transactions
    • Balance & payouts
    • Classes & students
    • Node SDK
  • Email API

    • Email API
    • Sending email
    • Delivery events
  • Events & errors

    • Webhooks
    • Errors
  • Reference

    • API reference
    • Changelog

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.

Payouts settle asynchronously

An accepted payout is still processing. Treat payout.paid as confirmation; a failed payout returns the reserved amount to the workspace ledger.

Get your balance

GET/v1/balance
Secret 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/payouts
Secret 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
}
← PreviousPayment links & transactionsNext →Classes & students

On this page

  • GETGet your balance
  • GETList payouts
Create a workspaceTalk to usPricing

One workspace for everything your business runs on — your team, customers, store, marketing and payouts in one place.

Get started

Product

  • All products
  • Pricing
  • What's new
  • Security

Resources

  • Documentation
  • Guides
  • Use cases
  • Blog
  • Get support

Company

  • About
  • Careers
  • Contact us
  • Talk to the team

Legal

  • Privacy
  • Terms
  • Cookie policy
  • GDPR
  • Report a vulnerability

© 2026 Mercestack. All rights reserved.

Mercestack StructureOS

mercestack