Consultar Offramp

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

import requests

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

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

{
  "version": "v1",
  "end2end": "NOXdef789",
  "created_at": "2024-05-02T09:00:00Z",
  "updated_at": "2024-05-02T09:10:00Z",
  "process": "success.completed",
  "status": { "en": "Success", "pt": "Sucesso", "es": "Éxito" },
  "substatus": { "en": "Success", "pt": "Sucesso", "es": "Éxito" },
  "message": { "en": "Transaction completed successfully", "pt": "Transação concluída com sucesso", "es": "Transacción completada con éxito" },
  "error_message": { "en": "", "pt": "", "es": "" },
  "attributes": {
    "quote": 5,
    "ref_quote": 5,
    "fees": 10,
    "currency_exit": "BRL",
    "currency_entry_paid": "USDT (TRX)",
    "currency_entry_paid_code": "TRX_USDT_S2UZ",
    "amount_paid": 100.00,
    "amount_sent": 490.00,
    "pix_e2e": "E00038166202405020900...",
    "client_name": "Carlos Lima",
    "client_tax_id": "11122233344",
    "expiration": "2024-05-02T09:30:00Z",
    "return_url": "https://seuapp.com/concluido",
    "external_code": "payout_7",
    "webhook": "https://seuapp.com/webhooks/nox",
    "pix_key": "email@example.com",
    "pix_key_type": "email"
  }
}

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

import requests

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

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

{
  "version": "v1",
  "end2end": "NOXdef789",
  "created_at": "2024-05-02T09:00:00Z",
  "updated_at": "2024-05-02T09:10:00Z",
  "process": "success.completed",
  "status": { "en": "Success", "pt": "Sucesso", "es": "Éxito" },
  "substatus": { "en": "Success", "pt": "Sucesso", "es": "Éxito" },
  "message": { "en": "Transaction completed successfully", "pt": "Transação concluída com sucesso", "es": "Transacción completada con éxito" },
  "error_message": { "en": "", "pt": "", "es": "" },
  "attributes": {
    "quote": 5,
    "ref_quote": 5,
    "fees": 10,
    "currency_exit": "BRL",
    "currency_entry_paid": "USDT (TRX)",
    "currency_entry_paid_code": "TRX_USDT_S2UZ",
    "amount_paid": 100.00,
    "amount_sent": 490.00,
    "pix_e2e": "E00038166202405020900...",
    "client_name": "Carlos Lima",
    "client_tax_id": "11122233344",
    "expiration": "2024-05-02T09:30:00Z",
    "return_url": "https://seuapp.com/concluido",
    "external_code": "payout_7",
    "webhook": "https://seuapp.com/webhooks/nox",
    "pix_key": "email@example.com",
    "pix_key_type": "email"
  }
}

Cobre os templates: offramp (saldo → BRL) e offramp_instant (depósito externo de cripto → BRL). Campos marcados com o nome do template estão presentes apenas naquela variante.

Parâmetros de caminho

Parâmetro	Descrição
`id`	O identificador `end2end` (ex: `NOXdef789`), o `pix_e2e` do pagamento, ou o `tx_hash` on-chain

Se {id} não casar com um end2end, ele é tentado contra o ID end-to-end do Pix e depois contra o hash da transação — os três funcionam na mesma rota, sem parâmetro extra.

Response `200 OK`

Attributes — `offramp`

Campo	Tipo	Descrição
`quote`	integer	Taxa de câmbio cripto→BRL efetiva utilizada
`ref_quote`	integer	Taxa de referência mid-market
`fees`	integer	Total de tarifas
`currency_exit`	string	Moeda de pagamento fiat — sempre `BRL`
`currency_entry_paid`	string	Nome exibido do ativo cripto (ex: `USDT (TRX)`)
`currency_entry_paid_code`	string	Código da moeda cripto
`amount_paid`	float	Valor em cripto debitado do seu saldo
`amount_sent`	float	Valor em BRL que o beneficiário recebe
`pix_key`	string	Chave PIX para a qual o BRL foi enviado
`pix_key_type`	string	Tipo de chave PIX (`cpf`, `cnpj`, `email`, `phone`, `random`)
`pix_e2e`	string	ID end-to-end do PIX (preenchido após o pagamento)
`client_name`	string	Nome do beneficiário
`client_tax_id`	string	CPF ou CNPJ do beneficiário
`expiration`	string	Timestamp de expiração da sessão (ISO 8601)
`return_url`	string	URL de redirecionamento pós-checkout
`external_code`	string	Referência do lojista
`webhook`	string	URL de webhook

Attributes — `offramp_instant`

Campo	Tipo	Descrição
`quote`	integer	Taxa de câmbio cripto→BRL efetiva utilizada
`ref_quote`	integer	Taxa de referência mid-market
`fees`	integer	Total de tarifas
`currency_payment`	string	Moeda cripto que o pagador envia
`currency_received`	string	Moeda fiat que o beneficiário recebe
`amount_payment`	float	Valor em cripto enviado pelo pagador
`amount_received`	float	Valor em BRL que o beneficiário recebe
`amount_payment_display`	string	Exibição formatada do valor em cripto
`deposit_address`	string	Endereço de depósito blockchain para o qual o pagador deve enviar
`deposit_currency`	string	Código de moeda para o depósito
`exact_deposit_amount`	string	Valor exato com sufixo necessário (deve ser enviado com precisão)
`tx_hash`	string	Hash da transação on-chain do depósito de entrada
`pix_key`	string	Chave PIX para a qual o BRL foi enviado
`pix_key_type`	string	Tipo de chave PIX (`cpf`, `cnpj`, `email`, `phone`, `random`)
`pix_e2e`	string	ID end-to-end do PIX (preenchido após o pagamento)
`client_name`	string	Nome do beneficiário
`client_tax_id`	string	CPF ou CNPJ do beneficiário
`expiration`	string	Timestamp de expiração da sessão
`return_url`	string	URL de redirecionamento pós-checkout
`external_code`	string	Referência do lojista
`webhook`	string	URL de webhook

Para offramp_instant, sempre exiba exact_deposit_amount ao pagador — não um número arredondado. O valor com sufixo é como a Noxpay identifica a qual sessão um depósito pertence.

Atributo de valor vazio é omitido, então chave ausente significa que aquela etapa ainda não aconteceu.

Responses desta rota carregam version: "v1" no envelope. É um rótulo herdado, não a versão do contrato — esta é uma rota /v2/ sobre o mesmo contrato de todas as outras. Não ramifique por ele.

404 — transação não encontrada ou não pertence à sua conta. Os dois casos são deliberadamente indistinguíveis. Para todos os valores de status / substatus veja Statuses do Offramp.

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

import requests

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

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

{
  "version": "v1",
  "end2end": "NOXdef789",
  "created_at": "2024-05-02T09:00:00Z",
  "updated_at": "2024-05-02T09:10:00Z",
  "process": "success.completed",
  "status": { "en": "Success", "pt": "Sucesso", "es": "Éxito" },
  "substatus": { "en": "Success", "pt": "Sucesso", "es": "Éxito" },
  "message": { "en": "Transaction completed successfully", "pt": "Transação concluída com sucesso", "es": "Transacción completada con éxito" },
  "error_message": { "en": "", "pt": "", "es": "" },
  "attributes": {
    "quote": 5,
    "ref_quote": 5,
    "fees": 10,
    "currency_exit": "BRL",
    "currency_entry_paid": "USDT (TRX)",
    "currency_entry_paid_code": "TRX_USDT_S2UZ",
    "amount_paid": 100.00,
    "amount_sent": 490.00,
    "pix_e2e": "E00038166202405020900...",
    "client_name": "Carlos Lima",
    "client_tax_id": "11122233344",
    "expiration": "2024-05-02T09:30:00Z",
    "return_url": "https://seuapp.com/concluido",
    "external_code": "payout_7",
    "webhook": "https://seuapp.com/webhooks/nox",
    "pix_key": "email@example.com",
    "pix_key_type": "email"
  }
}

Primeiros Passos

Conta Global

Crossramp Checkout

Conversions

Noxpay Infra

NaaS — Configuração

NaaS — Gestão de Sub-merchants

NaaS — Crossramp Checkout

NaaS — Conta Global

NaaS — Splits

Referência

Consultar Offramp

Parâmetros de caminho

Response `200 OK`

Attributes — `offramp`

Attributes — `offramp_instant`

​Parâmetros de caminho

​Response 200 OK

​Attributes — offramp

​Attributes — offramp_instant

Parâmetros de caminho

Response `200 OK`

Attributes — `offramp`

Attributes — `offramp_instant`