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();
{
"version": "v2",
"end2end": "NOXabc123",
"created_at": "2026-07-01T12:00:00Z",
"updated_at": "2026-07-01T12:00:31Z",
"process": "otc_settlement.awaiting",
"status": { "en": "Processing", "pt": "Processando", "es": "Procesando" },
"substatus": { "en": "OTC Delivery Scheduled", "pt": "Entrega OTC Agendada", "es": "Entrega OTC Programada" },
"message": { "en": "Trade locked; awaiting the settlement window", "pt": "Operação travada; aguardando a janela de liquidação", "es": "Operación fijada; esperando la ventana de liquidación" },
"error_message": { "en": "", "pt": "", "es": "" },
"attributes": {
"from_currency": "TRX_USDT_S2UZ",
"to_currency": "BRL",
"quote_pair": "USDT (TRX)/BRL (PIX)",
"from_amount_d0": 1000.0,
"to_amount_d0": 5050.0,
"rate_d0": 5.050,
"fee_d0": 12.5,
"from_amount_d1": 1000.0,
"to_amount_d1": 5060.0,
"rate_d1": 5.060,
"fee_d1": 10.0,
"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",
"d0_available": "true",
"settlement_day": "d0",
"amount_from": 1000.0,
"amount_to": 5050.0,
"rate": 5.050,
"fee_applied": 12.5,
"settlement_eta": "2026-07-01T19:00:00Z",
"amount_brl": 5050.0,
"wallet_id": "...",
"webhook": "https://seuapp.com/webhooks/nox"
}
}
Conversions
Consultar Conversão
GET /v2/rfq/ — retorna o estado atual e os atributos de uma 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();
{
"version": "v2",
"end2end": "NOXabc123",
"created_at": "2026-07-01T12:00:00Z",
"updated_at": "2026-07-01T12:00:31Z",
"process": "otc_settlement.awaiting",
"status": { "en": "Processing", "pt": "Processando", "es": "Procesando" },
"substatus": { "en": "OTC Delivery Scheduled", "pt": "Entrega OTC Agendada", "es": "Entrega OTC Programada" },
"message": { "en": "Trade locked; awaiting the settlement window", "pt": "Operação travada; aguardando a janela de liquidação", "es": "Operación fijada; esperando la ventana de liquidación" },
"error_message": { "en": "", "pt": "", "es": "" },
"attributes": {
"from_currency": "TRX_USDT_S2UZ",
"to_currency": "BRL",
"quote_pair": "USDT (TRX)/BRL (PIX)",
"from_amount_d0": 1000.0,
"to_amount_d0": 5050.0,
"rate_d0": 5.050,
"fee_d0": 12.5,
"from_amount_d1": 1000.0,
"to_amount_d1": 5060.0,
"rate_d1": 5.060,
"fee_d1": 10.0,
"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",
"d0_available": "true",
"settlement_day": "d0",
"amount_from": 1000.0,
"amount_to": 5050.0,
"rate": 5.050,
"fee_applied": 12.5,
"settlement_eta": "2026-07-01T19:00:00Z",
"amount_brl": 5050.0,
"wallet_id": "...",
"webhook": "https://seuapp.com/webhooks/nox"
}
}
Parâmetros de path
| Parâmetro | Descrição |
|---|---|
id | O rfq_id retornado por Criar Conversão |
Este GET tem efeito colateral. Antes de ler, uma cotação expirada que ainda esteja dentro da janela de
renewable_up_to é renovada — com taxas novas. Duas leituras consecutivas do mesmo rfq_id podem legitimamente devolver valores diferentes para rate_d0 / rate_d1 e para os montantes derivados deles. Leia a conversão uma vez, aja sobre aquele retrato, e não assuma que a leitura é idempotente.Response 200 OK
Devolve o envelope padrão do Objeto de Transação. Acompanhe o progresso por status e substatus; veja Status de conversões para o conjunto completo de valores.
Atributos — a cotação
Presentes desde a criação.| Campo | Tipo | Descrição |
|---|---|---|
from_currency | string | Moeda de origem |
to_currency | string | Moeda de destino |
quote_pair | string | Par de cotação, no formato <nome exibido da origem>/<nome exibido do destino> — nomes exibidos, não códigos de moeda (ex: USDT (TRX)/BRL (PIX)) |
from_amount_d0 | float | Montante D0 a enviar |
to_amount_d0 | float | Montante D0 a receber |
rate_d0 | float | Taxa D0 |
fee_d0 | float | Tarifa que se aplica caso você aceite D0 |
from_amount_d1 | float | Montante D1 a enviar |
to_amount_d1 | float | Montante D1 a receber |
rate_d1 | float | Taxa D1 |
fee_d1 | float | Tarifa que se aplica caso você aceite 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 | Quando a taxa atual expira (RFC 3339) |
renewable_up_to | string | Último momento em que a cotação pode ser renovada, em vez de recriada (RFC 3339) |
d0_available | string | Se a mesa está aberta para liquidação no mesmo dia |
webhook | string | URL de webhook configurada |
Atributos — depois do aceite
Estas chaves são ausentes até você aceitar, e é essa ausência que diz que nenhuma decisão foi tomada ainda. Verifique a presença da chave, não se o valor é zero.| Campo | Tipo | Descrição |
|---|---|---|
settlement_day | string | d0 ou d1 — a janela que você escolheu |
amount_from | float | Montante confirmado enviado |
amount_to | float | Montante confirmado recebido |
rate | float | Taxa confirmada |
fee_applied | float | A tarifa efetivamente cobrada |
settlement_eta | string | ETA de liquidação confirmada (RFC 3339) |
wallet_id | string | Wallet de destino, em pagamento em cripto |
pix_key | string | Chave Pix de destino, em pagamento em BRL |
amount_brl | float | Grandeza em BRL da operação aceita — o número que consumiu o seu teto |
fee_d0 e fee_d1 continuam visíveis depois do aceite, ao lado de fee_applied. As tarifas candidatas não são suprimidas depois da escolha — leia fee_applied para saber o que foi efetivamente cobrado.Atributos — recusas e tetos
Presentes apenas quando aplicável.| Campo | Tipo | Descrição |
|---|---|---|
error_detail | string | Explicação da recusa ou falha, orientada ao cliente |
limit_block_source | string | Qual portão barrou a operação: operational para o teto da mesa, compliance para a escada de KYB. Ausente quando a recusa foi por saldo insuficiente |
payout_limit_currency | string | Moeda em que o teto de pagamento é denominado |
payout_limit_available | float | Folga restante no teto de pagamento |
payout_limit_projected | float | Folga no teto de pagamento após esta operação |
payout_limit_* são informativos — o eixo de pagamento não é aplicado neste endpoint.
Qualquer atributo de valor vazio é omitido por completo, em vez de vir como "" ou null.
Códigos de retorno
| HTTP | Quando |
|---|---|
200 | Encontrado |
401 | api-key ausente ou inválida |
404 | Não existe, ou pertence a outra conta — deliberadamente indistinguíveis |
500 | Erro interno |
401, 404 e 500 são devolvidos apenas como linha de status, sem corpo.
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();
{
"version": "v2",
"end2end": "NOXabc123",
"created_at": "2026-07-01T12:00:00Z",
"updated_at": "2026-07-01T12:00:31Z",
"process": "otc_settlement.awaiting",
"status": { "en": "Processing", "pt": "Processando", "es": "Procesando" },
"substatus": { "en": "OTC Delivery Scheduled", "pt": "Entrega OTC Agendada", "es": "Entrega OTC Programada" },
"message": { "en": "Trade locked; awaiting the settlement window", "pt": "Operação travada; aguardando a janela de liquidação", "es": "Operación fijada; esperando la ventana de liquidación" },
"error_message": { "en": "", "pt": "", "es": "" },
"attributes": {
"from_currency": "TRX_USDT_S2UZ",
"to_currency": "BRL",
"quote_pair": "USDT (TRX)/BRL (PIX)",
"from_amount_d0": 1000.0,
"to_amount_d0": 5050.0,
"rate_d0": 5.050,
"fee_d0": 12.5,
"from_amount_d1": 1000.0,
"to_amount_d1": 5060.0,
"rate_d1": 5.060,
"fee_d1": 10.0,
"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",
"d0_available": "true",
"settlement_day": "d0",
"amount_from": 1000.0,
"amount_to": 5050.0,
"rate": 5.050,
"fee_applied": 12.5,
"settlement_eta": "2026-07-01T19:00:00Z",
"amount_brl": 5050.0,
"wallet_id": "...",
"webhook": "https://seuapp.com/webhooks/nox"
}
}