Skip to main content

Send Payment

This api endpoint sends payment to a mobile money subscriber.

HTTP Request

POST
https://tezanetwork.com/api/v1/withdraw

Arguments

Parameter Type Required Description
apikey string Required Account Public key. This is generated for you when you create a business account.
phone string Required The recipient’s mobile money account number to which the money will be sent. Should be internationally formatted. for-example 256701345678
amount decimal Required Amount to be sent to recipient’s mobile money account.
reference string Required A unique generated string to identify your request. A minimum of 8 and maximum of 36 characters is allowed.
description string Optional A description for the request.

Sample send payment request


curl "https://tezanetwork.com/api/v1/withdraw" \
   -X POST \
   -H "Content-Type: application/json" \
   -H "Authorization: Bearer <--Your API Secret Key-->" \
   -d '{
        "apikey": "Pubkey-7d9f2a-4c8e1b-6f0d3e-9a4b7c",
        "reference": "52750b30ffbc7de3b36",
        "phone": "256701345672",
        "amount": 500.00,
        "description": "Send Payment to John Doe."
    }'

Sample response.


{
    "status": "success",
    "message": "Send payment in progress.",
    "phone": "256771234567,
    "payment_method": "mtn",
    "transaction_id": "32QV4VRV70445G",
    "reference_id": "52750b30ffbc7de3b36"
}