​
Description

This endpoint transfers a specific amount to a mobile user.

​
Request

POST /transfer

​
Headers

api-key: your_secret_key_here

​
Body

{
    "amount": 112, // int
    "currency": "SSP", // string
    "external_id": "t56", // your unique external id for the transaction
    "customer": {
        "first_name": "John", // string
        "last_name": "Doe", // string
        "phone": "+255712345678" // international format
    },
    "only_fees": false, // if parsed as true, the endpoint will only return the fees for the transaction
    "callback_url": "https://webhook.site/0d2f052f-03b8-4b22-bba0-efc31f3c665c" // string optional
}

​
Response

{
    "status": true,
    "message": "success",
    "data": {
        "id": "TX_q2VolejRejNmGQ", // string
        "amount": 100, // int
        "currency": "SSP", // string
        "status": "pending", // string
        "created_at": "2025-05-20T05:12:57.822Z" // string
    }
}