curl -X POST https://checkout.noxpay.io/v2/naas/crossramp_checkout \
-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": {
"currency_code": "USDT_ERC20",
"amount_fiat": 500.00,
"webhook": "https://seuservidor.com/webhook",
"return_url": "https://seuservidor.com/obrigado",
"payer_document": "12345678900"
}
}'
import requests
# sign_envelope definido em NaaS — Autenticação e Configuração
body, sig = sign_envelope({
"currency_code": "USDT_ERC20",
"amount_fiat": 500.00,
"webhook": "https://seuservidor.com/webhook",
"return_url": "https://seuservidor.com/obrigado",
"payer_document": "12345678900",
}, "a1b2c3d4-e5f6-4789-abcd-000000000001")
response = requests.post(
"https://checkout.noxpay.io/v2/naas/crossramp_checkout",
headers={"api-key": "<key>", "X-Signature": sig, "Content-Type": "application/json"},
data=body,
)
print(response.json())
// signEnvelope definido em NaaS — Autenticação e Configuração
const { body, signature } = signEnvelope({
currency_code: "USDT_ERC20",
amount_fiat: 500.00,
webhook: "https://seuservidor.com/webhook",
return_url: "https://seuservidor.com/obrigado",
payer_document: "12345678900",
}, "a1b2c3d4-e5f6-4789-abcd-000000000001");
const response = await fetch("https://checkout.noxpay.io/v2/naas/crossramp_checkout", {
method: "POST",
headers: { "api-key": "<key>", "X-Signature": signature, "Content-Type": "application/json" },
body,
});
const data = await response.json();
{ "link": "https://checkout.noxpay.io/e2e/NOXabc123" }
NaaS — Crossramp Checkout
Criar Checkout
POST /v2/naas/crossramp_checkout — cria um link de checkout para um sub-merchant.
curl -X POST https://checkout.noxpay.io/v2/naas/crossramp_checkout \
-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": {
"currency_code": "USDT_ERC20",
"amount_fiat": 500.00,
"webhook": "https://seuservidor.com/webhook",
"return_url": "https://seuservidor.com/obrigado",
"payer_document": "12345678900"
}
}'
import requests
# sign_envelope definido em NaaS — Autenticação e Configuração
body, sig = sign_envelope({
"currency_code": "USDT_ERC20",
"amount_fiat": 500.00,
"webhook": "https://seuservidor.com/webhook",
"return_url": "https://seuservidor.com/obrigado",
"payer_document": "12345678900",
}, "a1b2c3d4-e5f6-4789-abcd-000000000001")
response = requests.post(
"https://checkout.noxpay.io/v2/naas/crossramp_checkout",
headers={"api-key": "<key>", "X-Signature": sig, "Content-Type": "application/json"},
data=body,
)
print(response.json())
// signEnvelope definido em NaaS — Autenticação e Configuração
const { body, signature } = signEnvelope({
currency_code: "USDT_ERC20",
amount_fiat: 500.00,
webhook: "https://seuservidor.com/webhook",
return_url: "https://seuservidor.com/obrigado",
payer_document: "12345678900",
}, "a1b2c3d4-e5f6-4789-abcd-000000000001");
const response = await fetch("https://checkout.noxpay.io/v2/naas/crossramp_checkout", {
method: "POST",
headers: { "api-key": "<key>", "X-Signature": signature, "Content-Type": "application/json" },
body,
});
const data = await response.json();
{ "link": "https://checkout.noxpay.io/e2e/NOXabc123" }
Cria um link de checkout cripto→BRL vinculado ao sub-merchant identificado pelo
*Se nenhum dos dois for fornecido, o checkout aceita valor livre.
Response
Redirecione o cliente do sub-merchant para esta URL.
correlation_id. Um processo de split é criado automaticamente para transferir a parte configurada ao merchant master assim que o checkout for concluído.
Campos do payload
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
currency_code | string | Sim | Ativo cripto a receber (ex: USDT_ERC20, BTC) |
amount_fiat | number | Não* | Valor fixo em BRL que o pagador deve enviar |
amount_crypto | number | Não* | Valor fixo em cripto (alternativa a amount_fiat) |
webhook | string | Não | URL que recebe atualizações de status |
return_url | string | Não | URL para onde o pagador é redirecionado após o pagamento |
payer_document | string | Não | CPF ou CNPJ do pagador (apenas dígitos) |
payer_name | string | Não | Nome do pagador, usado ao criar um novo cadastro de cliente |
Response 200 OK
{ "link": "https://checkout.noxpay.io/e2e/NOXabc123" }
curl -X POST https://checkout.noxpay.io/v2/naas/crossramp_checkout \
-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": {
"currency_code": "USDT_ERC20",
"amount_fiat": 500.00,
"webhook": "https://seuservidor.com/webhook",
"return_url": "https://seuservidor.com/obrigado",
"payer_document": "12345678900"
}
}'
import requests
# sign_envelope definido em NaaS — Autenticação e Configuração
body, sig = sign_envelope({
"currency_code": "USDT_ERC20",
"amount_fiat": 500.00,
"webhook": "https://seuservidor.com/webhook",
"return_url": "https://seuservidor.com/obrigado",
"payer_document": "12345678900",
}, "a1b2c3d4-e5f6-4789-abcd-000000000001")
response = requests.post(
"https://checkout.noxpay.io/v2/naas/crossramp_checkout",
headers={"api-key": "<key>", "X-Signature": sig, "Content-Type": "application/json"},
data=body,
)
print(response.json())
// signEnvelope definido em NaaS — Autenticação e Configuração
const { body, signature } = signEnvelope({
currency_code: "USDT_ERC20",
amount_fiat: 500.00,
webhook: "https://seuservidor.com/webhook",
return_url: "https://seuservidor.com/obrigado",
payer_document: "12345678900",
}, "a1b2c3d4-e5f6-4789-abcd-000000000001");
const response = await fetch("https://checkout.noxpay.io/v2/naas/crossramp_checkout", {
method: "POST",
headers: { "api-key": "<key>", "X-Signature": signature, "Content-Type": "application/json" },
body,
});
const data = await response.json();
{ "link": "https://checkout.noxpay.io/e2e/NOXabc123" }