KiNG FLEXY GH
Developer API

List all available data packages with pricing for your account role. Call this first to discover valid network and size combinations.

{
  "success": true,
  "data": {
    "packages": [
      {
        "id": "uuid-...",
        "network": "MTN",
        "size": "5GB",
        "volume_gb": 5,
        "price": 4.50,
        "currency": "GHS"
      }
    ],
    "total": 12
  }
}

• →Price is your role-specific price (agent, dealer, or standard customer).
• →Only packages with is_available = true are returned.
• →Use this to validate network/size combinations before placing orders.

# All packages
curl -X GET https://api.kingflexygh.com/api/v2/packages \
  -H "Authorization: kf_live_your_api_key_here"

# Filter by network
curl -X GET "https://api.kingflexygh.com/api/v2/packages?network=MTN" \
  -H "Authorization: kf_live_your_api_key_here"

# Filter by network + size
curl -X GET "https://api.kingflexygh.com/api/v2/packages?network=MTN&size_gb=5" \
  -H "Authorization: kf_live_your_api_key_here"

Purchase a single data bundle for a recipient phone number. Deducts from your wallet instantly.

{
  "network": "MTN",
  "volume_gb": 5,
  "recipient": "0551617309",
  "reference": "order_001"
}

{
  "success": true,
  "data": {
    "order_id": "uuid-...",
    "reference": "order_001",
    "status": "pending",
    "network": "MTN",
    "size": "5GB",
    "recipient": "0551617309",
    "price": 4.50,
    "new_balance": 120.50
  }
}

• →reference is your idempotency key — sending the same reference twice returns the existing order without double-charging.
• →status is usually "pending", but MAY be "queued" if the recipient number still needs registration on our network — it auto-releases to pending and is fulfilled shortly after. Poll GET /api/v2/orders/{reference} to track it.
• →MTN purchases MAY also return 409 if the recipient number isn't yet whitelisted with our supplier (only applies when this optional gate is enabled by an admin) — message reads "This number isn't yet registered to receive MTN data. Please try again in 24 hours." Retrying after ~24 hours usually succeeds once the number is whitelisted.
• →network must be one of: MTN, Telecel, AT-iShare, AT-BigTime (case-sensitive).
• →volume_gb must match an available package. Use GET /packages to confirm.
• →recipient must be a valid Ghana number: 0XXXXXXXXX (10 digits, starts with 0).

curl -X POST https://api.kingflexygh.com/api/v2/data/purchase \
  -H "Authorization: kf_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "network": "MTN",
    "volume_gb": 5,
    "recipient": "0551617309",
    "reference": "order_001"
  }'

Purchase up to 100 data bundles in a single batch. A validation failure (invalid network, package not found, out of stock) rejects the whole batch and nothing is charged; the one exception is MTN recipients not yet whitelisted with our supplier — those orders are skipped individually while the rest of the batch is placed and charged normally.

{
  "orders": [
    {
      "network": "MTN",
      "volume_gb": 5,
      "recipient": "0551617309",
      "reference": "b_001"
    },
    {
      "network": "Telecel",
      "volume_gb": 2,
      "recipient": "0201234567",
      "reference": "b_002"
    }
  ]
}

{
  "success": true,
  "data": {
    "orders_placed": 2,
    "total_cost": 7.00,
    "new_balance": 113.50,
    "orders": [
      { "order_id": "...", "reference": "b_001", "status": "pending" }
    ],
    "skipped": []
  }
}

• →Maximum 100 orders per batch request.
• →Still atomic for network/package validation failures (invalid network, package not found, out of stock) — one bad order in the array rejects the whole batch and nothing is charged.
• →MTN orders to a recipient not yet whitelisted with our supplier are the one exception: they are skipped individually — not charged, not created — while the rest of the batch is placed normally. Only applies when this optional gate is enabled by an admin.
• →skipped is an array of { recipient, reason }, one entry per order skipped for the whitelist reason above — cross-reference it against your original orders array since skipped orders have no reference or order_id.
• →Each order in the array follows the same rules as single purchase.

curl -X POST https://api.kingflexygh.com/api/v2/data/bulk \
  -H "Authorization: kf_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "orders": [
      {"network":"MTN","volume_gb":5,"recipient":"0551617309","reference":"b_001"},
      {"network":"Telecel","volume_gb":2,"recipient":"0201234567","reference":"b_002"}
    ]
  }'

Retrieve your current wallet balance in GHS. Use before large orders to verify you have sufficient funds.

{
  "success": true,
  "data": {
    "balance": 124.50,
    "currency": "GHS"
  }
}

• →Top up your wallet via the web dashboard at kingflexygh.com/dashboard/wallet.
• →Check balance before bulk orders to prevent partial failures due to insufficient funds.

curl -X GET https://api.kingflexygh.com/api/v2/wallet/balance \
  -H "Authorization: kf_live_your_api_key_here"

Check the fulfillment status of an order using the reference code you provided when placing it.

{
  "success": true,
  "data": {
    "order_id": "uuid-...",
    "reference": "order_001",
    "status": "completed",
    "network": "MTN",
    "size": "5GB",
    "recipient": "0551617309",
    "price": 4.50,
    "source": "api",
    "created_at": "2026-..."
  }
}

• →Use the same reference you passed when calling /data/purchase or /data/bulk.
• →Status lifecycle: pending | queued → processing → completed | failed | refunded.
• →pending — order accepted and awaiting dispatch to the network.
• →queued — the recipient MTN number is not yet registered with our network provider, so the order is held (not dispatched); it auto-releases to pending and is fulfilled once registration completes, usually within a short period.
• →processing — dispatched to the network and being fulfilled.
• →completed — bundle delivered successfully.
• →failed — the order could not be fulfilled.
• →refunded — the order was refunded to your wallet / original payment method.
• →Poll this endpoint after placing an order to confirm delivery.

curl -X GET https://api.kingflexygh.com/api/v2/orders/your_reference_here \
  -H "Authorization: kf_live_your_api_key_here"

Returns your current role and, for dealer/agent, the days remaining before it lapses.

{
  "success": true,
  "data": {
    "role": "dealer",
    "is_active": true,
    "is_permanent": false,
    "expires_at": "2026-...",
    "days_remaining": 12
  }
}

• →is_permanent: true and expires_at: null means a lifetime dealer/agent, or a plain customer account — there is nothing to expire.
• →is_active becomes false the moment expires_at passes, even though role in the users table has not changed yet — the platform prices you as a customer from that exact moment on every endpoint, not just this one.
• →Rate limit: 30/min.

curl -X GET https://api.kingflexygh.com/api/v2/account/role \
  -H "Authorization: kf_live_your_api_key_here"

Send airtime to a beneficiary at face value from your wallet. Auto-dispatches in the background — poll GET /airtime/orders/{reference} for the final status.

{
  "network": "MTN",
  "beneficiary_phone": "0551617309",
  "amount": 10,
  "reference": "air_001"
}

{
  "success": true,
  "data": {
    "order_id": "uuid-...",
    "reference": "air_001",
    "status": "pending",
    "network": "MTN",
    "beneficiary_phone": "0551617309",
    "airtime_amount": 10,
    "fee_amount": 0,
    "total_paid": 10,
    "new_balance": 90
  }
}

• →reference is your idempotency key (3–100 chars) — a repeat with the SAME reference and body returns the existing order instead of charging again; a reused reference against a DIFFERENT order returns 409 and your wallet is not charged.
• →fee_amount is always 0 — the beneficiary receives the full amount at face value; your earnings come from a share of KiNG FLEXY GH's own provider commission, credited to your Commission Wallet once the order completes, not deducted from this transaction.
• →Rate limit: 10/min.

curl -X POST https://api.kingflexygh.com/api/v2/airtime/purchase \
  -H "Authorization: kf_cs_live_your_commission_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "network": "MTN",
    "beneficiary_phone": "0551617309",
    "amount": 10,
    "reference": "air_001"
  }'

List your most recent airtime orders.

{
  "success": true,
  "data": {
    "orders": [ { "order_id": "uuid-...", "reference": "air_001", "status": "completed", "network": "MTN", "airtime_amount": 10 } ]
  }
}

• →Returns at most 30 records, newest first. Rate limit: 30/min.

curl -X GET https://api.kingflexygh.com/api/v2/airtime/orders \
  -H "Authorization: kf_cs_live_your_commission_key_here"

Check the status of one airtime order using the reference you sent when placing it.

{
  "success": true,
  "data": {
    "order_id": "uuid-...",
    "reference": "air_001",
    "status": "refunded",
    "network": "MTN",
    "beneficiary_phone": "0551617309",
    "airtime_amount": 10,
    "reason": "The transaction could not be completed by the payment provider."
  }
}

• →Rate limit: 30/min.
• →Status flow: pending → processing → completed | failed | refunded. A definitive provider failure auto-refunds your wallet — status becomes "refunded" and `reason` is present with a short, fixed explanation (never raw provider text).

curl -X GET https://api.kingflexygh.com/api/v2/airtime/orders/air_001 \
  -H "Authorization: kf_cs_live_your_commission_key_here"

List available voucher types with YOUR OWN role-based price and current stock.

{
  "success": true,
  "data": {
    "types": [ { "type_id": "uuid-...", "name": "WAEC BECE", "price": 18, "available_count": 412, "is_active": true } ]
  }
}

• →Rate limit: 30/min.

curl -X GET https://api.kingflexygh.com/api/v2/resultschecker/types \
  -H "Authorization: kf_live_your_api_key_here"

Buy voucher(s). Stock is checked BEFORE your wallet is touched — insufficient stock is rejected upfront, never charged then refunded.

{
  "typeId": "uuid-of-a-type-from-GET-types",
  "quantity": 1,
  "reference": "rc_001",
  "recipientPhone": "0551617309",
  "recipientEmail": "customer@example.com"
}

{
  "success": true,
  "data": {
    "order": { "id": "uuid-...", "reference": "rc_001", "status": "completed", "type_name": "WAEC BECE", "quantity": 1, "unit_price": 18, "total_paid": 18 },
    "vouchers": [ { "id": "uuid-...", "pin": "1234-5678-9012", "serial_number": "SN-000123" } ],
    "new_balance": 82
  }
}

• →recipientPhone / recipientEmail are OPTIONAL. Pass either (or both) to also have KiNG FLEXY GH deliver the voucher by SMS/email as a courtesy — the vouchers array in this response is always the authoritative copy either way.
• →reference is your idempotency key — a reused reference against a different order returns 409, wallet untouched.
• →Rate limit: 10/min.

curl -X POST https://api.kingflexygh.com/api/v2/resultschecker/purchase \
  -H "Authorization: kf_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "typeId": "uuid-of-a-type-from-GET-types",
    "quantity": 1,
    "reference": "rc_001"
  }'

List your most recent results checker orders.

{
  "success": true,
  "data": {
    "orders": [ { "id": "uuid-...", "reference": "rc_001", "status": "completed", "type_name": "WAEC BECE", "quantity": 1 } ]
  }
}

• →Returns at most 30 records, newest first. Rate limit: 30/min.

curl -X GET https://api.kingflexygh.com/api/v2/resultschecker/orders \
  -H "Authorization: kf_live_your_api_key_here"

Look up one order, including its vouchers again if you need to recover them.

{
  "success": true,
  "data": {
    "order": { "id": "uuid-...", "reference": "rc_001", "status": "completed" },
    "vouchers": [ { "id": "uuid-...", "pin": "1234-5678-9012", "serial_number": "SN-000123" } ]
  }
}

• →Rate limit: 30/min.

curl -X GET https://api.kingflexygh.com/api/v2/resultschecker/orders/rc_001 \
  -H "Authorization: kf_live_your_api_key_here"

Submit an AFA registration. Requires a valid Ghana Card and a supported region.

{
  "reference": "afa_001",
  "full_name": "Kwame Mensah",
  "phone": "0551617309",
  "id_type": "Ghana Card",
  "id_number": "GHA-123456789-0",
  "date_of_birth": "1995-04-12",
  "region": "Greater Accra",
  "location": "Madina"
}

{
  "success": true,
  "data": {
    "order_id": "uuid-...",
    "reference": "afa_001",
    "status": "pending",
    "new_balance": 64.0
  }
}

• →id_type must be exactly "Ghana Card"; id_number must match GHA-XXXXXXXXX-X.
• →region must be one of the 16 official Ghana regions (Greater Accra, Ashanti, Western, Eastern, Central, Northern, Volta, Upper East, Upper West, Bono, Bono East, Ahafo, Savannah, North East, Oti, Western North).
• →Applicant must be 18 or older — computed from date_of_birth.
• →reference is your idempotency key. It is GLOBAL across all developers, not just your own account — a reused reference already taken by anyone returns 409, never a silent success.
• →This carries Ghana Card KYC data — send it only over HTTPS, which is all this API accepts.
• →Rate limit: 10/min.

curl -X POST https://api.kingflexygh.com/api/v2/afa/register \
  -H "Authorization: kf_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "reference": "afa_001",
    "full_name": "Kwame Mensah",
    "phone": "0551617309",
    "id_type": "Ghana Card",
    "id_number": "GHA-123456789-0",
    "date_of_birth": "1995-04-12",
    "region": "Greater Accra",
    "location": "Madina"
  }'

List your most recent AFA registrations.

{
  "success": true,
  "data": {
    "orders": [ { "id": "uuid-...", "reference": "afa_001", "status": "pending" } ]
  }
}

• →Returns at most 30 records, newest first. Rate limit: 30/min.

curl -X GET https://api.kingflexygh.com/api/v2/afa/orders \
  -H "Authorization: kf_live_your_api_key_here"

Check the status of one AFA registration.

{
  "success": true,
  "data": {
    "id": "uuid-...",
    "reference": "afa_001",
    "status": "processing"
  }
}

• →Status lifecycle: pending → processing → completed | cancelled.
• →Rate limit: 30/min.

curl -X GET https://api.kingflexygh.com/api/v2/afa/orders/afa_001 \
  -H "Authorization: kf_live_your_api_key_here"

Send an SMS to one or many recipients. Small sends (≤500 recipients) dispatch immediately and return per-send results; larger sends are queued and processed within a minute.

{
  "message": "Your order #123 is ready. Thank you!",
  "recipients": ["0551234567", "0209876543"],
  "sender": "AcmeGH",
  "reference": "order-123"
}

{
  "success": true,
  "data": {
    "campaignId": "uuid-...",
    "status": "completed",
    "recipients": 2,
    "segments": 1,
    "creditsCharged": 2,
    "sender": "AcmeGH",
    "sent": 2,
    "failed": 0,
    "balance": 498
  }
}

• →message: 3–1000 characters. Cost = SMS segments × recipients (GSM-7: 160 chars = 1 segment; unicode/emoji reduce this to 70).
• →recipients: a string or array of Ghana numbers (0XXXXXXXXX or 233XXXXXXXXX), up to 10,000 per call. Duplicates are removed automatically.
• →sender is optional — defaults to your account's sending identity. It MUST be one of your approved sender IDs or a pool sender (call GET /sms/senders); any other value is rejected with 400.
• →reference is an optional idempotency key (≤100 chars): retrying with the same reference returns the original campaign instead of sending again or double-charging.
• →Credits are debited up-front; provider-rejected messages are refunded automatically when the campaign settles.
• →Content policy: telco transaction-message impersonation (fake MoMo receipts etc.) is blocked. Links to any domain are allowed for business accounts.
• →HTTP 402 = insufficient SMS credits. HTTP 403 = wrong key type (use your SMS API key, not your general developer key) or account suspended. HTTP 429 = rate limited.

curl -X POST https://api.kingflexygh.com/api/v2/sms/send \
  -H "Authorization: kf_sms_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Your order #123 is ready for pickup. Thank you!",
    "recipients": ["0551234567", "0209876543"],
    "sender": "AcmeGH"
  }'

List the sender IDs this API key may send under — your approved own sender IDs plus the shared pool senders. Use these exact values for the sender field.

{
  "success": true,
  "data": {
    "mode": "business",
    "defaultSender": "AcmeGH",
    "senders": [
      { "sender": "AcmeGH", "type": "own", "isDefault": true },
      { "sender": "KFT SMS", "type": "pool", "isDefault": false }
    ]
  }
}

• →type "own" = a sender ID approved for your business; "pool" = a shared platform sender any approved business may use.

curl -X GET https://api.kingflexygh.com/api/v2/sms/senders \
  -H "Authorization: kf_sms_live_your_api_key_here"

Delivery status for a send. Returns the campaign summary, a delivery rollup, and per-recipient statuses (100 per page).

{
  "success": true,
  "data": {
    "campaign": {
      "id": "uuid-...",
      "sender_used": "AcmeGH",
      "recipients_count": 2,
      "segments": 1,
      "credits_charged": 2,
      "status": "completed",
      "created_at": "2026-..."
    },
    "delivery": { "delivered": 2 },
    "messages": [
      {
        "recipient": "233551234567",
        "status": "delivered",
        "status_updated_at": "2026-..."
      }
    ],
    "page": 0
  }
}

• →Use the campaignId returned by POST /sms/send.
• →Message statuses: queued → sent → delivered | undelivered | expired | rejected. failed = rejected by the provider at send time (refunded).
• →Delivery reports arrive asynchronously from the network — poll this endpoint a few minutes after sending for final statuses.

curl -X GET "https://api.kingflexygh.com/api/v2/sms/messages/your_campaign_id?status=delivered" \
  -H "Authorization: kf_sms_live_your_api_key_here"

List your recent SMS campaigns, newest first — a discovery endpoint that complements GET /sms/messages/{campaignId} for when you don't already have a campaign id on hand.

{
  "success": true,
  "data": {
    "campaigns": [
      {
        "id": "uuid-...",
        "status": "completed",
        "recipients_count": 2,
        "segments": 1,
        "credits_charged": 2,
        "sender_used": "AcmeGH",
        "source": "api",
        "scheduled_at": null,
        "created_at": "2026-..."
      }
    ],
    "page": 0
  }
}

• →Returns 30 campaigns per page, newest first — pass page to walk further back, not to raise the page size.
• →Use the returned id with GET /sms/messages/{campaignId} for per-recipient delivery detail.

curl -X GET "https://api.kingflexygh.com/api/v2/sms/campaigns?status=completed" \
  -H "Authorization: kf_sms_live_your_api_key_here"

Your SMS credit balance and account mode.

{
  "success": true,
  "data": {
    "credits": 498,
    "totalPurchased": 600,
    "totalUsed": 102,
    "mode": "business",
    "accountStatus": "active"
  }
}

• →SMS credits are separate from your GHS wallet — buy bundles at kingflexygh.com/dashboard/sms/credits.
• →Check balance before large campaigns; sends fail with HTTP 402 when credits are insufficient.

curl -X GET https://api.kingflexygh.com/api/v2/sms/balance \
  -H "Authorization: kf_sms_live_your_api_key_here"

Full biller catalog for utility bill payments — including currently disabled billers, so you can build your UI without hardcoding which ones are live.

{
  "success": true,
  "data": {
    "billers": [
      {
        "key": "ecg",
        "label": "ECG Prepaid & Postpaid",
        "enabled": true,
        "account_label": "Meter number",
        "requires_phone": true,
        "lookup_by": "phone",
        "links_phone_to_account": true,
        "has_amount_due": true
      },
      {
        "key": "dstv",
        "label": "DSTV",
        "enabled": true,
        "account_label": "Smartcard number",
        "requires_phone": false,
        "lookup_by": "account",
        "links_phone_to_account": false,
        "has_amount_due": true
      }
    ],
    "min_amount": 1,
    "max_amount": 1000,
    "currency": "GHS"
  }
}

• →key values are: ecg, ghana_water, dstv, gotv, startimes — pass this exact string as biller on /lookup and /pay.
• →enabled is false for a biller currently switched off by an admin — still listed so your UI can grey it out instead of guessing.
• →lookup_by tells you which field ecg needs on /lookup ("phone") vs every other biller ("account").
• →requires_phone — whether /pay requires a customer phone for this biller (ecg, ghana_water). Note: /lookup accepts account alone for ecg (phone optional there).
• →links_phone_to_account is true only for ecg — one phone can be linked to more than one meter, so always let the customer pick from the meters array /lookup returns.
• →min_amount / max_amount are the live, admin-configurable limits enforced by /pay — read them from here instead of hardcoding GHS 1–1000.

curl -X GET https://api.kingflexygh.com/api/v2/utilities/billers \
  -H "Authorization: kf_cs_live_your_commission_key_here"

Verify an account before paying. Always show your customer the returned name (or, for ECG, the linked meters) and get their confirmation before calling /pay.

{
  "success": true,
  "data": {
    "account_name": "KWAME MENSAH",
    "account_number": "7041234567",
    "amount_due": 245.80,
    "bouquet": null,
    "meters": []
  }
}

• →ECG's shape differs from every other biller: account_name, account_number, amount_due and bouquet are always null — the real result is meters: [{ "name": "KWAME MENSAH", "meterNumber": "3701234567", "outstanding": 245.8 }, ...]. One phone can list several meters; let the customer choose the right one.
• →amount_due can be negative — that means the customer has a credit balance, not a bill due.
• →404 = account/meter/smartcard not found (bad number). 502 = the billing provider is temporarily unreachable — retry shortly, do not treat as "not found".

# DSTV — query by smartcard number
curl -X GET "https://api.kingflexygh.com/api/v2/utilities/lookup?biller=dstv&account=7041234567" \
  -H "Authorization: kf_cs_live_your_commission_key_here"

# ECG — query by phone (account is still required; pass the same number)
curl -X GET "https://api.kingflexygh.com/api/v2/utilities/lookup?biller=ecg&phone=0551617309&account=0551617309" \
  -H "Authorization: kf_cs_live_your_commission_key_here"

Pay a bill at face value from your wallet. Auto-dispatches to the biller in the background — poll GET /orders/{reference} for the final status.

{
  "biller": "dstv",
  "account": "7041234567",
  "amount": 65.00,
  "reference": "bill_dstv_7041234567_01"
}

{
  "success": true,
  "data": {
    "reference": "UTIL-DSTV-3f9a2b1c4d5e6f70",
    "order_id": "uuid-...",
    "status": "pending",
    "biller": "dstv",
    "account": "7041234567",
    "amount": 65.00,
    "commission_share_percent": 40,
    "new_balance": 435.00
  }
}

• →reference is a pure idempotency key — see the callout above. It is optional, 1–64 chars of letters, numbers, dot, underscore or hyphen.
• →Save the reference from the RESPONSE, not the one you sent — it is our own generated code (UTIL-<BILLER>-<random>) and is what GET /orders/{reference} expects.
• →On an idempotent replay (reused reference), the response is smaller: { reference, order_id, status, already_processed: true } — no biller/account/amount/commission_share_percent/new_balance, since nothing new happened.
• →phone is required for ecg and ghana_water (omit for dstv/gotv/startimes). For ecg, account is the specific meter number from the /lookup meters array — not the phone.
• →amount must be within the live min_amount/max_amount from GET /billers (defaults GHS 1.00–1000.00).
• →Without a reference, sending the same biller + account + amount twice within 30 seconds is rejected with 409. If your first request timed out, reuse that request's original reference — you'll get the original order back via idempotent replay. A new reference does not bypass the 30-second window; genuinely distinct same-amount payments to the same account must wait it out.
• →commission_share_percent is your cut of the platform commission (admin-configurable) — it is credited to your Commission Wallet once the order completes, not at response time.

# DSTV — account-only biller
curl -X POST https://api.kingflexygh.com/api/v2/utilities/pay \
  -H "Authorization: kf_cs_live_your_commission_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "biller": "dstv",
    "account": "7041234567",
    "amount": 65.00,
    "reference": "bill_dstv_7041234567_01"
  }'

# ECG — account is the METER (from lookup meters[]), phone is required too
curl -X POST https://api.kingflexygh.com/api/v2/utilities/pay \
  -H "Authorization: kf_cs_live_your_commission_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "biller": "ecg",
    "account": "3701234567",
    "phone": "0551617309",
    "amount": 50.00,
    "reference": "bill_ecg_3701234567_01"
  }'

Poll the fulfillment status of a utility bill order using the reference from the /pay response. Only returns orders that belong to your own account.

{
  "success": true,
  "data": {
    "reference": "UTIL-DSTV-3f9a2b1c4d5e6f70",
    "status": "refunded",
    "payment_status": "paid",
    "biller": "dstv",
    "account_number": "7041234567",
    "account_name": "KWAME MENSAH",
    "amount": 65.00,
    "commission_earned": null,
    "reason": "The transaction could not be completed by the payment provider.",
    "created_at": "2026-...",
    "updated_at": "2026-..."
  }
}

• →Status flow: pending → processing → completed | failed | refunded.
• →The account field here is called account_number — not account as in the /pay request body. Same value, different key name across endpoints.
• →commission_earned is null until the order reaches completed — it is your realized share of the commission, credited to your Commission Wallet at that point.
• →A definitive provider failure auto-refunds your wallet — status becomes "refunded" and reason is present with a short, fixed explanation (never raw provider text).
• →Poll every few seconds after /pay until status leaves pending / processing.

curl -X GET https://api.kingflexygh.com/api/v2/utilities/orders/UTIL-DSTV-3f9a2b1c4d5e6f70 \
  -H "Authorization: kf_cs_live_your_commission_key_here"