curl --request POST \
--url https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/payment-method/resolve \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"sessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"paymentMethod": "bank_transfer",
"paymentMethodData": {
"accountNumber": "0123456789",
"bankCode": "999"
},
"customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"assetId": "ae455f23-3824-4125-baab-d158315cbcbd",
"currency": "NGN",
"amount": "100.00",
"provider": "example-provider",
"amountSide": "source"
}
'import requests
url = "https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/payment-method/resolve"
payload = {
"sessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"paymentMethod": "bank_transfer",
"paymentMethodData": {
"accountNumber": "0123456789",
"bankCode": "999"
},
"customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"assetId": "ae455f23-3824-4125-baab-d158315cbcbd",
"currency": "NGN",
"amount": "100.00",
"provider": "example-provider",
"amountSide": "source"
}
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: 'bank_transfer',
paymentMethodData: {accountNumber: '0123456789', bankCode: '999'},
customerId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
assetId: 'ae455f23-3824-4125-baab-d158315cbcbd',
currency: 'NGN',
amount: '100.00',
provider: 'example-provider',
amountSide: 'source'
})
};
fetch('https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/payment-method/resolve', 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/payment-method/resolve",
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' => 'bank_transfer',
'paymentMethodData' => [
'accountNumber' => '0123456789',
'bankCode' => '999'
],
'customerId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'assetId' => 'ae455f23-3824-4125-baab-d158315cbcbd',
'currency' => 'NGN',
'amount' => '100.00',
'provider' => 'example-provider',
'amountSide' => 'source'
]),
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/payment-method/resolve"
payload := strings.NewReader("{\n \"sessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"paymentMethod\": \"bank_transfer\",\n \"paymentMethodData\": {\n \"accountNumber\": \"0123456789\",\n \"bankCode\": \"999\"\n },\n \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"assetId\": \"ae455f23-3824-4125-baab-d158315cbcbd\",\n \"currency\": \"NGN\",\n \"amount\": \"100.00\",\n \"provider\": \"example-provider\",\n \"amountSide\": \"source\"\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/payment-method/resolve")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"sessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"paymentMethod\": \"bank_transfer\",\n \"paymentMethodData\": {\n \"accountNumber\": \"0123456789\",\n \"bankCode\": \"999\"\n },\n \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"assetId\": \"ae455f23-3824-4125-baab-d158315cbcbd\",\n \"currency\": \"NGN\",\n \"amount\": \"100.00\",\n \"provider\": \"example-provider\",\n \"amountSide\": \"source\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/payment-method/resolve")
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\": \"bank_transfer\",\n \"paymentMethodData\": {\n \"accountNumber\": \"0123456789\",\n \"bankCode\": \"999\"\n },\n \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"assetId\": \"ae455f23-3824-4125-baab-d158315cbcbd\",\n \"currency\": \"NGN\",\n \"amount\": \"100.00\",\n \"provider\": \"example-provider\",\n \"amountSide\": \"source\"\n}"
response = http.request(request)
puts response.read_body{
"message": "Payment method resolved successfully",
"data": {
"paymentMethod": "bank_transfer",
"data": {
"accountNumber": "0123456789",
"accountName": "Ada Okafor",
"bankCode": "999"
},
"metadata": {
"institutionId": "bank_999"
}
},
"status": true
}{
"statusCode": 400,
"message": "Minimum amount for this payment method is 26 USDC",
"code": "amount_out_of_bounds",
"errors": [
{
"field": "amount",
"message": "Minimum amount for this payment method is 26 USDC",
"code": "amount_out_of_bounds"
}
],
"details": {
"minAmount": "26",
"currency": "USDC",
"amountSide": "source",
"paymentMethod": "method-id"
}
}{
"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>"
}Resolve Payment Method Requirements
Resolves a dynamic payment-method field using its x-resolution definition. See Dynamic Forms. 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. For USDC/USDT source requests, the selected method minimum is enforced before beneficiary resolution or provider quote preparation. Requests below the minimum return HTTP 400 with code amount_out_of_bounds. Target requests use native fiat limits; do not derive a fiat minimum by converting the configured source minimum.
curl --request POST \
--url https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/payment-method/resolve \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"sessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"paymentMethod": "bank_transfer",
"paymentMethodData": {
"accountNumber": "0123456789",
"bankCode": "999"
},
"customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"assetId": "ae455f23-3824-4125-baab-d158315cbcbd",
"currency": "NGN",
"amount": "100.00",
"provider": "example-provider",
"amountSide": "source"
}
'import requests
url = "https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/payment-method/resolve"
payload = {
"sessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"paymentMethod": "bank_transfer",
"paymentMethodData": {
"accountNumber": "0123456789",
"bankCode": "999"
},
"customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"assetId": "ae455f23-3824-4125-baab-d158315cbcbd",
"currency": "NGN",
"amount": "100.00",
"provider": "example-provider",
"amountSide": "source"
}
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: 'bank_transfer',
paymentMethodData: {accountNumber: '0123456789', bankCode: '999'},
customerId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
assetId: 'ae455f23-3824-4125-baab-d158315cbcbd',
currency: 'NGN',
amount: '100.00',
provider: 'example-provider',
amountSide: 'source'
})
};
fetch('https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/payment-method/resolve', 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/payment-method/resolve",
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' => 'bank_transfer',
'paymentMethodData' => [
'accountNumber' => '0123456789',
'bankCode' => '999'
],
'customerId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'assetId' => 'ae455f23-3824-4125-baab-d158315cbcbd',
'currency' => 'NGN',
'amount' => '100.00',
'provider' => 'example-provider',
'amountSide' => 'source'
]),
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/payment-method/resolve"
payload := strings.NewReader("{\n \"sessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"paymentMethod\": \"bank_transfer\",\n \"paymentMethodData\": {\n \"accountNumber\": \"0123456789\",\n \"bankCode\": \"999\"\n },\n \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"assetId\": \"ae455f23-3824-4125-baab-d158315cbcbd\",\n \"currency\": \"NGN\",\n \"amount\": \"100.00\",\n \"provider\": \"example-provider\",\n \"amountSide\": \"source\"\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/payment-method/resolve")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"sessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"paymentMethod\": \"bank_transfer\",\n \"paymentMethodData\": {\n \"accountNumber\": \"0123456789\",\n \"bankCode\": \"999\"\n },\n \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"assetId\": \"ae455f23-3824-4125-baab-d158315cbcbd\",\n \"currency\": \"NGN\",\n \"amount\": \"100.00\",\n \"provider\": \"example-provider\",\n \"amountSide\": \"source\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/payment-method/resolve")
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\": \"bank_transfer\",\n \"paymentMethodData\": {\n \"accountNumber\": \"0123456789\",\n \"bankCode\": \"999\"\n },\n \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"assetId\": \"ae455f23-3824-4125-baab-d158315cbcbd\",\n \"currency\": \"NGN\",\n \"amount\": \"100.00\",\n \"provider\": \"example-provider\",\n \"amountSide\": \"source\"\n}"
response = http.request(request)
puts response.read_body{
"message": "Payment method resolved successfully",
"data": {
"paymentMethod": "bank_transfer",
"data": {
"accountNumber": "0123456789",
"accountName": "Ada Okafor",
"bankCode": "999"
},
"metadata": {
"institutionId": "bank_999"
}
},
"status": true
}{
"statusCode": 400,
"message": "Minimum amount for this payment method is 26 USDC",
"code": "amount_out_of_bounds",
"errors": [
{
"field": "amount",
"message": "Minimum amount for this payment method is 26 USDC",
"code": "amount_out_of_bounds"
}
],
"details": {
"minAmount": "26",
"currency": "USDC",
"amountSide": "source",
"paymentMethod": "method-id"
}
}{
"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>"
}sessionId, paymentMethod et les données paymentMethodData collectées selon le schéma des exigences. Si les exigences incluent un contrat resolution, utilisez ses champs method, url, body et inputPath.
Lorsque status vaut requires_action, affichez nextStep.schema et envoyez continuation avec le resolutionId renvoyé, nextStep.id comme stepId et les données demandées. Répétez jusqu’à ce que status vaille resolved.
La session enregistre le formulaire et la résolution terminés. Si les coordonnées du bénéficiaire changent, résolvez de nouveau la méthode. Demandez ensuite un devis.Corps
- Option 1
- Option 2
Supply sessionId, or all original routing fields. Repeated fields must match the session. Customer identity is inherited from the session.

