guide

Mini App do Telegram

Integre os pagamentos QuantaPay em Telegram Mini Apps para um comércio in-chat perfeito.

Atualizado: 09/03/2026

Integre os pagamentos QuantaPay aos Mini Apps do Telegram para um comércio contínuo no chat.

Visão geral

Os Mini Apps do Telegram (anteriormente Web Apps) são aplicativos baseados na web que são executados dentro do Telegram Messenger. Ao integrar o QuantaPay, você pode aceitar pagamentos em criptomoedas diretamente no Telegram.

Abordagem de Integração

Use a API QuantaPay Checkout Session para criar pagamentos a partir do seu Mini App:

  1. Seu backend chamacreate-checkout-sessionpara criar um pagamento.
  2. Abra opayment_urlno WebView do Telegram ou redirecione o usuário.
  3. O cliente paga na página de pagamento QuantaPay.
  4. Seu backend recebe um webhook quando o pagamento é confirmado.

Fluxo de Exemplo

// In your Mini App frontend
async function handlePayment(amount, currency) {
  // Call your backend to create a checkout session
  const response = await fetch('/api/create-payment', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ amount, currency })
  });

  const { payment_url } = await response.json();

  // Open payment URL in Telegram
  window.Telegram.WebApp.openLink(payment_url);
}
// Your backend endpoint
$result = file_get_contents('https://cloud.quantapay.app/api.php', false,
  stream_context_create([
    'http' => [
      'method' => 'POST',
      'header' => 'Content-Type: application/x-www-form-urlencoded',
      'content' => http_build_query([
        'function' => 'create-checkout-session',
        'api-key' => 'YOUR_API_KEY',
        'price' => $_POST['amount'],
        'currency' => $_POST['currency'],
        'redirect' => 'https://t.me/YourBot/app', // Return to Mini App
      ])
    ]
  ])
);

Estudo de Caso: BuyCard

BuyCard (tg.buycard.vip) é um Mini App do Telegram que usa QuantaPay para pagamentos em criptomoedas. Ele demonstra:

  • Compras de cartão-presentepagas com criptomoedas via QuantaPay Checkout Sessions
  • Integração da carteira TON Connectpara pagamentos TON nativos
  • Pagamentos com Telegram Starscomo um método de pagamento alternativo
  • Suporte a vários idiomas(11 idiomas)

Integração TON Connect

TON Connect é uma integração personalizada para aceitar pagamentos TON (Toncoin) diretamente através da carteira TON. Este é umrecurso de desenvolvimento personalizado— entre em contato conosco se estiver interessado em uma integração semelhante para o seu Mini App.

Desenvolvimento Personalizado

Precisa de uma integração de pagamento de Mini App do Telegram personalizada? Oferecemos serviços de desenvolvimento personalizado, incluindo:

  • Integração da carteira TON Connect
  • Fluxos de pagamento personalizados
  • Suporte a várias moedas
  • Sistemas de gerenciamento de pedidos

Entre em contato conosco em[email protected]ou via Telegram para consultas sobre desenvolvimento personalizado.