Integração

Caminhos que se combinam. Comece pela API autenticada: os outros dependem do payload ou do checkout que ela gera.

Página	Quando usar
API	Gerar o payload de cobrança pelo seu servidor. É o ponto de partida de qualquer integração.
Checkout	Enviar o comprador para a página de pagamento hospedada por nós, por link ou QR code.
Checkout PIX	Só o QR PIX no seu site. O pagamento fecha no iframe; o USDT cai na sua carteira.
Iframe	Incorporar o checkout dentro do seu site. Exige autorizar o seu domínio no console.
White label	Logo, cor da marca e domínio próprio (CNAME para hosted.tonramp.io) no checkout e no console.
Merchants	Lojas sob o parceiro, piso da taxa TonRamp e split da comissão.
Webhook	Receber a mudança de status no seu backend, em vez de ficar consultando.
OpenAPI e SDK	Schema oficial e como gerar o client TypeScript ou Python.

Roteiro sugerido

1. Peça a sua chave de API no console e gere um payload de teste com POST /v1/wallet/trp/generate.
2. Abra o checkout com esse payload e confirme que o nome do seu estabelecimento e o valor aparecem certos.
3. Configure o webhook e dispare um teste, para validar a assinatura antes de qualquer pagamento real.
4. Só então libere pedidos de verdade, liberando o crédito ao comprador apenas no evento completed.