Retrieve your 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.
bearerAuthAuthorizationBearer <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>.
Current balances.
application/json- response
statusCode*integermessage*stringdata*curl -X GET 'https://sandbox-api.fastrac.example/b2b/user-balance'{ "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.