curl -X POST https://checkout.noxpay.io/v2/naas/whitelist \
-H "api-key: <key>" \
-H "X-Signature: <signed-body-signature>" \
-H "Content-Type: application/json" \
-d '{
"timestamp": "2026-05-19T14:30:00Z",
"correlation_id": "a1b2c3d4-e5f6-4789-abcd-000000000001",
"payload": { "walletName": "Treasury" }
}'
import requests
body, sig = sign_envelope({
"walletName": "Treasury",
"walletId": "fb-wallet-abc123",
"address": "0xABC123...",
"addressName": "Hot wallet",
"currencyCode": "USDT_ERC20",
}, "a1b2c3d4-e5f6-4789-abcd-000000000001")
response = requests.post(
"https://checkout.noxpay.io/v2/naas/whitelist",
headers={"api-key": "<key>", "X-Signature": sig, "Content-Type": "application/json"},
data=body,
)
print(response.json())
const { body, signature } = signEnvelope({
walletName: "Treasury",
walletId: "fb-wallet-abc123",
address: "0xABC123...",
addressName: "Hot wallet",
currencyCode: "USDT_ERC20",
}, "a1b2c3d4-e5f6-4789-abcd-000000000001");
const response = await fetch("https://checkout.noxpay.io/v2/naas/whitelist", {
method: "POST",
headers: { "api-key": "<key>", "X-Signature": signature, "Content-Type": "application/json" },
body,
});
const data = await response.json();
{ "walletId": "fb-wallet-abc123", "message": "External wallet created" }
{ "message": "Whitelist request successful" }
NaaS — Global Account
Manage Whitelist
POST /v2/naas/whitelist — create a wallet group or add an address to an existing group.
curl -X POST https://checkout.noxpay.io/v2/naas/whitelist \
-H "api-key: <key>" \
-H "X-Signature: <signed-body-signature>" \
-H "Content-Type: application/json" \
-d '{
"timestamp": "2026-05-19T14:30:00Z",
"correlation_id": "a1b2c3d4-e5f6-4789-abcd-000000000001",
"payload": { "walletName": "Treasury" }
}'
import requests
body, sig = sign_envelope({
"walletName": "Treasury",
"walletId": "fb-wallet-abc123",
"address": "0xABC123...",
"addressName": "Hot wallet",
"currencyCode": "USDT_ERC20",
}, "a1b2c3d4-e5f6-4789-abcd-000000000001")
response = requests.post(
"https://checkout.noxpay.io/v2/naas/whitelist",
headers={"api-key": "<key>", "X-Signature": sig, "Content-Type": "application/json"},
data=body,
)
print(response.json())
const { body, signature } = signEnvelope({
walletName: "Treasury",
walletId: "fb-wallet-abc123",
address: "0xABC123...",
addressName: "Hot wallet",
currencyCode: "USDT_ERC20",
}, "a1b2c3d4-e5f6-4789-abcd-000000000001");
const response = await fetch("https://checkout.noxpay.io/v2/naas/whitelist", {
method: "POST",
headers: { "api-key": "<key>", "X-Signature": signature, "Content-Type": "application/json" },
body,
});
const data = await response.json();
{ "walletId": "fb-wallet-abc123", "message": "External wallet created" }
{ "message": "Whitelist request successful" }
This endpoint has two modes depending on the payload fields provided.
Response
Use the returned
Response
Create a wallet group
Provide onlywalletName to create a new Fireblocks external wallet group.
Payload:
| Field | Required | Description |
|---|---|---|
walletName | Yes | Name for the new wallet group |
200:
{ "walletId": "fb-wallet-abc123", "message": "External wallet created" }
walletId when adding addresses to this group.
Add an address to a group
ProvidewalletId plus address details to register a new address under an existing group.
Payload:
| Field | Required | Description |
|---|---|---|
walletName | Yes | Name of the existing group |
walletId | Yes | Fireblocks wallet group ID (from the create response) |
address | Yes | Destination crypto address |
addressName | Yes | Human-readable label for this address |
currencyCode | Yes | Asset code (e.g. USDT_ERC20, BTC) |
200:
{ "message": "Whitelist request successful" }
curl -X POST https://checkout.noxpay.io/v2/naas/whitelist \
-H "api-key: <key>" \
-H "X-Signature: <signed-body-signature>" \
-H "Content-Type: application/json" \
-d '{
"timestamp": "2026-05-19T14:30:00Z",
"correlation_id": "a1b2c3d4-e5f6-4789-abcd-000000000001",
"payload": { "walletName": "Treasury" }
}'
import requests
body, sig = sign_envelope({
"walletName": "Treasury",
"walletId": "fb-wallet-abc123",
"address": "0xABC123...",
"addressName": "Hot wallet",
"currencyCode": "USDT_ERC20",
}, "a1b2c3d4-e5f6-4789-abcd-000000000001")
response = requests.post(
"https://checkout.noxpay.io/v2/naas/whitelist",
headers={"api-key": "<key>", "X-Signature": sig, "Content-Type": "application/json"},
data=body,
)
print(response.json())
const { body, signature } = signEnvelope({
walletName: "Treasury",
walletId: "fb-wallet-abc123",
address: "0xABC123...",
addressName: "Hot wallet",
currencyCode: "USDT_ERC20",
}, "a1b2c3d4-e5f6-4789-abcd-000000000001");
const response = await fetch("https://checkout.noxpay.io/v2/naas/whitelist", {
method: "POST",
headers: { "api-key": "<key>", "X-Signature": signature, "Content-Type": "application/json" },
body,
});
const data = await response.json();
{ "walletId": "fb-wallet-abc123", "message": "External wallet created" }
{ "message": "Whitelist request successful" }