Skip to content
Developer
Sign inSign up

Retrieve the fee statement

Get what your business owes 402pay in fees, what's on its way to 402pay, and this month's totals.

What your business owes 402pay in fees, in US dollars, as decimal strings such as "31.40". Fees accrue as payments succeed and as your wallet plan renews each month, and 402pay collects them by sending whole payments to its own address once you owe $25.00. See fees and billing.

Reading the statement first charges any wallet-plan month that came due, so it's never behind. A restricted key needs read access to payments.

Fields

  • owed string
    What you owe now: accrued less collected, plus adjusted. Below zero it's credit against future fees, from an overpayment or a credit 402pay gave.
  • reserved string
    What's on its way to 402pay's address and counts against what you owe: a checkout's whole total once its payment arrives or its card is approved, and what arrived of an underpaid one. A checkout nobody has paid yet holds nothing.
  • accrued string
    Every payment fee and wallet-plan month, all time.
  • collected string
    What reached 402pay's addresses, all time.
  • adjusted string
    Adjustments 402pay made, signed: positive raised what you owe, negative was a credit.
  • this_month object
    period, the current UTC month as YYYY-MM, with what accrued and was collected in it, as decimal strings.
  • collection object
    enabled is whether 402pay collects from this business, threshold what you have to owe before it does, a decimal string, and active whether it's collecting now.
  • pay_now object
    Paying what you owe from the dashboard: amount, what you'd pay (owed less reserved), minimum, the least that can be paid this way, and available, whether you can pay now. Paying takes a dashboard sign-in.

Errors

  • 403 permission_denied
    A restricted key without read access to payments.

Any request can also fail on its key or its body. See errors.

Request
curl "https://api.402pay.co/api/v1/billing/fees" \  -H "Authorization: Bearer $PAY402_SECRET_KEY"
Response200 OK
{  "data": {    "kind": "fee_statement",    "currency": "USD",    "owed": "31.40",    "reserved": "25.00",    "accrued": "102.50",    "collected": "71.10",    "adjusted": "0.00",    "this_month": {      "period": "2026-09",      "accrued": "12.00",      "collected": "25.00"    },    "collection": {      "enabled": true,      "threshold": "25.00",      "active": true    },    "pay_now": {      "available": true,      "amount": "6.40",      "minimum": "1.00"    }  }}