White label

O white label cobre a página de checkout que o comprador abre e, se você quiser, o console em um domínio seu. Você coloca a sua logo, a sua cor e aponta um CNAME para hosted.tonramp.io.

O pagamento em USDT acontece no app do TonRamp, aberto pelos botões da página de checkout. A marca vale na porta de entrada (checkout e painel), não no fluxo de pagamento inteiro.

Nota

Tudo isso se configura no console, em Checkout. Só o owner da conta altera logo, cor e domínio.

Marca

Na mesma tela Checkout:

Campo	O que faz
Logo	PNG, JPEG ou WebP, até 96 KB. Fundo transparente funciona melhor: a página tem tema claro e escuro. Sem logo, aparece a marca TonRamp.
Cor da marca	Hex #rrggbb. No checkout, pinta o valor e o botão de pagar. No console, pinta o chrome (botões e anel de foco). O texto sobre a cor é escolhido por contraste, para uma marca clara não gerar botão ilegível.

A assinatura “Powered by TonRamp” permanece no rodapé do checkout.

No console.tonramp.io a tela de login continua com a identidade TonRamp (ainda não sabemos quem está entrando). Depois do login, logo e cor do parceiro aparecem no painel. Num domínio próprio do console, a marca já aparece na tela de login.

Domínio próprio

O CNAME é o mesmo nos dois casos: hosted.tonramp.io. O que muda é o tipo do hostname.

Tipo	Limite	Sem domínio	Com domínio ativo
Checkout	3	https://trp.tonramp.io/trp/{payload}	https://trp.sualoja.com/trp/{payload}
Console	1	https://console.tonramp.io	https://console.sualoja.com

hosted.tonramp.io não é um site: sozinho ele responde 404. É só o alvo estável do CNAME. No hostname de console, o tráfego vai para o painel (console.tonramp.io); no de checkout, para a página de pagamento.

Magic link e convite passam a apontar para o domínio do console assim que ele fica ativo.

Como apontar

1. Cadastre o hostname no console primeiro.

   Em Checkout, informe o host em Domínio do checkout (ex.: trp.sualoja.com) ou em Domínio do console (ex.: console.sualoja.com). Não use um domínio *.tonramp.io.

   A ordem importa: se você criar o CNAME antes do cadastro, a Cloudflare recusa o apontamento (erro 1014).

2. Crie os registros no DNS da sua zona.

   O console mostra os valores exatos. Em resumo:

   Tipo	Nome	Valor
   CNAME	o hostname cadastrado	hosted.tonramp.io
   TXT	o nome que a Cloudflare devolver (validação do certificado)	o valor TXT correspondente

3. Clique em Verificar.

   Não há webhook da Cloudflare para isso. Quando o certificado fica ativo, o host passa a responder.

Status no console	Significado
Aguardando DNS	Cadastrou, mas CNAME ou TXT ainda não bateram.
Ativo	Certificado emitido. Checkout ou console já atende nesse host.
Falhou	Algo no DNS ou na emissão. O último erro aparece na tela.

Cuidado

Um hostname fora de *.tonramp.io só serve tráfego se estiver cadastrado, ativo, for o seu e for do tipo certo. Host desconhecido, ainda pendente, de outro parceiro, ou de console usado como checkout recebe 404. Isso impede alguém de apontar um CNAME para o nosso ingresso e hospedar uma página com a nossa cara.

URL do checkout depois de ativo

O deep_link da API continua apontando para trp.tonramp.io. No seu frontend, monte o link com o seu host:

https://trp.sualoja.com/trp/{payload}

O iframe usa a mesma URL no src. O domínio da página que embute o iframe continua precisando estar autorizado em Checkout (política frame-ancestors); isso é independente do domínio próprio. Veja Iframe.

O que o white label não muda

• Mini App / Telegram: o comprador que paga via Telegram vê o app TonRamp.
• Checkout PIX (https://api.tonramp.io/v1/c/{id}): URL e certificado nossos. A marca da página TRP não se aplica a esse trilho.
• Taxa e liquidação: o amount vai para a wallet cadastrada do parceiro; a TonRamp fica com a parte dela no spread e a taxa fixa.

Onde configurar

1. Abra o console.
2. Entre em Checkout.
3. Envie o logo e a cor (valem no checkout e no painel).
4. Se quiser o domínio próprio, cadastre o hostname antes de criar o CNAME para hosted.tonramp.io.