Topup Fiat

POST

/partners/transactions/topup-fiat

Creates a topup request that collects fiat from the user through Unipesa and, once approved, sends the crypto equivalent from the partner’s Safe to the destination wallet. Inputs include from_currency, to_currency, amount, phone_number, wallet_address, and callback_url. The flow performs balance checks, applies partner fees, and triggers callbacks after completion.

Request

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Successful Response

Body

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/partners/transactions/topup-fiat' \
--header 'Content-Type: application/json' \
--data-raw '{
    "from_currency": "KES",
    "to_currency": "USDC",
    "amount": 0,
    "phone_number": "string",
    "wallet_address": "string",
    "callback_url": "string"
}'

Response Example

200 - Example 1

null

Modified at 2025-12-09 11:22:16

Witdraw Fiat Callback

Topup Fiat Status