Skip to content

Balance and reports

MethodPathPurpose
GET/v1/accountAccount status, limits and current balance
GET/v1/account/balance-historyEnd-of-day balance, up to 31 days per request
GET/v1/reports/daily-summaryTotals of succeeded payments for a date range, up to 31 days per request

All amounts on this page are in Thai baht (THB).

GET /v1/account
{
"data": {
"object": "account",
"name": "Example Shop",
"status": "active",
"payinsEnabled": true,
"payoutsEnabled": true,
"ipAllowListEnabled": false,
"limits": {
"payinMinimum": "100.00",
"payinMaximum": "50000.00",
"payoutMinimum": "100.00",
"payoutMaximum": "50000.00",
"dailyWithdrawalLimit": "0.00"
},
"balance": { "currency": "THB", "total": "125000.00", "available": "120000.00" },
"createdAt": "2026-01-01T00:00:00.000Z"
},
"requestId": "req_..."
}
FieldDescription
statusPartner account status. If it is not active, every request returns 403 partner_inactive
payinsEnabled, payoutsEnabledWhether pay-ins and payouts are enabled. If not, you get payins_disabled or payouts_disabled
ipAllowListEnabledWhether API calls are restricted to allowed IP addresses
limits.payinMinimum, limits.payinMaximumAmount range of a single pay-in
limits.payoutMinimum, limits.payoutMaximumAmount range of a single payout
limits.dailyWithdrawalLimitMaximum withdrawals per day; "0.00" means no limit
balance.totalTotal balance
balance.availableBalance usable right now for payouts and withdrawals

Check amounts against limits before creating payments to avoid amount_below_minimum and amount_above_maximum.

GET /v1/account/balance-history?from=2026-01-01&to=2026-01-31
ParameterDescription
fromFirst day, YYYY-MM-DD in Thailand time. Default: 6 days before to
toLast day, YYYY-MM-DD. Default: today

Both ends are included; the range is at most 31 days (for example 2026-01-01 to 2026-01-31). Entries are in date order; a day without any ledger entry is omitted.

{
"data": [
{ "date": "2026-01-01", "balance": "118000.00" },
{ "date": "2026-01-02", "balance": "120000.00" }
],
"requestId": "req_..."
}
GET /v1/reports/daily-summary?from=2026-01-01&to=2026-01-31

Takes the same from and to parameters as the balance history.

{
"data": {
"object": "daily_summary",
"from": "2026-01-01",
"to": "2026-01-31",
"currency": "THB",
"payinsSucceeded": "100000.00",
"payoutsSucceeded": "40000.00",
"withdrawalsSucceeded": "20000.00",
"topupsSucceeded": "0.00",
"fees": "1500.00"
},
"requestId": "req_..."
}
FieldDescription
payinsSucceededTotal of succeeded pay-ins
payoutsSucceededTotal of succeeded payouts
withdrawalsSucceededTotal of succeeded withdrawals
topupsSucceededFunds added to your balance by the team
feesTotal fees

The totals cover the whole range, up to 31 days. For longer periods (for example a quarter), request consecutive ranges of up to 31 days and add the results up.

HTTPcodeMeaning
400date_range_too_largeThe range is longer than 31 days
400parameter_invalidMalformed date, or from is after to