Como criar um link de pagamento cripto

Você pode criar um link de pagamento cripto sem desenvolver checkout e sem integrar uma API. No GramPayBot, o link manual começa como uma invoice: selecione o app, informe valor em USD e finalidade, acrescente uma referência interna, crie a cobrança e envie a URL do hosted checkout ao comprador.

Este guia serve para freelancer, agência, consultor ou pequena empresa que já combinou uma venda por chat ou email e quer cobrar agora. Para entender primeiro a categoria, leia como funcionam links de pagamento cripto. Para decidir entre um link e um endereço puro, veja payment link vs wallet address.

O que preparar antes de criar o link

Você não precisa de site, API key ou gerador próprio de QR code. Precisa de:

1. Uma conta GramPayBot.
2. Um app que represente esse fluxo de vendas.
3. Pelo menos uma receiving wallet verificada e uma payment route ativa.

Uma rota combina token, network e endereço do merchant. Um app pode aceitar USDT em TRON; outro, USDC em Base. Ative apenas combinações que sua empresa consegue operar. Dizer aceitamos USDT sem indicar rede deixa uma instrução incompleta.

GramPayBot não pede private key. O comprador envia para a public wallet configurada. O serviço organiza invoice, checkout e status; a receita não é recebida em um saldo custodial do provedor.

Exemplo usado neste guia

A Northstar Studio cobra 480 USD por suporte mensal do site. O registro interno é ORDER-5932, a descrição pública é Monthly website support e a private note é ORDER-5932 · SEPTEMBER. O cliente pagará em USDT na TRON.

Manter esses valores iguais em todas as etapas é essencial. Se o site mostra um preço, o chat informa outro e a invoice usa uma descrição genérica, o cliente não tem uma fonte confiável.

1. Selecione o app correto

No cabinet, abra Invoices → Create invoice. No Telegram, entre no menu de invoices do app que receberá o pagamento. O app define wallets, tokens e networks disponíveis no checkout.

Para consultoria simples, um app Client payments pode bastar. Separe apps quando marcas, equipes ou operações precisam de wallets e registros distintos. Escolher app errado pode exibir endereço ou rota diferente da desejada.

Antes de prosseguir, confira:

• nome do app;
• token set habilitado;
• rede necessária;
• receiving address;
• acesso da equipe à wallet;
• capacidade de enviar eventual refund dessa mesma operação.

2. Informe o valor final em USD

Digite o valor comercial já calculado. No exemplo, 480.00 USD. Checkout exibirá o exact token amount para a rota escolhida.

Não calcule e envie outro valor de token pelo chat. O comprador deve usar o número atual do checkout sem arredondar. Se a exchange desconta withdrawal fee, confirme que recipient receives continua igual ao amount solicitado.

Descontos, impostos e parcelas devem ser resolvidos no sistema de vendas antes da invoice. O link representa o valor final devido, não é uma calculadora de proposta.

3. Escreva uma public description útil

Essa descrição aparece para quem abre checkout. Ela deve permitir que o cliente reconheça a cobrança.

Boas opções:

• Monthly website support — September
• Brand identity — final milestone
• Product photography — order 184
• Website redesign — 50% deposit

Evite Payment, Invoice ou USDT. Não coloque dados pessoais, termos confidenciais ou comentários internos em campo público.

4. Acrescente a private note

A nota privada é para pesquisa e coordenação do vendedor. Pode conter order ID, nome comercial do cliente, proposal number ou referência da conversa. Exemplo: ORDER-5932 · SEPTEMBER.

Campo	Exemplo	Visibilidade
Amount	480.00 USD	Comprador e vendedor
Public description	Monthly website support	Comprador e vendedor
Private note	ORDER-5932 · SEPTEMBER	Apenas vendedor
App	Northstar Studio	Checkout e cabinet

Uma private note não substitui o ID único da invoice, mas permite que a equipe encontre rapidamente o contexto comercial.

5. Crie a invoice e revise o checkout

Ao selecionar Create invoice, o sistema gera public ID, checkout URL, rotas, status e expiry. No fluxo manual atual, a invoice fica ativa por 30 minutos e o formulário não oferece um prazo customizado. Se o cliente não pagar a tempo, emita uma nova em vez de incentivar uso do link antigo.

Abra a URL antes de enviar e confira:

• merchant/app correto;
• descrição e total em USD;
• somente tokens e networks operáveis;
• timer ativo e status waiting;
• exact token amount e recipient depois da escolha de rota.

A interface atual do GramPayBot foi capturada no produto com dados sintéticos. O site do vendedor é apenas um exemplo de integração.

O site do vendedor é ilustrativo; o checkout e o painel são telas reais e atuais do GramPayBot capturadas com dados sintéticos. Todas reutilizam ORDER-5932, 480 USD e USDT/TRON para mostrar um único fluxo coerente.

6. Envie uma única instrução canônica

Compartilhe a URL no canal onde a venda foi fechada. A mensagem deve dar contexto, não repetir endereço e rede com possibilidade de contradição.

Modelo para Telegram ou WhatsApp:

Link para pagamento do suporte mensal do site: [payment link] Antes de enviar, confira no checkout a rede USDT, o valor exato e o endereço. Se o prazo terminar, peça uma nova invoice.

Modelo de email:

Assunto: Payment link — suporte mensal de setembro Olá, [nome]. Aqui está o checkout da cobrança de 480 USD: [payment link] Selecione na wallet/exchange exatamente o token e a rede mostrados. O status será atualizado quando o pagamento correto for confirmado.

Não cole uma segunda wallet address ao lado do link. Duas fontes de instrução aumentam o risco de o comprador seguir a antiga.

7. Explique o checkout ao cliente

O comprador vê finalidade e total, escolhe token/network e recebe exact amount, recipient e QR. Antes de autorizar, deve comparar rede, token, endereço e valor na própria wallet ou exchange.

QR code reduz erro de digitação, mas não garante que a exchange escolheu a blockchain correta. Redes compatíveis com o mesmo formato de endereço ainda podem ser operacionalmente diferentes.

8. Acompanhe o status antes de entregar

• Waiting: não há qualifying payment; não faça fulfilment.
• Paid: a transferência esperada foi associada; continue segundo o acordo.
• Expired: acabou o prazo; revise qualquer pagamento tardio e crie outra invoice quando necessário.
• Cancelled: a cobrança foi encerrada; não reutilize.

Mensagem paguei, screenshot ou tx hash não substitui paid status. O hash pode pertencer a outra invoice ou endereço. Use o checklist de verificação e prevenção de screenshots falsos quando houver dúvida.

Erros comuns

Usar a mesma invoice para vários clientes

Crie uma por obrigação. Links exclusivos tornam amount, purpose, status e transaction record distinguíveis.

Escrever descrição vaga

O cliente deve reconhecer o pedido sem voltar à conversa. Nomeie serviço, produto ou milestone.

Confundir token com rede

USDT e USDC existem em várias blockchains. A combinação do checkout precisa ser repetida exatamente na wallet/exchange.

Mandar link expirado

Termos e valores podem mudar. Emita outra invoice e retire a antiga da conversa.

Entregar com base em captura

Espere status paid ou siga um procedimento de exceção autorizado. Uma imagem isolada não prova recipient, contract e confirmations.

Quando trocar o link manual por API?

O link é adequado quando uma pessoa negocia e cria cada cobrança. API e signed webhook fazem sentido quando pedidos nascem automaticamente, contas de usuário devem ser liberadas sem operador ou o volume torna inviável acompanhar manualmente.

É possível começar manualmente e automatizar depois. O comprador pode continuar usando hosted checkout; o que muda é quem cria a invoice e como o resultado entra no sistema comercial.

Crie seu primeiro payment link

Selecione o app, informe o valor final, escreva uma descrição pública reconhecível e uma nota interna pesquisável. Revise checkout, envie uma única URL e acompanhe a invoice em vez de caçar evidências no chat.

Abra o GramPayBot no Telegram, consulte o fluxo completo de links e invoices ou veja os preços atuais.