curl -X POST https://checkout.noxpay.io/v2/naas/whitelist \
-H "api-key: <key>" \
-H "X-Signature: <assinatura-do-corpo>" \
-H "Content-Type: application/json" \
-d '{
"timestamp": "2026-05-19T14:30:00Z",
"correlation_id": "a1b2c3d4-e5f6-4789-abcd-000000000001",
"payload": { "walletName": "Tesouraria" }
}'
import requests
body, sig = sign_envelope({
"walletName": "Tesouraria",
"walletId": "fb-wallet-abc123",
"address": "0xABC123...",
"addressName": "Carteira quente",
"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: "Tesouraria",
walletId: "fb-wallet-abc123",
address: "0xABC123...",
addressName: "Carteira quente",
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 — Conta Global
Gerenciar Whitelist
POST /v2/naas/whitelist — cria um grupo de carteira ou adiciona um endereço a um grupo existente.
curl -X POST https://checkout.noxpay.io/v2/naas/whitelist \
-H "api-key: <key>" \
-H "X-Signature: <assinatura-do-corpo>" \
-H "Content-Type: application/json" \
-d '{
"timestamp": "2026-05-19T14:30:00Z",
"correlation_id": "a1b2c3d4-e5f6-4789-abcd-000000000001",
"payload": { "walletName": "Tesouraria" }
}'
import requests
body, sig = sign_envelope({
"walletName": "Tesouraria",
"walletId": "fb-wallet-abc123",
"address": "0xABC123...",
"addressName": "Carteira quente",
"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: "Tesouraria",
walletId: "fb-wallet-abc123",
address: "0xABC123...",
addressName: "Carteira quente",
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" }
Este endpoint tem dois modos dependendo dos campos fornecidos no payload.
Response
Use o
Response
Criar um grupo de carteira
Forneça apenaswalletName para criar um novo grupo de carteira externa Fireblocks.
Payload:
| Campo | Obrigatório | Descrição |
|---|---|---|
walletName | Sim | Nome do novo grupo de carteira |
200:
{ "walletId": "fb-wallet-abc123", "message": "External wallet created" }
walletId retornado ao adicionar endereços a este grupo.
Adicionar um endereço a um grupo
ForneçawalletId e os detalhes do endereço para registrar um novo endereço em um grupo existente.
Payload:
| Campo | Obrigatório | Descrição |
|---|---|---|
walletName | Sim | Nome do grupo existente |
walletId | Sim | ID do grupo de carteira Fireblocks (da resposta de criação) |
address | Sim | Endereço cripto de destino |
addressName | Sim | Rótulo legível para este endereço |
currencyCode | Sim | Código do ativo (ex: 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: <assinatura-do-corpo>" \
-H "Content-Type: application/json" \
-d '{
"timestamp": "2026-05-19T14:30:00Z",
"correlation_id": "a1b2c3d4-e5f6-4789-abcd-000000000001",
"payload": { "walletName": "Tesouraria" }
}'
import requests
body, sig = sign_envelope({
"walletName": "Tesouraria",
"walletId": "fb-wallet-abc123",
"address": "0xABC123...",
"addressName": "Carteira quente",
"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: "Tesouraria",
walletId: "fb-wallet-abc123",
address: "0xABC123...",
addressName: "Carteira quente",
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" }

