Master Wallet Execute
curl --request POST \
--url https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/execute \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"sessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"paymentMethod": "<string>",
"customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"assetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"amount": "<string>",
"amountSide": "source",
"currency": "<string>",
"paymentMethodData": {},
"isGaslessWithdraw": true,
"reference": "wd_20260719_001",
"metadata": {
"payoutId": "payout_123"
},
"note": "Vendor payout",
"provider": "<string>",
"code": "<string>",
"passkeyResponse": {}
}
'import requests
url = "https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/execute"
payload = {
"sessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"paymentMethod": "<string>",
"customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"assetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"amount": "<string>",
"amountSide": "source",
"currency": "<string>",
"paymentMethodData": {},
"isGaslessWithdraw": True,
"reference": "wd_20260719_001",
"metadata": { "payoutId": "payout_123" },
"note": "Vendor payout",
"provider": "<string>",
"code": "<string>",
"passkeyResponse": {}
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
sessionId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
paymentMethod: '<string>',
customerId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
assetId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
amount: '<string>',
amountSide: 'source',
currency: '<string>',
paymentMethodData: {},
isGaslessWithdraw: true,
reference: 'wd_20260719_001',
metadata: {payoutId: 'payout_123'},
note: 'Vendor payout',
provider: '<string>',
code: '<string>',
passkeyResponse: {}
})
};
fetch('https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/execute', 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.blockradar.co/v2/wallets/{id}/withdraw/fiat/execute",
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([
'sessionId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'paymentMethod' => '<string>',
'customerId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'assetId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'amount' => '<string>',
'amountSide' => 'source',
'currency' => '<string>',
'paymentMethodData' => [
],
'isGaslessWithdraw' => true,
'reference' => 'wd_20260719_001',
'metadata' => [
'payoutId' => 'payout_123'
],
'note' => 'Vendor payout',
'provider' => '<string>',
'code' => '<string>',
'passkeyResponse' => [
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <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.blockradar.co/v2/wallets/{id}/withdraw/fiat/execute"
payload := strings.NewReader("{\n \"sessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"paymentMethod\": \"<string>\",\n \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"assetId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"amount\": \"<string>\",\n \"amountSide\": \"source\",\n \"currency\": \"<string>\",\n \"paymentMethodData\": {},\n \"isGaslessWithdraw\": true,\n \"reference\": \"wd_20260719_001\",\n \"metadata\": {\n \"payoutId\": \"payout_123\"\n },\n \"note\": \"Vendor payout\",\n \"provider\": \"<string>\",\n \"code\": \"<string>\",\n \"passkeyResponse\": {}\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<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.post("https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/execute")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"sessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"paymentMethod\": \"<string>\",\n \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"assetId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"amount\": \"<string>\",\n \"amountSide\": \"source\",\n \"currency\": \"<string>\",\n \"paymentMethodData\": {},\n \"isGaslessWithdraw\": true,\n \"reference\": \"wd_20260719_001\",\n \"metadata\": {\n \"payoutId\": \"payout_123\"\n },\n \"note\": \"Vendor payout\",\n \"provider\": \"<string>\",\n \"code\": \"<string>\",\n \"passkeyResponse\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/execute")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"sessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"paymentMethod\": \"<string>\",\n \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"assetId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"amount\": \"<string>\",\n \"amountSide\": \"source\",\n \"currency\": \"<string>\",\n \"paymentMethodData\": {},\n \"isGaslessWithdraw\": true,\n \"reference\": \"wd_20260719_001\",\n \"metadata\": {\n \"payoutId\": \"payout_123\"\n },\n \"note\": \"Vendor payout\",\n \"provider\": \"<string>\",\n \"code\": \"<string>\",\n \"passkeyResponse\": {}\n}"
response = http.request(request)
puts response.read_body{
"message": "Successful",
"data": {
"id": "5b26b640-7a15-48aa-a465-82a4cb6e927b",
"reference": "wd_20260719_001",
"senderAddress": "0x947514e4B803e312C312da0F1B41fEDdbe15ae7a",
"recipientAddress": "0123456789",
"tokenAddress": "0xA0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"amount": "100.00",
"amountPaid": "100.00",
"amountUSD": "100.00",
"rateUSD": "1.00",
"fee": "1.50",
"feeUSD": "1.50",
"currency": "NGN",
"toCurrency": "NGN",
"hash": null,
"confirmed": false,
"status": "pending",
"processingStatus": "pending",
"processingProviderReference": null,
"type": "offramp",
"note": "Vendor payout",
"createdAt": "2026-07-19T12:30:00.000Z",
"updatedAt": "2026-07-19T12:30:00.000Z"
},
"status": true
}{
"statusCode": 123,
"message": "<string>",
"details": {
"code": "CUSTOMER_ONBOARDING_REQUIRED",
"customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"provider": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"slug": "<string>",
"name": "<string>"
},
"onboarding": {
"caseId": "<string>",
"status": "<string>",
"providerStatus": "<string>",
"action": {
"type": "create_case",
"method": "POST",
"path": "/v1/customers/18d2f159-e0cd-4a45-b735-e9dfe0f7520a/onboarding-requests",
"body": {
"provider": "<string>",
"type": "onramp"
}
}
}
},
"requestId": "<string>"
}{
"statusCode": 123,
"message": "<string>",
"details": {
"code": "CUSTOMER_ONBOARDING_REQUIRED",
"customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"provider": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"slug": "<string>",
"name": "<string>"
},
"onboarding": {
"caseId": "<string>",
"status": "<string>",
"providerStatus": "<string>",
"action": {
"type": "create_case",
"method": "POST",
"path": "/v1/customers/18d2f159-e0cd-4a45-b735-e9dfe0f7520a/onboarding-requests",
"body": {
"provider": "<string>",
"type": "onramp"
}
}
}
},
"requestId": "<string>"
}{
"statusCode": 123,
"message": "<string>",
"details": {
"code": "CUSTOMER_ONBOARDING_REQUIRED",
"customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"provider": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"slug": "<string>",
"name": "<string>"
},
"onboarding": {
"caseId": "<string>",
"status": "<string>",
"providerStatus": "<string>",
"action": {
"type": "create_case",
"method": "POST",
"path": "/v1/customers/18d2f159-e0cd-4a45-b735-e9dfe0f7520a/onboarding-requests",
"body": {
"provider": "<string>",
"type": "onramp"
}
}
}
},
"requestId": "<string>"
}v2
Master Wallet Execute
For customer-owned withdrawals, provide customerId when starting the flow; subsequent requests inherit it from sessionId. Changing identity requires a new rates request. Customer eligibility failures use the HTTP error details contract. See Customer fiat flows.
POST
/
v2
/
wallets
/
{id}
/
withdraw
/
fiat
/
execute
Master Wallet Execute
curl --request POST \
--url https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/execute \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"sessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"paymentMethod": "<string>",
"customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"assetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"amount": "<string>",
"amountSide": "source",
"currency": "<string>",
"paymentMethodData": {},
"isGaslessWithdraw": true,
"reference": "wd_20260719_001",
"metadata": {
"payoutId": "payout_123"
},
"note": "Vendor payout",
"provider": "<string>",
"code": "<string>",
"passkeyResponse": {}
}
'import requests
url = "https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/execute"
payload = {
"sessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"paymentMethod": "<string>",
"customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"assetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"amount": "<string>",
"amountSide": "source",
"currency": "<string>",
"paymentMethodData": {},
"isGaslessWithdraw": True,
"reference": "wd_20260719_001",
"metadata": { "payoutId": "payout_123" },
"note": "Vendor payout",
"provider": "<string>",
"code": "<string>",
"passkeyResponse": {}
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
sessionId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
paymentMethod: '<string>',
customerId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
assetId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
amount: '<string>',
amountSide: 'source',
currency: '<string>',
paymentMethodData: {},
isGaslessWithdraw: true,
reference: 'wd_20260719_001',
metadata: {payoutId: 'payout_123'},
note: 'Vendor payout',
provider: '<string>',
code: '<string>',
passkeyResponse: {}
})
};
fetch('https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/execute', 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.blockradar.co/v2/wallets/{id}/withdraw/fiat/execute",
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([
'sessionId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'paymentMethod' => '<string>',
'customerId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'assetId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'amount' => '<string>',
'amountSide' => 'source',
'currency' => '<string>',
'paymentMethodData' => [
],
'isGaslessWithdraw' => true,
'reference' => 'wd_20260719_001',
'metadata' => [
'payoutId' => 'payout_123'
],
'note' => 'Vendor payout',
'provider' => '<string>',
'code' => '<string>',
'passkeyResponse' => [
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <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.blockradar.co/v2/wallets/{id}/withdraw/fiat/execute"
payload := strings.NewReader("{\n \"sessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"paymentMethod\": \"<string>\",\n \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"assetId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"amount\": \"<string>\",\n \"amountSide\": \"source\",\n \"currency\": \"<string>\",\n \"paymentMethodData\": {},\n \"isGaslessWithdraw\": true,\n \"reference\": \"wd_20260719_001\",\n \"metadata\": {\n \"payoutId\": \"payout_123\"\n },\n \"note\": \"Vendor payout\",\n \"provider\": \"<string>\",\n \"code\": \"<string>\",\n \"passkeyResponse\": {}\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<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.post("https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/execute")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"sessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"paymentMethod\": \"<string>\",\n \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"assetId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"amount\": \"<string>\",\n \"amountSide\": \"source\",\n \"currency\": \"<string>\",\n \"paymentMethodData\": {},\n \"isGaslessWithdraw\": true,\n \"reference\": \"wd_20260719_001\",\n \"metadata\": {\n \"payoutId\": \"payout_123\"\n },\n \"note\": \"Vendor payout\",\n \"provider\": \"<string>\",\n \"code\": \"<string>\",\n \"passkeyResponse\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/execute")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"sessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"paymentMethod\": \"<string>\",\n \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"assetId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"amount\": \"<string>\",\n \"amountSide\": \"source\",\n \"currency\": \"<string>\",\n \"paymentMethodData\": {},\n \"isGaslessWithdraw\": true,\n \"reference\": \"wd_20260719_001\",\n \"metadata\": {\n \"payoutId\": \"payout_123\"\n },\n \"note\": \"Vendor payout\",\n \"provider\": \"<string>\",\n \"code\": \"<string>\",\n \"passkeyResponse\": {}\n}"
response = http.request(request)
puts response.read_body{
"message": "Successful",
"data": {
"id": "5b26b640-7a15-48aa-a465-82a4cb6e927b",
"reference": "wd_20260719_001",
"senderAddress": "0x947514e4B803e312C312da0F1B41fEDdbe15ae7a",
"recipientAddress": "0123456789",
"tokenAddress": "0xA0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"amount": "100.00",
"amountPaid": "100.00",
"amountUSD": "100.00",
"rateUSD": "1.00",
"fee": "1.50",
"feeUSD": "1.50",
"currency": "NGN",
"toCurrency": "NGN",
"hash": null,
"confirmed": false,
"status": "pending",
"processingStatus": "pending",
"processingProviderReference": null,
"type": "offramp",
"note": "Vendor payout",
"createdAt": "2026-07-19T12:30:00.000Z",
"updatedAt": "2026-07-19T12:30:00.000Z"
},
"status": true
}{
"statusCode": 123,
"message": "<string>",
"details": {
"code": "CUSTOMER_ONBOARDING_REQUIRED",
"customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"provider": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"slug": "<string>",
"name": "<string>"
},
"onboarding": {
"caseId": "<string>",
"status": "<string>",
"providerStatus": "<string>",
"action": {
"type": "create_case",
"method": "POST",
"path": "/v1/customers/18d2f159-e0cd-4a45-b735-e9dfe0f7520a/onboarding-requests",
"body": {
"provider": "<string>",
"type": "onramp"
}
}
}
},
"requestId": "<string>"
}{
"statusCode": 123,
"message": "<string>",
"details": {
"code": "CUSTOMER_ONBOARDING_REQUIRED",
"customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"provider": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"slug": "<string>",
"name": "<string>"
},
"onboarding": {
"caseId": "<string>",
"status": "<string>",
"providerStatus": "<string>",
"action": {
"type": "create_case",
"method": "POST",
"path": "/v1/customers/18d2f159-e0cd-4a45-b735-e9dfe0f7520a/onboarding-requests",
"body": {
"provider": "<string>",
"type": "onramp"
}
}
}
},
"requestId": "<string>"
}{
"statusCode": 123,
"message": "<string>",
"details": {
"code": "CUSTOMER_ONBOARDING_REQUIRED",
"customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"provider": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"slug": "<string>",
"name": "<string>"
},
"onboarding": {
"caseId": "<string>",
"status": "<string>",
"providerStatus": "<string>",
"action": {
"type": "create_case",
"method": "POST",
"path": "/v1/customers/18d2f159-e0cd-4a45-b735-e9dfe0f7520a/onboarding-requests",
"body": {
"provider": "<string>",
"type": "onramp"
}
}
}
},
"requestId": "<string>"
}Pour l’identité, les sessions, la reprise et les frais, consultez Flux fiat pour les clients.
Autorisations
Paramètres de chemin
Wallet identifier.
Corps
application/json
- Option 1
- Option 2
Supply sessionId, or all original routing fields. Repeated fields must match the session. Customer identity is inherited from the session.
Session ID returned by the v2 rates endpoint.
ID of an existing active customer owned by the authenticated business.
Pattern:
^\d+(\.\d+)?$source fixes the total source-asset budget, with fees allocated inside it; target fixes the fiat payout before beneficiary deductions and derives the required source debit.
Options disponibles:
source, target Required string length:
3Unique client reference used for reconciliation and safe retries.
Exemple:
"wd_20260719_001"
Your application metadata.
Exemple:
{ "payoutId": "payout_123" }
Human-readable transaction note.
Exemple:
"Vendor payout"
Completed payment-method resolution, including the provider resolutionId. Required when the provider returned a resolution session. Complete every nextStep before quoting or executing.
Show child attributes
Show child attributes
2FA code, when required.
WebAuthn assertion, when required.