Get fees breakdown
curl --request POST \
--url https://api-prod.blaaiz.com/api/external/fees/breakdown \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"from_currency_id": "NGN",
"to_currency_id": "NGN",
"from_amount": 50000
}
'import requests
url = "https://api-prod.blaaiz.com/api/external/fees/breakdown"
payload = {
"from_currency_id": "NGN",
"to_currency_id": "NGN",
"from_amount": 50000
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({from_currency_id: 'NGN', to_currency_id: 'NGN', from_amount: 50000})
};
fetch('https://api-prod.blaaiz.com/api/external/fees/breakdown', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));require 'uri'
require 'net/http'
url = URI("https://api-prod.blaaiz.com/api/external/fees/breakdown")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"from_currency_id\": \"NGN\",\n \"to_currency_id\": \"NGN\",\n \"from_amount\": 50000\n}"
response = http.request(request)
puts response.read_body<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-prod.blaaiz.com/api/external/fees/breakdown",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'from_currency_id' => 'NGN',
'to_currency_id' => 'NGN',
'from_amount' => 50000
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"our_fee": 1.5,
"collection_fees": [
{
"method": "CARD",
"amount": 2,
"fee": 2,
"you_send": 100,
"total_amount_to_send": 96.5,
"recipient_gets": 58000,
"our_fee": 1.5,
"total_fees": 3.5,
"amountIsRecipientGets": false,
"amountIsYouSend": true,
"rate": 600.5
},
{
"method": "OPEN_BANKING",
"amount": 0.5,
"fee": 0.5,
"you_send": 100,
"total_amount_to_send": 98,
"recipient_gets": 58900,
"our_fee": 1.5,
"total_fees": 2,
"amountIsRecipientGets": false,
"amountIsYouSend": true,
"rate": 600.5
}
],
"payout_fees": [
{
"method": "BANK_TRANSFER",
"amount": 0,
"fee": 0,
"you_send": 100,
"total_amount_to_send": 98.5,
"recipient_gets": 59200,
"our_fee": 1.5,
"total_fees": 1.5,
"amountIsRecipientGets": false,
"amountIsYouSend": true,
"rate": 600.5
},
{
"method": "MOBILE_MONEY",
"amount": 1,
"fee": 1,
"you_send": 100,
"total_amount_to_send": 97.5,
"recipient_gets": 58600,
"our_fee": 1.5,
"total_fees": 2.5,
"amountIsRecipientGets": false,
"amountIsYouSend": true,
"rate": 600.5
}
]
}{
"status": false,
"message": "Invalid request parameters"
}{
"status": false,
"message": "Invalid or missing access token"
}Fees
Get fees breakdown
Calculate fees for a transaction between two currencies. Provide either from_amount or to_amount (not both). Required scope: fees:read.
POST
/
api
/
external
/
fees
/
breakdown
Get fees breakdown
curl --request POST \
--url https://api-prod.blaaiz.com/api/external/fees/breakdown \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"from_currency_id": "NGN",
"to_currency_id": "NGN",
"from_amount": 50000
}
'import requests
url = "https://api-prod.blaaiz.com/api/external/fees/breakdown"
payload = {
"from_currency_id": "NGN",
"to_currency_id": "NGN",
"from_amount": 50000
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({from_currency_id: 'NGN', to_currency_id: 'NGN', from_amount: 50000})
};
fetch('https://api-prod.blaaiz.com/api/external/fees/breakdown', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));require 'uri'
require 'net/http'
url = URI("https://api-prod.blaaiz.com/api/external/fees/breakdown")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"from_currency_id\": \"NGN\",\n \"to_currency_id\": \"NGN\",\n \"from_amount\": 50000\n}"
response = http.request(request)
puts response.read_body<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-prod.blaaiz.com/api/external/fees/breakdown",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'from_currency_id' => 'NGN',
'to_currency_id' => 'NGN',
'from_amount' => 50000
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"our_fee": 1.5,
"collection_fees": [
{
"method": "CARD",
"amount": 2,
"fee": 2,
"you_send": 100,
"total_amount_to_send": 96.5,
"recipient_gets": 58000,
"our_fee": 1.5,
"total_fees": 3.5,
"amountIsRecipientGets": false,
"amountIsYouSend": true,
"rate": 600.5
},
{
"method": "OPEN_BANKING",
"amount": 0.5,
"fee": 0.5,
"you_send": 100,
"total_amount_to_send": 98,
"recipient_gets": 58900,
"our_fee": 1.5,
"total_fees": 2,
"amountIsRecipientGets": false,
"amountIsYouSend": true,
"rate": 600.5
}
],
"payout_fees": [
{
"method": "BANK_TRANSFER",
"amount": 0,
"fee": 0,
"you_send": 100,
"total_amount_to_send": 98.5,
"recipient_gets": 59200,
"our_fee": 1.5,
"total_fees": 1.5,
"amountIsRecipientGets": false,
"amountIsYouSend": true,
"rate": 600.5
},
{
"method": "MOBILE_MONEY",
"amount": 1,
"fee": 1,
"you_send": 100,
"total_amount_to_send": 97.5,
"recipient_gets": 58600,
"our_fee": 1.5,
"total_fees": 2.5,
"amountIsRecipientGets": false,
"amountIsYouSend": true,
"rate": 600.5
}
]
}{
"status": false,
"message": "Invalid request parameters"
}{
"status": false,
"message": "Invalid or missing access token"
}Authorizations
Use your OAuth client credentials to obtain a short-lived Bearer token from POST /oauth/token.
Body
application/json
This retrieves a detailed fee breakdown for a specific transaction type between two currencies. By providing the necessary parameters, businesses can understand the applicable fees for sending or receiving funds, whether through bank transfers or other methods. This endpoint supports transactions in various currencies, allowing for flexibility and transparency in financial operations.
Was this page helpful?
⌘I

