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"
}Get fees breakdown
Calculate fees for a transaction between two currencies. Provide either from_amount or to_amount (not both). Send customer_id to get the fees that apply to that customer. Required scope: fees:read.
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
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.
Currency code you are sending from (e.g., NGN, CAD, USD)
Currency code the recipient will receive (e.g., NGN, CAD, USD)
Amount to deduct from your wallet
Exact amount the recipient should receive
UUID of the customer for the transaction. If the customer type is individual, the fees that target individual customers apply. If you omit this field, the standard business fees apply. If the customer does not belong to your business, the API returns a 400 error.
Was this page helpful?