5. Topping up the balance
A bank transfer, checked by Tekomata, reported by webhook.
Permissions: billing:readbilling:topup
- 1Your system
GET /v1/billing/balanceThe shop's balance in rupiah, whether it is enough for one AI call, and its plan.
- 2Your system
POST /v1/billing/top-upsSend "amount" (Rp 10.000 to Rp 50.000.000). The response is a request with status awaiting_transfer, with the destination account and a reference code.
- 3Your system
Transfer exactly that amount to that account, with the reference code in the transfer note.
- 4Your system
POST /v1/billing/top-ups/{id}/transferredReport that the transfer has been sent. The status becomes pending.
- 5Tekomata
Tekomata looks for the transfer at the bank. Approved: the balance goes up and webhook top_up.approved. Rejected: top_up.rejected with the reason.
- At most 3 open requests at once. One not yet reported can be cancelled: POST /v1/billing/top-ups/{id}/cancel.
- Buying a plan still happens on the shop's screen.