Create Quote Example - NGN to GBP
This example demonstrates a quote request for converting 100,000 NGN (Naira) to GBP (Pounds Sterling). This quote locks in the exchange rate, fees, and amounts for a short period, which you can then use to initiate a payout transaction.
Supported Payment Channels
Quotes are often generated with a specific payout method in mind, as fees or limits might vary. This API supports getting quotes for payouts via:
- BANK_TRANSFER: For standard bank transfers.
Endpoint
POST {{baseURL}}/v1/quote
Header
Include these headers in your request:
| Header | Description | Required | Example Value |
|---|---|---|---|
x-api-key | API key for authentication | ✅ Yes | YOUR_API_KEY |
Content-Type | Request content type | ✅ Yes | application/json |
Remember to replace YOUR_API_KEY with your actual API key (Production or Sandbox).
Request Body
{
"paymentChannel": "string", //
"source": {
"amount": number,
"country": "string", // ISO 3166-1 alpha-2 code
"currency": "string" // ISO 4217 currency code
},
"target": {
"country": "string", // ISO 3166-1 alpha-2 code
"currency": "string" // ISO 4217 currency code
}
}Request Example with BANK_TRANSFER as payment channel:
curl --location --request POST '{{baseURL}}/v1/quote' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"paymentChannel": "BANK_TRANSFER",
"source": {
"amount": 100000,
"country": "NG",
"currency": "NGN"
},
"target": {
"country": "GB",
"currency": "GBP"
}
}'Sample Response (200 OK)
{
"message": "quote successfully created",
"status": "success",
"data": {
"id": "19agf2da-441e-54b7-cde9-xxxxxxxxxxxxx",
"source": {
"currency": "NGN",
"country": "NG",
"amount": 100000
},
"target": {
"currency": "GBP",
"country": "GB",
"amount": 52.50
},
"rate": 1904.76,
"fee": {
"amount": 1000
},
"rules": [
{
"category": "LIMIT",
"appliedCurrency": "GBP",
"appliedCountry": "GB",
"transaction": {
"minimum": 10,
"maximum": 5000
},
"invoice": 5000
}
],
"summary": {
"total": 101000
}
}
}ℹ️
Note: Our processing fee is dynamic and may vary based on the payment channel.
Response Breakdown
General Information
| Field | Type | Description |
|---|---|---|
message | String | Confirmation message |
status | String | Indicates success or failure |
data.id | String | Unique identifier for the quote |
Source (Sending) Details
| Field | Type | Description |
|---|---|---|
source.currency | String | Currency being exchanged (NGN) |
source.country | String | Country where the transaction originates (NG) |
source.amount | Number | Amount to be converted (100,000 NGN) |
Target (Receiving) Details
| Field | Type | Description |
|---|---|---|
target.currency | String | Target currency (GBP) |
target.country | String | Destination country (GB) |
target.amount | Number | Converted amount (52.50 GBP) |
Exchange Rate and Fees
| Field | Type | Description |
|---|---|---|
rate | Number | Exchange rate applied (1904.76) |
fee.amount | Number | Transaction fee (1,000 NGN) |
Transaction Rules
| Field | Type | Description |
|---|---|---|
rules[].category | String | Type of rule applied (LIMIT) |
rules[].appliedCurrency | String | Currency the rule applies to (GBP) |
rules[].appliedCountry | String | Country the rule applies to (GB) |
rules[].transaction.minimum | Number | Minimum allowed transaction (10 GBP) |
rules[].transaction.maximum | Number | Maximum allowed transaction (5,000 GBP) |
rules[].invoice | Number | Maximum invoice amount (5,000 GBP) |
Summary
| Field | Type | Description |
|---|---|---|
summary.total | Number | Total amount user pays (101,000 NGN) |
Key Takeaways
- The user sends 100,000 NGN, which is converted to 52.50 GBP at an exchange rate of 1904.76.
- A transaction fee of 1,000 NGN is applied.
- The total amount the user must pay (including fees) is 101,000 NGN.
- A transaction limit rule restricts transactions between 10 GBP and 5,000 GBP.