Pular para o conteúdo principal
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_ETH",
}, "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_ETH",
}, "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.

​
Criar um grupo de carteira

Forneça apenas walletName para criar um novo grupo de carteira externa Fireblocks. Payload:
CampoObrigatórioDescrição
walletNameSimNome do novo grupo de carteira
Response 200: 
{ "walletId": "fb-wallet-abc123", "message": "External wallet created" }
Use o walletId retornado ao adicionar endereços a este grupo.

​
Adicionar um endereço a um grupo

Forneça walletId e os detalhes do endereço para registrar um novo endereço em um grupo existente. Payload:
CampoObrigatórioDescrição
walletNameSimNome do grupo existente
walletIdSimID do grupo de carteira Fireblocks (da resposta de criação)
addressSimEndereço cripto de destino
addressNameSimRótulo legível para este endereço
currencyCodeSimCódigo do ativo (ex: USDT_ETH, BTC)
Response 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_ETH",
}, "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_ETH",
}, "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" }