Skip to Content
FastracDocs
API reference

Retrieve your balance

GET
/b2b/user-balance

Returns your four balance pockets in whole Rupiah. Orders are paid from shippingCredit; check it before you create orders in bulk. Top-ups are done in the Fastrac dashboard, not through the API.

Any valid API key can call it; no extra permission is needed.

Authorization

bearerAuth
headerAuthorizationBearer <token>

An access token from the OAuth2 client-credentials grant. Exchange your API key (client_id + client_secret) at the token endpoint and send Authorization: Bearer <access_token>.

Response Body

Current balances.

application/json
  1. response
statusCode*integer
message*string
data*
Example Request
curl -X GET 'https://sandbox-api.fastrac.example/b2b/user-balance'
Example Response
{  "statusCode": 200,  "message": "Request successful.",  "data": {    "balance": {      "point": 0,      "shippingCredit": 1487016,      "payoutBalance": 325000,      "referralBalance": 0    },    "timestamp": "2026-11-20T03:30:00.000Z"  }}

Was this page helpful?

Simulate a status (sandbox only) POST

**Sandbox only.** Production returns `403`. Pretends that the courier reported an event for one of your sandbox shipments, so you can test your webhook handler and status logic end to end without waiting for a real courier. Use a shipment that already has an airway bill. | `status` | Webhook sent | Effect on the shipment | | --- | --- | --- | | `DRIVER_ASSIGNED` | `shipment.pending_pickup` | Sample driver details are attached | | `TRANSIT` | `shipment.in_transit` | Status becomes `IN_TRANSIT` | | `DELIVERED` | `shipment.delivered` | Status becomes `DELIVERED` | | `CANCELLED` | none (use **Cancel a shipment** to receive `shipment.cancelled`) | Status becomes `CANCELLED` and the shipment is refunded | | `RTS` | `shipment.rts_billed` if a return fee applies | Status becomes `RTS_DELIVERED` (returned to the sender) | | `AIRWAYBILL_UPDATED` | `shipment.airway_bill_updated` | The airway bill is replaced by a `SIM-…` number | | `PRICE_CHANGED` | `shipment.price_changed` | None: webhook only, sample values (Rp 10.000 → Rp 15.000) | | `WEIGHT_CHANGED` | `shipment.measurement_changed` | None: webhook only, sample values | | `RTS_BILLED` | `shipment.rts_billed` | None: webhook only, sample fee Rp 15.000 | Requires the `CANCEL_ORDER` permission.

List balance logs GET

Lists every credit and debit on your balance, newest first: order payments, refunds of cancelled shipments, price adjustments, return (RTS) fees, COD proceeds and top-ups. Use it to reconcile your balance with your own records. Any valid API key can call it; no extra permission is needed.