Korba Xchange API

The Korba Xchange REST API gives your application programmatic access to payment collections, disbursements, airtime, data bundles, utility payments, and transaction reporting through a consistent JSON interface.

Requests are authenticated with HMAC-SHA256. Include your numeric client_id in request bodies that require it, and send Authorization: HMAC client_key:signature on authenticated API calls.

Base URL

Available Services

Quick Start

This example starts a mobile money collection. Build the HMAC signature from the sorted request body fields and send it in the Authorization header.

curl -X POST "https://testxchange.korba365.com/api/v1.0/collect/" \
  -H "Content-Type: application/json" \
  -H "Authorization: HMAC YOUR_CLIENT_KEY:YOUR_SIGNATURE" \
  -d '{
    "amount": "1.00",
    "callback_url": "https://yourapp.com/callbacks/collections/",
    "client_id": 2,
    "customer_number": "0241234567",
    "description": "Test collection",
    "network_code": "MTN",
    "transaction_id": "TXN-001"
  }'

{
  "success": true,
  "results": "Transaction initiated successfully. Please Check Phone for prompt",
  "error_code": null
}