Billing#

Flasho supports two billing modes. Your mode is set by the Flasho team when your account is created.

PREPAID#

Your wallet is debited immediately when a delivery is booked.

• Wallet balance must cover the estimated delivery fee before a booking is accepted.
• If balance is insufficient the API returns a 400 error.
• Refunds are credited back to your wallet when a delivery is cancelled by Flasho.

POSTPAID#

Used primarily for scheduled deliveries with Pay As You Go settlement.

• On-demand deliveries still debit your wallet immediately.
• Scheduled deliveries may be invoiced at the end of a billing period instead.
• Settlement instructions (bank transfer details) are provided in the paygSettlementInstructions field of the bootstrap response.

Checking your balance#

GET /api/v1/wallet

{
  "balance": "10.000",
  "billingMode": "PREPAID",
  "transactions": [
    {
      "type": "DEBIT",
      "amount": "2.500",
      "reference": "FLH4001",
      "note": "Delivery fee for FLH4001",
      "createdAt": "2026-06-14T01:33:29.698Z"
    }
  ]
}

Transaction types: TOPUP · DEBIT · REFUND

Top-up#

Top up your wallet from the Flasho merchant dashboard via KNET or bank transfer. There is no API endpoint for wallet top-ups.