Pagamentos em mini apps do Telegram: receber cripto dentro de um mini app
Pagamentos em mini apps do Telegram explicados: receber cripto dentro de um mini app, o que a Qvard prevê para o checkout de mini apps e o caminho da API hoje.
Pagamentos em mini apps do Telegram significam que uma loja feita como aplicativo web dentro do Telegram recebe cripto pelos seus itens. A Qvard prevê um checkout para mini apps, que ainda não foi lançado. Este guia explica como funcionaria um pagamento em mini app e o caminho que funciona hoje: o backend do mini app cria o pagamento pela API, abre a página hospedada e confirma o pedido por webhook.
O que é um pagamento em mini app
Um mini app do Telegram é um aplicativo web que abre dentro do chat. Um pagamento em mini app significa que o cliente escolhe um item no app e paga por ele sem sair do Telegram por muito tempo.
Status: o checkout de mini apps está no roteiro
Um checkout nativo da Qvard para mini apps do Telegram ainda não foi lançado, e este artigo não o descreve como disponível. O caminho abaixo usa a API em produção, a página hospedada e o webhook.
O que funciona hoje
O backend do mini app cria o pagamento com POST /api/v1/payment e o cabeçalho x-api-key, recebe um redirectUrl e abre a página hospedada para o cliente. Depois o webhook entrega o status final ao backend, que libera o item.
Mantenha a chave no backend
Um mini app roda no navegador do cliente, então a chave da API nunca deve estar no código do front-end. Somente o backend chama POST /api/v1/payment.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 149.99,
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}Libere o item pelo webhook
O mini app mostra o item como liberado somente depois que o webhook entregar o id e o status paid daquele pedido. Até lá o item continua bloqueado, mesmo que o cliente volte ao app.
Planeje para o checkout nativo de mini apps
Quando o checkout nativo for lançado, a janela de pagamento poderá abrir dentro do app. Até lá, mantenha a lógica do pedido e o webhook no backend, para que depois só o front-end mude.
FAQ
Um mini app do Telegram pode receber cripto hoje?
Sim. O backend do mini app cria o pagamento pela API, abre a página hospedada e libera o item quando o webhook confirma o status paid. O checkout nativo de mini apps está no roteiro.
O mini app pode chamar a API de pagamento diretamente do navegador?
Não. Guarde a chave da API no backend e chame o endpoint de pagamento somente de lá.
O cliente precisa sair do mini app?
Hoje a página hospedada abre para o pagamento, e o resultado volta ao mini app pelo seu backend e pelo webhook.
Como testar um pagamento em mini app?
Crie uma fatura de demonstração de um item de teste, pague na página hospedada e confira se o item é liberado após o webhook.
