Definir Alias - Noxpay

curl -X POST https://checkout.noxpay.io/v2/naas/submerchants/alias \
  -H "api-key: <key>" \
  -H "X-Signature: <assinatura-do-corpo>" \
  -H "Content-Type: application/json" \
  -d '{
    "timestamp": "2026-05-27T14:30:00Z",
    "payload": {
      "correlation_id": "a1b2c3d4-e5f6-4789-abcd-000000000001",
      "alias": "acmepay"
    }
  }'

import requests

body, sig = sign_envelope({
    "correlation_id": "a1b2c3d4-e5f6-4789-abcd-000000000001",
    "alias": "acmepay",
})
response = requests.post(
    "https://checkout.noxpay.io/v2/naas/submerchants/alias",
    headers={"api-key": "<key>", "X-Signature": sig, "Content-Type": "application/json"},
    data=body,
)
print(response.json())

const { body, signature } = signEnvelope({
  correlation_id: "a1b2c3d4-e5f6-4789-abcd-000000000001",
  alias: "acmepay",
});
const response = await fetch("https://checkout.noxpay.io/v2/naas/submerchants/alias", {
  method: "POST",
  headers: { "api-key": "<key>", "X-Signature": signature, "Content-Type": "application/json" },
  body,
});
const data = await response.json();

{ "alias": "acmepay" }

{ "error": "alias contains invalid characters" }

curl -X POST https://checkout.noxpay.io/v2/naas/submerchants/alias \
  -H "api-key: <key>" \
  -H "X-Signature: <assinatura-do-corpo>" \
  -H "Content-Type: application/json" \
  -d '{
    "timestamp": "2026-05-27T14:30:00Z",
    "payload": {
      "correlation_id": "a1b2c3d4-e5f6-4789-abcd-000000000001",
      "alias": "acmepay"
    }
  }'

import requests

body, sig = sign_envelope({
    "correlation_id": "a1b2c3d4-e5f6-4789-abcd-000000000001",
    "alias": "acmepay",
})
response = requests.post(
    "https://checkout.noxpay.io/v2/naas/submerchants/alias",
    headers={"api-key": "<key>", "X-Signature": sig, "Content-Type": "application/json"},
    data=body,
)
print(response.json())

const { body, signature } = signEnvelope({
  correlation_id: "a1b2c3d4-e5f6-4789-abcd-000000000001",
  alias: "acmepay",
});
const response = await fetch("https://checkout.noxpay.io/v2/naas/submerchants/alias", {
  method: "POST",
  headers: { "api-key": "<key>", "X-Signature": signature, "Content-Type": "application/json" },
  body,
});
const data = await response.json();

{ "alias": "acmepay" }

{ "error": "alias contains invalid characters" }

Define o slug de URL usado para construir links de pagamento estáticos para um sub-merchant. O alias se torna o {slug} em https://checkout.noxpay.io/pay/{slug}/{link_path}.

correlation_id é obrigatório para este endpoint, mas não vai no envelope de nível superior — passe-o dentro do payload.

O alias pode ser atualizado a qualquer momento — ele sobrescreve o valor anterior.

Campos do payload

Campo	Tipo	Obrigatório	Descrição
`correlation_id`	string (UUID)	Sim	UUID retornado por Cadastrar Sub-merchant.
`alias`	string	Sim	Slug de URL. Apenas letras, números, `_` e `-`. Máx 32 caracteres.

Response `200 OK`

{ "alias": "acmepay" }

400 — correlation_id ou alias ausente ou inválido; alias falha na validação de formato. 404 — correlation_id não encontrado ou não pertence a este merchant master.

curl -X POST https://checkout.noxpay.io/v2/naas/submerchants/alias \
  -H "api-key: <key>" \
  -H "X-Signature: <assinatura-do-corpo>" \
  -H "Content-Type: application/json" \
  -d '{
    "timestamp": "2026-05-27T14:30:00Z",
    "payload": {
      "correlation_id": "a1b2c3d4-e5f6-4789-abcd-000000000001",
      "alias": "acmepay"
    }
  }'

import requests

body, sig = sign_envelope({
    "correlation_id": "a1b2c3d4-e5f6-4789-abcd-000000000001",
    "alias": "acmepay",
})
response = requests.post(
    "https://checkout.noxpay.io/v2/naas/submerchants/alias",
    headers={"api-key": "<key>", "X-Signature": sig, "Content-Type": "application/json"},
    data=body,
)
print(response.json())

const { body, signature } = signEnvelope({
  correlation_id: "a1b2c3d4-e5f6-4789-abcd-000000000001",
  alias: "acmepay",
});
const response = await fetch("https://checkout.noxpay.io/v2/naas/submerchants/alias", {
  method: "POST",
  headers: { "api-key": "<key>", "X-Signature": signature, "Content-Type": "application/json" },
  body,
});
const data = await response.json();

{ "alias": "acmepay" }

{ "error": "alias contains invalid characters" }