Consultar Conversão

curl https://checkout.noxpay.io/v2/rfq/NOXabc123 \
  -H "api-key: <key>"

import requests

response = requests.get(
    "https://checkout.noxpay.io/v2/rfq/NOXabc123",
    headers={"api-key": "<key>"},
)
print(response.json())

const response = await fetch(
  "https://checkout.noxpay.io/v2/rfq/NOXabc123",
  { headers: { "api-key": "<key>" } }
);
const data = await response.json();

{
  "rfq_id": "NOXabc123",
  "component": "settlement_rfq",
  "state": "AWAITING",
  "created_at": "2026-07-01T12:00:00Z",
  "updated_at": "2026-07-01T12:00:31Z",
  "attributes": {
    "from_currency": "USDT",
    "to_currency": "BRL",
    "quote_pair": "USDT_BRL",
    "from_amount_d0": 1000.0,
    "to_amount_d0": 5050.0,
    "rate_d0": 5.050,
    "from_amount_d1": 1000.0,
    "to_amount_d1": 5060.0,
    "rate_d1": 5.060,
    "settlement_eta_d0": "2026-07-01T19:00:00Z",
    "settlement_eta_d1": "2026-07-02T18:00:00Z",
    "expires_at": "2026-07-01T12:00:30Z",
    "renewable_up_to": "2026-07-01T12:10:00Z",
    "settlement_day": "d0",
    "amount_from": 1000.0,
    "amount_to": 5050.0,
    "rate": 5.050,
    "settlement_eta": "2026-07-01T19:00:00Z",
    "wallet_id": "...",
    "pix_key": null,
    "error_detail": "",
    "webhook": "https://seuapp.com/webhooks/nox"
  }
}

{ "error": "Not Found" }

curl https://checkout.noxpay.io/v2/rfq/NOXabc123 \
  -H "api-key: <key>"

import requests

response = requests.get(
    "https://checkout.noxpay.io/v2/rfq/NOXabc123",
    headers={"api-key": "<key>"},
)
print(response.json())

const response = await fetch(
  "https://checkout.noxpay.io/v2/rfq/NOXabc123",
  { headers: { "api-key": "<key>" } }
);
const data = await response.json();

{
  "rfq_id": "NOXabc123",
  "component": "settlement_rfq",
  "state": "AWAITING",
  "created_at": "2026-07-01T12:00:00Z",
  "updated_at": "2026-07-01T12:00:31Z",
  "attributes": {
    "from_currency": "USDT",
    "to_currency": "BRL",
    "quote_pair": "USDT_BRL",
    "from_amount_d0": 1000.0,
    "to_amount_d0": 5050.0,
    "rate_d0": 5.050,
    "from_amount_d1": 1000.0,
    "to_amount_d1": 5060.0,
    "rate_d1": 5.060,
    "settlement_eta_d0": "2026-07-01T19:00:00Z",
    "settlement_eta_d1": "2026-07-02T18:00:00Z",
    "expires_at": "2026-07-01T12:00:30Z",
    "renewable_up_to": "2026-07-01T12:10:00Z",
    "settlement_day": "d0",
    "amount_from": 1000.0,
    "amount_to": 5050.0,
    "rate": 5.050,
    "settlement_eta": "2026-07-01T19:00:00Z",
    "wallet_id": "...",
    "pix_key": null,
    "error_detail": "",
    "webhook": "https://seuapp.com/webhooks/nox"
  }
}

{ "error": "Not Found" }

Parâmetros de path

Parâmetro	Descrição
`id`	O `rfq_id` retornado por Criar Conversão

Response `200 OK`

Uma conversão passa por três componentes internos em sequência — quote_otc → rfq_swap → settlement_rfq. O campo component indica em qual etapa a conversão está, e state indica o status dentro dessa etapa.

Estados da conversão

quote_otc — a cotação em si, antes e até o aceite.

Estado	Significado
`QUOTE`	Cotação ativa; aguardando seu aceite
`DONE`	Aceita — saldo validado, operação travada, entrega agendada
`EXPIRED`	Taxa expirou; uma nova taxa foi gerada automaticamente — revise antes de aceitar
`DEPRECATED`	Janela de renovação encerrada; crie uma nova conversão
`ERROR`	Saldo insuficiente, limite excedido, moeda inválida ou outro erro de negócio

rfq_swap — lançamentos internos no ledger para a operação (ocorre logo após o aceite; não requer ação sua).

Estado	Significado
`INITIAL`	Registrando lançamentos do swap no ledger (transitório)
`DONE`	Lançamentos registrados; montante convertido mantido como um valor a receber, aguardando entrega
`ERROR`	Falha ao registrar — equipe de operações da Noxpay notificada

settlement_rfq — entrega dos fundos convertidos.

Estado	Significado
`AWAITING`	Aguardando a janela de liquidação (D0 ou D1)
`DONE`	Entrega concluída; fundos movidos para o seu saldo disponível
`ERROR`	Falha na entrega; fundos permanecem seguros como um valor a receber — equipe de operações da Noxpay notificada

Atributos

Campo	Tipo	Descrição
`from_currency`	string	Moeda de origem
`to_currency`	string	Moeda de destino
`quote_pair`	string	Par de cotação (ex: `USDT_BRL`)
`from_amount_d0`	float	Montante D0 a enviar
`to_amount_d0`	float	Montante D0 a receber
`rate_d0`	float	Taxa D0
`from_amount_d1`	float	Montante D1 a enviar
`to_amount_d1`	float	Montante D1 a receber
`rate_d1`	float	Taxa D1
`settlement_eta_d0`	string	ETA de liquidação D0 (RFC 3339)
`settlement_eta_d1`	string	ETA de liquidação D1 (RFC 3339)
`expires_at`	string	Expiração da cotação atual (RFC 3339)
`renewable_up_to`	string	Último momento em que a cotação pode ser aceita (RFC 3339)
`settlement_day`	string	`d0` ou `d1` — preenchido após o aceite
`amount_from`	float	Montante confirmado enviado — preenchido após o aceite
`amount_to`	float	Montante confirmado recebido — preenchido após o aceite
`rate`	float	Taxa confirmada — preenchida após o aceite
`settlement_eta`	string	ETA de liquidação confirmada — preenchida após o aceite
`wallet_id`	string	Wallet de destino, se aplicável
`pix_key`	string	Chave Pix de destino, se aplicável
`error_detail`	string	Mensagem de erro orientada ao cliente, se houver
`webhook`	string	URL de webhook configurada

404 — conversão não encontrada ou não pertence à sua conta.

curl https://checkout.noxpay.io/v2/rfq/NOXabc123 \
  -H "api-key: <key>"

import requests

response = requests.get(
    "https://checkout.noxpay.io/v2/rfq/NOXabc123",
    headers={"api-key": "<key>"},
)
print(response.json())

const response = await fetch(
  "https://checkout.noxpay.io/v2/rfq/NOXabc123",
  { headers: { "api-key": "<key>" } }
);
const data = await response.json();

{
  "rfq_id": "NOXabc123",
  "component": "settlement_rfq",
  "state": "AWAITING",
  "created_at": "2026-07-01T12:00:00Z",
  "updated_at": "2026-07-01T12:00:31Z",
  "attributes": {
    "from_currency": "USDT",
    "to_currency": "BRL",
    "quote_pair": "USDT_BRL",
    "from_amount_d0": 1000.0,
    "to_amount_d0": 5050.0,
    "rate_d0": 5.050,
    "from_amount_d1": 1000.0,
    "to_amount_d1": 5060.0,
    "rate_d1": 5.060,
    "settlement_eta_d0": "2026-07-01T19:00:00Z",
    "settlement_eta_d1": "2026-07-02T18:00:00Z",
    "expires_at": "2026-07-01T12:00:30Z",
    "renewable_up_to": "2026-07-01T12:10:00Z",
    "settlement_day": "d0",
    "amount_from": 1000.0,
    "amount_to": 5050.0,
    "rate": 5.050,
    "settlement_eta": "2026-07-01T19:00:00Z",
    "wallet_id": "...",
    "pix_key": null,
    "error_detail": "",
    "webhook": "https://seuapp.com/webhooks/nox"
  }
}

{ "error": "Not Found" }

Aceitar Conversão Cotação de Referência

​Parâmetros de path

​Response 200 OK

​Estados da conversão

​Atributos

Parâmetros de path

Response `200 OK`

Estados da conversão

Atributos