Delivery Currencies

curl --request GET \
  --url https://{tenant}.fincode.software/api/v6/services/quote/supported-delivery-currencies/{sendingCountryCode}/{receivingCountryCode}/{deliveryMethod}/{sendingCurrencyCode} \
  --header 'X-Auth-Token: <x-auth-token>' \
  --header 'platform: <platform>' \
  --header 'uuid: <uuid>'

import requests

url = "https://{tenant}.fincode.software/api/v6/services/quote/supported-delivery-currencies/{sendingCountryCode}/{receivingCountryCode}/{deliveryMethod}/{sendingCurrencyCode}"

headers = {
    "platform": "<platform>",
    "uuid": "<uuid>",
    "X-Auth-Token": "<x-auth-token>"
}

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

print(response.text)

const options = {
  method: 'GET',
  headers: {platform: '<platform>', uuid: '<uuid>', 'X-Auth-Token': '<x-auth-token>'}
};

fetch('https://{tenant}.fincode.software/api/v6/services/quote/supported-delivery-currencies/{sendingCountryCode}/{receivingCountryCode}/{deliveryMethod}/{sendingCurrencyCode}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{tenant}.fincode.software/api/v6/services/quote/supported-delivery-currencies/{sendingCountryCode}/{receivingCountryCode}/{deliveryMethod}/{sendingCurrencyCode}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-Auth-Token: <x-auth-token>",
    "platform: <platform>",
    "uuid: <uuid>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://{tenant}.fincode.software/api/v6/services/quote/supported-delivery-currencies/{sendingCountryCode}/{receivingCountryCode}/{deliveryMethod}/{sendingCurrencyCode}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("platform", "<platform>")
	req.Header.Add("uuid", "<uuid>")
	req.Header.Add("X-Auth-Token", "<x-auth-token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://{tenant}.fincode.software/api/v6/services/quote/supported-delivery-currencies/{sendingCountryCode}/{receivingCountryCode}/{deliveryMethod}/{sendingCurrencyCode}")
  .header("platform", "<platform>")
  .header("uuid", "<uuid>")
  .header("X-Auth-Token", "<x-auth-token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{tenant}.fincode.software/api/v6/services/quote/supported-delivery-currencies/{sendingCountryCode}/{receivingCountryCode}/{deliveryMethod}/{sendingCurrencyCode}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["platform"] = '<platform>'
request["uuid"] = '<uuid>'
request["X-Auth-Token"] = '<x-auth-token>'

response = http.request(request)
puts response.read_body

GET

quote

supported-delivery-currencies

{sendingCountryCode}

{receivingCountryCode}

{deliveryMethod}

{sendingCurrencyCode}

Delivery Currencies

curl --request GET \
  --url https://{tenant}.fincode.software/api/v6/services/quote/supported-delivery-currencies/{sendingCountryCode}/{receivingCountryCode}/{deliveryMethod}/{sendingCurrencyCode} \
  --header 'X-Auth-Token: <x-auth-token>' \
  --header 'platform: <platform>' \
  --header 'uuid: <uuid>'

import requests

url = "https://{tenant}.fincode.software/api/v6/services/quote/supported-delivery-currencies/{sendingCountryCode}/{receivingCountryCode}/{deliveryMethod}/{sendingCurrencyCode}"

headers = {
    "platform": "<platform>",
    "uuid": "<uuid>",
    "X-Auth-Token": "<x-auth-token>"
}

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

print(response.text)

const options = {
  method: 'GET',
  headers: {platform: '<platform>', uuid: '<uuid>', 'X-Auth-Token': '<x-auth-token>'}
};

fetch('https://{tenant}.fincode.software/api/v6/services/quote/supported-delivery-currencies/{sendingCountryCode}/{receivingCountryCode}/{deliveryMethod}/{sendingCurrencyCode}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{tenant}.fincode.software/api/v6/services/quote/supported-delivery-currencies/{sendingCountryCode}/{receivingCountryCode}/{deliveryMethod}/{sendingCurrencyCode}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-Auth-Token: <x-auth-token>",
    "platform: <platform>",
    "uuid: <uuid>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://{tenant}.fincode.software/api/v6/services/quote/supported-delivery-currencies/{sendingCountryCode}/{receivingCountryCode}/{deliveryMethod}/{sendingCurrencyCode}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("platform", "<platform>")
	req.Header.Add("uuid", "<uuid>")
	req.Header.Add("X-Auth-Token", "<x-auth-token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://{tenant}.fincode.software/api/v6/services/quote/supported-delivery-currencies/{sendingCountryCode}/{receivingCountryCode}/{deliveryMethod}/{sendingCurrencyCode}")
  .header("platform", "<platform>")
  .header("uuid", "<uuid>")
  .header("X-Auth-Token", "<x-auth-token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{tenant}.fincode.software/api/v6/services/quote/supported-delivery-currencies/{sendingCountryCode}/{receivingCountryCode}/{deliveryMethod}/{sendingCurrencyCode}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["platform"] = '<platform>'
request["uuid"] = '<uuid>'
request["X-Auth-Token"] = '<x-auth-token>'

response = http.request(request)
puts response.read_body

This endpoint finalizes the currency selection by returning the payout currencies available in the destination country. It factors in the corridor and the specific source currency (sendingCurrencyCode) that the sender has chosen to pay with.

Request Headers

This endpoint requires a valid Access Token

string

required

The JWT Access Token obtained from the /login or /refresh-token endpoint. This token must belong to a user with appropriate permissions.

string

default:"fincode"

required

Platform identifier. Use fincode.

string

default:"200"

required

Unique request identifier.

Path Parameters

string

default:"GBR"

required

The country code the customer is sending from.

string

default:"NGA"

required

The country code the recipient is in.

string

default:"ACCOUNTPAYMENT"

required

The intended payout method.

string

default:"GBP"

required

The specific source currency the sender is paying with (e.g., GBP). This is the new parameter.

Code Examples

curl --location 'https://{your-domain}.fincode.software/api/v6/services/quote/supported-delivery-currencies/GBR/NGA/ACCOUNTPAYMENT/GBP' \
--header 'platform: fincode' \
--header 'uuid: 200'

const axios = require('axios');

const BASE_URL = 'https://agent.fincode.software/api/v6/services/quote';

async function getSupportedDeliveryCurrencies(
  sendCountry,
  receiveCountry,
  deliveryMethod,
  sendCurrency
) {
  const url = `${BASE_URL}/supported-delivery-currencies/${sendCountry}/${receiveCountry}/${deliveryMethod}/${sendCurrency}`;
  try {
    const response = await axios.get(url, {
      headers: {
        platform: 'fincode',
        uuid: '200',
      },
    });

    const currencies = response.data.data;

    console.log(
      `Final Delivery Currencies available for ${sendCurrency} payment:`
    );
    currencies.forEach((c) => {
      console.log(
        `- Receive in ${c.currencyCode} (Range: ${c.minAmount} to ${c.maxAmount})`
      );
    });
    return currencies;
  } catch (error) {
    console.error(
      'Failed to fetch supported delivery currencies:',
      error.response?.data || error.message
    );
    throw error;
  }
}

Headers

platform

string

default:fincode

required

uuid

string

default:200

required

X-Auth-Token

string

required

Path Parameters

sendingCountryCode

string

default:GBR

required

receivingCountryCode

string

default:NGA

required

deliveryMethod

string

default:ACCOUNTPAYMENT

required

sendingCurrencyCode

string

default:GBP

required

Response

200

List of delivery currencies

Getting Started

Transaction Core

API Endpoints

Delivery Currencies

Request Headers

Path Parameters

Code Examples

Headers

Path Parameters

Response

​Request Headers

​Path Parameters

​Code Examples

Headers

Path Parameters

Response

Request Headers

Path Parameters

Code Examples