Links de pagamento

Para: Adm · Fin · Produto — Conferido em 2026-11-14.

Um link de pagamento é um endereço de página que você manda ao pagador por mensagem ou e-mail. Ao abrir, ele escolhe como pagar (PIX ou um ativo cripto), paga e acompanha o estado. Você não precisa gerar uma cobrança para cada pessoa: a cobrança nasce quando o pagador age.

O que é

  • O link não é uma cobrança. Ele não reserva endereço nem trava cotação. A cotação e o endereço de cripto nascem quando o pagador escolhe o método.
  • Cada link é de um jogador, definido na criação. Todas as cobranças feitas por esse link são atribuídas a ele.
  • O endereço do link é público e difícil de adivinhar. Quem o tem consegue abri-lo, então envie só a quem deve pagar.
Tipo de valor Como funciona
Fixo o valor é definido na criação; o pagador só escolhe o método
Aberto o pagador digita o valor, dentro de um mínimo e um máximo definidos na criação
Uso Como funciona
Único (padrão) a primeira cobrança paga encerra o link
Múltiplo aceita várias cobranças pagas, até um limite opcional

O link tem validade: por padrão 7 dias, no mínimo 5 minutos e no máximo 90 dias.

Quando usar

  • Cobrar alguém que não está dentro do seu produto (atendimento, cobrança avulsa, recarga combinada por conversa).
  • Deixar o pagador escolher entre PIX e cripto.
  • Ter uma URL única por pedido para acompanhar depois.

Se o seu produto já mostra o QR ao jogador na própria tela, use a cobrança direta, descrita em Cobrança em cripto e links de pagamento.

Como funciona

  1. O time técnico da operação cria o link pela API, informando o jogador, o valor, os métodos aceitos, a validade e uma descrição de até 140 caracteres (texto simples, sem dado pessoal). A resposta traz o endereço do link.
  2. Você envia o endereço ao pagador.
  3. O pagador abre a página, vê a descrição e o valor, escolhe o método e continua. Com cripto, a página mostra o valor exato no ativo, a rede, o endereço, o QR e a contagem regressiva.
  4. Quando o pagamento é confirmado, a operação recebe o aviso payment_link.paid e confere o estado pela API antes de creditar o jogador.
Estado Significado
Ativo pode receber cobranças
Pago encerrado por pagamento
Expirado passou da validade
Cancelado cancelado por você

Cancelar encerra o link e cancela as cobranças que ainda não receberam pagamento. Se um pagamento já foi detectado na rede, a cobrança segue até o fim, porque o dinheiro já está a caminho. Um link já pago ou expirado não pode ser cancelado.

O que o pagador vê

A página mostra o nome da operação, a descrição do link, o valor e os dados para pagar. Ela não mostra o jogador, o documento, identificadores internos, o spread, a cotação sem spread, tarifas nem o nome do provedor.

Os estados da cobrança (Aguardando pagamento, Pagamento detectado, Confirmando, Pagamento confirmado, Pagamento em análise, Cobrança expirada, Cobrança cancelada) estão explicados em Cripto.

Problemas comuns

Situação O que fazer
O pagador abre o link e vê "não encontrado" ou "indisponível" o link pode estar pago, expirado ou cancelado, ou o endereço foi copiado incompleto. Gere um novo link se for o caso
O pagador pagou e a página ficou em "Pagamento em análise" valor, ativo ou rede diferentes do indicado, ou pagamento depois do prazo. Peça a ele que guarde o endereço da página e acione o suporte
O pagador diz que pagou em cripto e nada mudou em "Pagamento detectado" ou "Confirmando" é só esperar as confirmações da rede. Só "Pagamento confirmado" credita
A cotação mudou entre a conversa e o pagamento a cotação trava quando o pagador escolhe o método, e vale pelo prazo mostrado na página. Passou o prazo, ele deve abrir o link de novo
O pagador enviou pela rede errada a cobrança vai para análise e o valor pode não ser recuperável. Oriente sempre a conferir a rede antes de enviar

Para outras dúvidas veja Suporte e FAQ.