Como funcionam os links de pagamento cripto

Um link de pagamento cripto é uma página de checkout compartilhável criada para uma cobrança específica. Em vez de mandar endereço da wallet, token, rede, valor e prazo em mensagens separadas, o vendedor cria uma invoice e envia uma URL. O comprador abre o link, identifica o que está pagando, escolhe uma rota USDT ou USDC habilitada e faz a transferência por uma wallet ou exchange compatível.

O dinheiro ainda se move on-chain para o endereço público configurado pelo vendedor. O valor do link não é custodiar os fundos: é acrescentar contexto comercial antes da transferência. A invoice registra finalidade, valor esperado, token, rede, prazo, identificador e status. Assim, a equipe não precisa reconstruir depois qual conversa ou cliente corresponde a uma entrada na wallet.

Esse fluxo atende freelancers, agências, consultores e pequenas empresas que fecham vendas por Telegram, WhatsApp ou email. Quando o pedido nasce automaticamente no site e a entrega precisa acontecer sem operador, use o fluxo de pagamentos cripto para sites.

Resposta curta: o que um payment link resolve?

Um endereço responde apenas para onde enviar fundos. Uma cobrança comercial precisa responder também:

• o que o cliente está comprando;
• qual token e blockchain devem ser usados;
• qual valor exato precisa chegar;
• até quando a solicitação é válida;
• se a transferência correta foi associada à invoice;
• quando o vendedor pode cumprir o pedido.

O payment link mantém essas condições em uma única página. Ele não torna a blockchain reversível nem corrige automaticamente uma transferência errada, mas dá ao comprador e ao vendedor a mesma versão das instruções.

Pergunta	Endereço em uma mensagem	Link rastreado
Finalidade	Explicada fora do pagamento	Aparece no checkout
Token e rede	Podem se perder na conversa	Vêm das rotas habilitadas
Valor	Digitado e conferido manualmente	Exibido como valor exato da invoice
Cliente ou pedido	Investigado depois	Relacionado a uma invoice própria
Prazo	Frequentemente informal	Visível por timer e expiry
Resultado	Depende de mensagem ou screenshot	Status waiting/paid/expired/cancelled

Como o link funciona, passo a passo

1. As condições da venda são combinadas

Produto ou serviço, preço, entrega e política de cancelamento/refund devem existir antes da cobrança. A payment link registra a obrigação de pagamento; não substitui proposta, contrato, pedido ou documento fiscal.

Crie uma invoice para cada obrigação. Dois clientes podem pagar o mesmo valor e um cliente pode ter vários milestones. Reutilizar o mesmo link elimina a separação que permite uma reconciliação segura.

2. O vendedor cria a invoice

No cabinet web ou no fluxo do Telegram, o vendedor escolhe o app correto, informa o valor em USD, escreve a public description e, se necessário, uma private note. O app determina quais wallets e rotas podem aparecer no checkout.

A descrição pública deve ser reconhecível, como Sinal do redesign do site. Evite apenas Pagamento. A private note pode guardar ACME · ORDER-4821 · SETEMBRO, porque esse campo é interno e serve para pesquisa e handoff entre membros da equipe.

3. O checkout é criado

A invoice recebe public ID, prazo, rotas disponíveis e URL do hosted checkout. Quando habilitado, o Telegram Mini App oferece outra forma de abrir a mesma cobrança. Não são invoices diferentes: ambos apontam para a mesma obrigação e o mesmo status.

Antes de enviar, o vendedor deve abrir o link e conferir finalidade, total em USD, métodos disponíveis e tempo restante. Essa revisão custa segundos e evita mandar uma cobrança de outro projeto.

4. O comprador escolhe token e rede

O checkout apresenta apenas rotas configuradas pelo vendedor. USDT sem rede não é instrução completa: USDT em TRON e USDT em Ethereum são ativos transferidos por redes diferentes. O mesmo vale para USDC e suas representações. Na wallet ou na tela de saque da exchange, o comprador precisa selecionar exatamente a combinação mostrada.

Não escolha uma rede só porque o nome parece parecido ou porque a taxa parece menor. Um ativo bridged ou um contrato diferente pode não ser reconhecido pela rota da invoice.

5. O comprador envia o valor exato

Depois da escolha, o checkout mostra exact token amount, recipient address e QR code. O QR reduz erro de cópia, mas o comprador ainda deve conferir token, rede, começo/fim do endereço e valor antes de confirmar.

Se a exchange desconta taxa do valor enviado, confira o campo equivalente a recipient receives. Arredondar ou deixar a taxa reduzir o recebimento pode gerar underpayment.

6. A invoice registra o resultado

Uma transação pode ter status success na blockchain e ainda assim não pagar a cobrança: talvez tenha ido para outro recipient, usado outro token ou pertencido a outra invoice. A correspondência confiável considera network, token contract/mint, recipient, amount, janela de tempo e identidade da transação. Quando as condições são atendidas, a invoice passa a paid e conserva a referência on-chain.

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

Exemplo completo: ORDER-4821

A Northstar Studio cobra um sinal de 125 USD por um projeto de website. Primeiro cria ORDER-4821 em seu sistema; depois abre uma invoice de 125 USD no GramPayBot. A public description é Website redesign deposit e a private note é ORDER-4821 · SEPTEMBER.

O comprador abre checkout, escolhe USDC na Base e envia 125.00 USDC para o endereço exibido. Quando a transferência qualificada é associada, a invoice muda de waiting para paid. O cabinet mostra token/rede, recipient, transaction reference e horário de pagamento no mesmo registro. O vendedor começa a entrega pelo status rastreado, não por um screenshot enviado no chat.

O site do vendedor é uma ilustração de integração. O checkout e o painel são telas reais e atuais do GramPayBot capturadas com dados sintéticos: pedido do site → checkout → invoice paga no painel.

Public description e private note

A public description aparece ao comprador. Ela deve ser curta, clara e livre de dados confidenciais. A private note pertence ao vendedor e pode armazenar order ID, cliente, proposta ou código interno.

Campo	Exemplo	Visibilidade
Public description	Website redesign deposit	Comprador e vendedor
Private note	ORDER-4821 · SEPTEMBER	Somente vendedor
Invoice ID	GP-4821	Checkout e cabinet
Transaction	0xB91E…7C20	Registro após pagamento

Essa separação reduz exposição de informação e melhora a busca quando várias cobranças têm valores semelhantes.

O que significam os status?

• Waiting: solicitação ativa; ainda não há pagamento qualificado associado. Não entregue.
• Paid: a transferência esperada foi reconhecida e registrada. Siga a entrega combinada.
• Expired: o prazo terminou sem fechamento da invoice. Se o acordo continua válido, crie outra cobrança.
• Cancelled: o vendedor encerrou a solicitação. Não reutilize o link.

Pagamentos tardios, rede errada, underpayment e overpayment precisam de uma política. A equipe pode revisar evidência, decidir se aceita, pedir diferença, emitir nova invoice ou iniciar refund da wallet que controla. O sistema não deve tomar uma decisão comercial irreversível sem dados suficientes.

Use os guias específicos para faturas não pagas, tardias ou vencidas, pagamentos abaixo ou acima do valor e USDT/USDC enviado na rede errada.

O que o link não resolve

O link não guarda private key, não reverte blockchain, não substitui documentação fiscal e não decide disputas. No modelo non-custodial do GramPayBot, a receita vai diretamente para a wallet configurada; backup, segurança, treasury e eventual refund continuam sob responsabilidade do merchant.

Um screenshot também não prova pagamento. Pode ser editado, mostrar operação pending ou outra transação. Um tx hash ajuda a localizar evidência, mas deve ser comparado com as condições da invoice. Consulte o checklist para verificar pagamento e evitar screenshots falsos.

Link manual ou integração via site/API?

Use link manual quando uma pessoa negocia cada venda, cria a cobrança e pode tratar exceções. Use invoice via API e webhook assinado quando pedidos surgem no sistema, acesso precisa ser liberado automaticamente ou o serviço funciona fora do horário da equipe.

Payment link manual	Fluxo website/API
Pessoa fecha a venda	Sistema cria o pedido
Pessoa cria a invoice	API cria a invoice
URL vai por chat ou email	Site abre checkout
Pessoa acompanha o status	Backend processa o resultado
Bom para serviços pontuais	Bom para volume repetível

Crie o primeiro link rastreado

Um bom payment link reúne finalidade, token, rede, valor, prazo e status. O cliente recebe uma instrução consistente; o vendedor recebe um registro que pode ser pesquisado, conciliado e usado para decidir a entrega.

Veja como criar um link de pagamento cripto, explore o caso de uso de links e invoices ou confira os preços atuais.