Developer Portal

Automate with REST APIs & SDKs

Build custom digital payment platforms. Connect directly to our carrier transaction rails with average latency under 150ms.

Authentication

Authenticate your API requests by including your Secret API Key as a Bearer token in the request HTTP header. Keep keys secure; do not share them in frontend repositories or client applications.

AUTHORIZATION HEADER EXAMPLE

Authorization: Bearer fa_sec_live_...

GET

Retrieve Wallet Balance

Fetch current ledger cash balances of your reseller partner profile.

API ENDPOINT REQUEST

curl -X GET https://api.fadigitalservices.com/v1/wallet/balance \
  -H "Authorization: Bearer fa_sec_live_5x8a92..."

HTTP 200 SUCCESS RESPONSE JSON

{
  "status": "success",
  "data": {
    "balance": 1845.50,
    "currency": "GHS",
    "updated_at": "2026-07-08T12:00:00Z"
  }
}

POST

Purchase Utilities

Initiate a data bundle purchase, voice top-up, or educational check pin generation transaction.

API ENDPOINT REQUEST

curl -X POST https://api.fadigitalservices.com/v1/transaction/purchase \
  -H "Authorization: Bearer fa_sec_live_5x8a92..." \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": 102,
    "recipient": "0241234567",
    "request_id": "tx_unique_req_99824"
  }'

POST PAYLOAD PARAMETERS

Key	Type	Status	Description
service_id	integer	REQUIRED	ID of the bundle or bill product. See services list.
recipient	string	REQUIRED	Carrier phone number (+233 format) or utility meter account ID.
request_id	string	REQUIRED	Unique reference string for idempotency audits to prevent duplicates.

Gateway Details

Base API URLhttps://api.fadigitalservices.com/v1

Response FormatJSON (Content-Type: application/json)

API Rate Limiting120 requests per minute

Need SDK access?

Download official wrapper scripts for Node.js, PHP, and Python to integrate inside your project with three lines of code.

Request SDK Keys