Update merchant NGN settlement destination
curl --request PATCH \
--url https://api.daya.co/v1/merchant/funding/settlement-destination \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <x-api-key>' \
--data '
{
"ngn_settlement_destination": "<string>"
}
'import requests
url = "https://api.daya.co/v1/merchant/funding/settlement-destination"
payload = { "ngn_settlement_destination": "<string>" }
headers = {
"X-Api-Key": "<x-api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'X-Api-Key': '<x-api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({ngn_settlement_destination: '<string>'})
};
fetch('https://api.daya.co/v1/merchant/funding/settlement-destination', 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://api.daya.co/v1/merchant/funding/settlement-destination",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'ngn_settlement_destination' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Api-Key: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.daya.co/v1/merchant/funding/settlement-destination"
payload := strings.NewReader("{\n \"ngn_settlement_destination\": \"<string>\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("X-Api-Key", "<x-api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.daya.co/v1/merchant/funding/settlement-destination")
.header("X-Api-Key", "<x-api-key>")
.header("Content-Type", "application/json")
.body("{\n \"ngn_settlement_destination\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.daya.co/v1/merchant/funding/settlement-destination")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["X-Api-Key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"ngn_settlement_destination\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": "750e8400-e29b-41d4-a716-446655440000",
"setup_status": "ACTIVE",
"ngn_settlement_destination": "NGN_BALANCE",
"ngn_account": {
"account_number": "0123456789",
"account_name": "Acme Ltd",
"bank_name": "Wema Bank",
"bank_code": "035"
},
"crypto_wallet": {
"wallet_id": "wallet_abc123",
"addresses": []
}
}
}
Merchant Funding
Update merchant NGN settlement destination
Choose whether merchant NGN funding deposits remain in NGN or convert to USD
PATCH
/
v1
/
merchant
/
funding
/
settlement-destination
Update merchant NGN settlement destination
curl --request PATCH \
--url https://api.daya.co/v1/merchant/funding/settlement-destination \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <x-api-key>' \
--data '
{
"ngn_settlement_destination": "<string>"
}
'import requests
url = "https://api.daya.co/v1/merchant/funding/settlement-destination"
payload = { "ngn_settlement_destination": "<string>" }
headers = {
"X-Api-Key": "<x-api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'X-Api-Key': '<x-api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({ngn_settlement_destination: '<string>'})
};
fetch('https://api.daya.co/v1/merchant/funding/settlement-destination', 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://api.daya.co/v1/merchant/funding/settlement-destination",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'ngn_settlement_destination' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Api-Key: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.daya.co/v1/merchant/funding/settlement-destination"
payload := strings.NewReader("{\n \"ngn_settlement_destination\": \"<string>\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("X-Api-Key", "<x-api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.daya.co/v1/merchant/funding/settlement-destination")
.header("X-Api-Key", "<x-api-key>")
.header("Content-Type", "application/json")
.body("{\n \"ngn_settlement_destination\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.daya.co/v1/merchant/funding/settlement-destination")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["X-Api-Key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"ngn_settlement_destination\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": "750e8400-e29b-41d4-a716-446655440000",
"setup_status": "ACTIVE",
"ngn_settlement_destination": "NGN_BALANCE",
"ngn_account": {
"account_number": "0123456789",
"account_name": "Acme Ltd",
"bank_name": "Wema Bank",
"bank_code": "035"
},
"crypto_wallet": {
"wallet_id": "wallet_abc123",
"addresses": []
}
}
}
Overview
Sets how future deposits to your merchant’s permanent NGN funding account are credited.| Value | Result |
|---|---|
USD_BALANCE | Converts the NGN deposit at the current rate and credits withdrawal_balance_usd. This is the default. |
NGN_BALANCE | Retains the deposit in Naira and credits withdrawal_balance_ngn without FX conversion. |
Changing the preference affects future deposits only. It does not convert or move existing balances, and it does not change deposits that have already settled.
Your merchant funding setup must be
ACTIVE and include an NGN bank account before you can select NGN_BALANCE.Authentication
string
required
Your merchant API key.
Request Body
string
required
The settlement mode for future merchant NGN funding deposits. Allowed values are
USD_BALANCE and NGN_BALANCE.Request Examples
curl --request PATCH \
--url https://api.daya.co/v1/merchant/funding/settlement-destination \
--header 'X-Api-Key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"ngn_settlement_destination": "NGN_BALANCE"
}'
curl --request PATCH \
--url https://api.daya.co/v1/merchant/funding/settlement-destination \
--header 'X-Api-Key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"ngn_settlement_destination": "USD_BALANCE"
}'
Response
Returns the merchant funding configuration with the selectedngn_settlement_destination.
{
"data": {
"id": "750e8400-e29b-41d4-a716-446655440000",
"setup_status": "ACTIVE",
"ngn_settlement_destination": "NGN_BALANCE",
"ngn_account": {
"account_number": "0123456789",
"account_name": "Acme Ltd",
"bank_name": "Wema Bank",
"bank_code": "035"
},
"crypto_wallet": {
"wallet_id": "wallet_abc123",
"addresses": []
}
}
}
GET /v1/merchant/funding at any time to confirm the current setting.
Errors
400: Unsupported destination, orNGN_BALANCEwas requested without an active NGN merchant funding account.401: Missing or invalid API key.404: Merchant funding configuration not found.500: Internal server error.