Checkout PIX

O checkout PIX é o trilho em que o comprador não sai do seu site. Ele informa nome e CPF, paga o QR, e o USDT cai na carteira cadastrada do parceiro.

Use este caminho quando a pessoa chega pronta para pagar em real. O checkout TRP clássico continua para quem já tem USDT e assina pelo TonConnect.

Como funciona

Seu backend cria o checkout com a API key (POST /v1/c). O generate do TRP não abre este trilho.
Você abre ou embeda https://api.tonramp.io/v1/c/{id}.
O comprador informa nome e CPF (a GOWD exige o pagador real) e paga o PIX.
O webhook avisa paid quando o PIX entra e completed quando o USDT chega na sua carteira.
Libere o pedido só no completed.

Não é preciso Telegram, carteira TON nem conta TonRamp na hora da compra.

Criar o checkout

curl -X POST https://api.tonramp.io/v1/c \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer tonr_SUA_API_KEY" \
  -d '{
    "amount": 10.00,
    "currency": "USDT",
    "tx_id": "pedido-001"
  }'

Resposta (200):

{
  "success": true,
  "id": "c_ab12cd34ef56ab78",
  "url": "https://api.tonramp.io/v1/c/c_ab12cd34ef56ab78",
  "tx_id": "pedido-001",
  "status": "pending",
  "amount_usdt": "10.000000",
  "amount_brl": "54.20",
  "needs_payer": true
}

O tx_id é o identificador do pedido do seu lado. Criar de novo o mesmo tx_id reusa o checkout ativo.

Consultar

GET /v1/c/{id} no navegador serve a página (nome, CPF, QR). Com Accept: application/json ou ?format=json devolve o estado:

Campo	Significado
`status`	`pending`, `paid`, `completed`, `error`, `expired`, `cancelled`, `refunded`
`needs_payer`	ainda falta nome e CPF para emitir o QR
`pix_copy_paste`	copia e cola PIX, depois que o QR foi gerado
`amount_brl` / `amount_usdt`	valor cobrado e USDT que você recebe

POST /v1/c/{id}/pay com { "full_name", "document" } emite o QR. A página hospedada já faz isso.

Iframe

<iframe
  src="https://api.tonramp.io/v1/c/c_ab12cd34ef56ab78"
  width="440"
  height="640"
  style="border: none; border-radius: 12px;"
></iframe>

Cadastre https://seudominio.com no console. Sem isso o navegador bloqueia o frame.