Pagamento por WhatsApp ou e-mail
Compartilhe o mesmo endereço pelo canal que sua empresa já usa. O envio é feito por você ou pela integração do seu sistema.
LINK DE PAGAMENTO PIX E BOLETO
Link de pagamento para oferecer Pix e boleto ao cliente.
Crie uma página de pagamento e envie o endereço por WhatsApp, e-mail ou mensagem. O cliente confere o valor e escolhe entre os meios oferecidos. Sua empresa acompanha a transação pelo portal ou pela integração, sem construir um checkout próprio.
- 1 link
- com os meios habilitados
- Página pronta
- no domínio do Calebe Pay
- Vencimento
- definido por cobrança
- Webhook
- acompanha a transação gerada
PASSO A PASSO
Como criar e enviar um link de pagamento
Use a criação de cobrança no portal ou automatize o fluxo do seu sistema com POST /v1/checkouts.
- 01
Defina a cobrança
Informe valor, referência, descrição, dados do pagador, meios aceitos e vencimento. Na API, preserve também o Idempotency-Key.
- 02
Compartilhe o link retornado
Envie o checkout_url por seu canal de atendimento ou associe o endereço ao pedido e à fatura. Criar o link ainda não emite a transação no provedor.
- 03
O cliente escolhe o meio de pagamento
A página apresenta os meios disponíveis e gera a cobrança quando o cliente escolhe. Ele acessa os dados do Pix ou do boleto nessa página.
- 04
Acompanhe o pagamento
Consulte a transação gerada e receba o webhook de mudança de status. A emissão da cobrança não significa que o cliente já pagou.
EXEMPLO REAL DA API
Exemplo de link de pagamento por API
Ofereça Pix, boleto ou ambos conforme as permissões e a configuração da conta. O exemplo contém dados fictícios para teste.
- methods aceita ["pix"], ["boleto"] ou os dois. A chave precisa das permissões de todos os meios oferecidos.
- due_date define o vencimento do link e do boleto; cada Pix tem validade limitada a 24 horas.
- Guarde checkout_url e o ID do checkout. Depois da escolha, consulte o transaction_id gerado para confirmar o pagamento.
curl --fail-with-body https://api.calebepay.com.br/v1/checkouts \
-H "X-API-Key: $CALEBE_API_KEY" \
-H "Idempotency-Key: pedido-1001-link" \
-H "Content-Type: application/json" \
-d '{
"amount": 15990,
"reference": "PED-1001",
"description": "Mensalidade de outubro",
"methods": ["pix", "boleto"],
"due_date": "2026-10-13",
"customer": {
"name": "Cliente de demonstração",
"document": "00000000000",
"email": "cliente@example.com",
"phone": "11999998888",
"address": {
"zip_code": "01310100", "street": "Avenida Paulista", "number": "1000",
"district": "Bela Vista", "city": "São Paulo", "state": "SP"
}
}
}'
# Resposta 201: { "data": { "checkout_url": "https://...", "status": "open" } }
# Envie o checkout_url a quem vai pagar: ele escolhe Pix ou boleto.RECURSOS
Um checkout pronto para a sua cobrança
Indicado para pedidos assistidos, faturas e vendas em que enviar um endereço é mais prático que desenvolver outra tela.
Escolha entre Pix e boleto
Ofereça os meios habilitados na conta e deixe o cliente selecionar antes da emissão da cobrança.
Prazo definido no pedido
O link aceita a escolha até o fim do dia de vencimento, no horário de São Paulo. O boleto usa a mesma data.
Acompanhamento integrado
A transação segue as regras de cobrança, tarifas, divisão e webhooks configuradas para a conta.
Link de pagamento para vender pelo WhatsApp
Depois de combinar uma venda, o atendimento pode enviar o endereço da cobrança na própria conversa. A página apresenta o valor e os meios oferecidos, reduzindo a necessidade de trocar códigos e instruções manualmente.
A confirmação deve vir do estado da transação no Calebe Pay. Uma mensagem do cliente ou um comprovante enviado no chat não substitui a consulta do pagamento pela operação.
Link de pagamento para mensalidades e faturas
Seu sistema pode criar um link por fatura e guardar a referência do período correspondente. O cliente escolhe como pagar a cobrança daquele mês, e o financeiro relaciona a transação à fatura original.
Cada ciclo exige uma nova cobrança criada pelo sistema ou pelo portal. Este fluxo não agenda débito recorrente e não corresponde ao produto Pix Automático.
Emita boletos a partir das faturas do ERP →Automatize links pela API de pagamento →
O que acontece depois da escolha do cliente
O checkout passa a apontar para a transação gerada. Se for um Pix que expira sem pagamento antes do vencimento do link, a página pode voltar a oferecer uma nova escolha. Depois de um boleto emitido, o link continua levando àquele boleto.
O status completed do checkout significa que uma cobrança foi gerada, não que foi paga. Para liberar a venda, verifique o status paid da transação e o ambiente de produção. Essa distinção evita confundir emissão com recebimento.
PERGUNTAS FREQUENTES
Dúvidas sobre link de pagamento
Não achou a resposta? Fale com um especialista pelo WhatsApp.
O que é um link de pagamento?
É um endereço que abre uma página para pagar uma cobrança. No Calebe Pay, você define os meios disponíveis entre Pix e boleto; a transação é criada quando o cliente escolhe o meio de pagamento.
Posso criar link de pagamento sem loja virtual?
Sim. A página de pagamento é hospedada pelo Calebe Pay. Você pode criar a cobrança no portal e compartilhar o link, ou usar a API para automatizar esse processo no seu sistema.
Até quando o link de pagamento vale?
Até o fim do dia definido em due_date, no horário de São Paulo. Na criação, a data pode ser de hoje até 365 dias à frente. Cada Pix gerado tem validade máxima de 24 horas, limitada ao vencimento do link.
O cliente pode trocar o meio depois de escolher?
Um Pix expirado sem pagamento pode reabrir a escolha enquanto o link estiver no prazo. Um boleto já emitido não reabre a escolha: o link continua apresentando esse boleto.
Como saber se o link de pagamento foi pago?
Confira a transação indicada por transaction_id, pelo portal, API ou webhook. O checkout completed informa a geração da cobrança; apenas a transação paid em produção confirma o pagamento real.
O link de pagamento aceita cartão de crédito?
Este checkout oferece Pix e boleto. O campo methods da API de links aceita pix, boleto ou os dois, conforme a configuração e as permissões da conta.
CADASTRO 100% ONLINE · CERCA DE 6 MINUTOS