Settlement

POST

/settle

Easily Transfer Money directly from one mobile money number to another mobile money phone number

Request

Header Params

Body Params application/x-www-form-urlencoded

Responses

🟢200Settlement Example

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/settle' \
--header 'Accept: application/json' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'to_receiver=09xxxxxxxx' \
--data-urlencode 'auth_id=pub_69b9y3n0h0ydbq' \
--data-urlencode 'amount=1'

Response Example

{
    "is_error": false, 
    "message": "Settlement request initiated",
    "data":{
        "status": "success", 
        "message": "Funds transfered successfully", 
        "reference_id": "st_vd89gdn10d1", 
        "amount": 10.00, 
        "cost": 0.60, 
        "opening_balance": 10250, 
        "closing_balance": 10239.40, 
        "to_receiver": "09xxxxxxxx", 
        "transaction_type": "settlement"
    }
}

Modified at 2025-10-18 16:07:30

Settlements - coming soon

Payment Links - coming soon