Get fee settings for specific transaction and party

curl --request GET \
  --url https://olive-gateway-a6ba.onrender.com/api/v1/fee-settings/{transaction_type}/{party_type} \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://olive-gateway-a6ba.onrender.com/api/v1/fee-settings/{transaction_type}/{party_type}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://olive-gateway-a6ba.onrender.com/api/v1/fee-settings/{transaction_type}/{party_type}"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

{}

{}

{}

GET

fee-settings

{transaction_type}

{party_type}

Get fee settings for specific transaction and party

curl --request GET \
  --url https://olive-gateway-a6ba.onrender.com/api/v1/fee-settings/{transaction_type}/{party_type} \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://olive-gateway-a6ba.onrender.com/api/v1/fee-settings/{transaction_type}/{party_type}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://olive-gateway-a6ba.onrender.com/api/v1/fee-settings/{transaction_type}/{party_type}"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

{}

{}

{}

Get Fee Setting

Retrieve configured fee settings for a specific transaction type and party combination.

Endpoint

GET /api/v1/fee-settings/:transaction_type/:party_type

Authentication

string

required

Bearer token (Admin JWT)

Path Parameters

string

required

Transaction type: transfer_p2p, agent_cashin, pos_payment, vult_fund, etc.

string

required

Party type: sender, recipient, agent, processor

Response

{
  "settings": {
    "id": 1,
    "transaction_type": "transfer_p2p",
    "party_type": "sender",
    "fee_type": "percentage",
    "fee_value": 1.5,
    "debit_enabled": true,
    "credit_enabled": false,
    "updated_at": "2025-01-15T10:30:00Z",
    "updated_by": "admin"
  }
}

Errors

Code	Description
404	Fee settings not found (using defaults)
401	Unauthorized
500	Internal server error

Authorizations

Authorization

string

header

required

API Key for third-party integrations (WhatsApp, Smart PAY, VULT). Format: 'Bearer olive_live_xxxxxxxxxxxxx'

Path Parameters

transaction_type

string

required

Transaction Type

party_type

string

required

Party Type

Response

The response is of type object.

List Fees

Update Fee Setting

​Get Fee Setting

​Endpoint

​Authentication

​Path Parameters

​Response

​Errors

Authorizations

Path Parameters

Response

Get Fee Setting

Endpoint

Authentication

Path Parameters

Response

Errors