Currency Conversion

With a single endpoint, you can convert between any two available currencies.

Header	Value
Authorization	Bearer SECRET_KEY
Content-Type	application/json

The secret key can be gotten from the 'Settings' page on your Startbutton dashboard.

See Authentication.

Endpoint

POST: {{baseurl}}/transaction

Param	Required?	Description
"fromCurrency"	Yes	This is the currency you want to convert "from"
"fromAmount"	Yes	This is the amount you want to convert "from"
"fromWalletType"	Yes	This could be either "payout" or "collection"
"toCurrency"	Yes	This is the currency you want to convert "to"

Sample code

Required Param

{
    "fromAmount": 2,
    "toCurrency": "NGN",
    "fromCurrency": "USD",
    "fromWalletType": "payout"
}

Sample responses

Success

{ 
    "success": true, 
    "message": "new transaction initialized", 
    "data": [
        { 
            "conversionTimeInHours": 24, 
            "transactionReference": "77e27b0d16c8", 
            "status": "initiated" 
        } 
    ] 
}

Insufficient balance

{ 
"success": false, 
"message": "User has insufficient balance.", 
"data": {} 
}

Webhook for Conversions

To learn how webhooks work, see Conversion Events.