CyberGift — Gift Cards, Airtime & Bills API

/gift/* (Service API)

Gift card purchases, mobile airtime top-up, and bill payments.

Gift Cards

Query Available Gift Cards

GET /gift/giftcards/products?country={code}

Parameter	Type	Description
`country`	`string`	Country code, default `US`

Purchase Gift Card

POST /gift/giftcards/order

{
  "productId": 123,
  "countryCode": "US",
  "quantity": 1,
  "unitPrice": 25,
  "customIdentifier": "order-001",
  "senderName": "CyberPay",
  "recipientEmail": "user@example.com"
}

Airtime Top-Up

Auto-Detect Carrier

GET /gift/airtime/detect?phone={number}&country={code}

Parameter	Type	Description
`phone`	`string`	Phone number
`country`	`string`	Country code

Top Up

POST /gift/airtime/topup

{
  "operatorId": 456,
  "amount": 10,
  "useLocalAmount": false,
  "customIdentifier": "topup-001",
  "recipientPhone": { "countryCode": "US", "number": "2025551234" }
}

Bill Payments

Query Billers

GET /gift/utilities/billers?country={code}&type={type}

Parameter	Type	Description
`country`	`string`	Optional, country code
`type`	`string`	Optional, bill type

Pay Bill

POST /gift/utilities/pay

{
  "subscriberAccountNumber": "1234567890",
  "amount": 50,
  "billerId": 789,
  "useLocalAmount": true
}

Query Balance

GET /gift/balance

Returns the service account balance.

{
  "balance": 1250.50,
  "currencyCode": "USD",
  "currencyName": "US Dollar",
  "updatedAt": "2026-03-23T12:00:00Z"
}