Como conectar um sistema de pagamento
O sistema de pagamento está integrado ao Telegram. Para aceitar pagamentos dentro do mensageiro, você precisa:
- Conectar um sistema de pagamento ao seu bot usando o BotFather.
- Ir para as configurações do bot desejado e selecionar "Pagamentos" no menu.
Siga as instruções para conectar um sistema de pagamento disponível e copie o token fornecido.
Como faturar um cliente
Para enviar uma fatura no Telegram, use o método e especifique os parâmetros necessários.
tg_send_invoice(provider_token, platform_id, title, description, currency, prices, photo_url, payload, protect_content, disable_notification, need_name, need_phone_number, need_email, reply_to_message_id, reply_markup, message_thread_id, provider_data)
IMPORTANTE! Todos os parâmetros devem ser passados na ordem especificada na função. Se precisar especificar um parâmetro específico e omitir outros, deixe valores vazios ou valores conforme especificado na documentação para os parâmetros que você não precisa.
Exemplo:
Se algum dos parâmetros need_name, need_phone_number ou need_email estiver ativado, o usuário será solicitado a fornecer essa informação antes de concluir o pagamento. Após o pagamento bem-sucedido, os dados são salvos nas variáveis de cliente correspondentes.
Exemplo:
Resultado: os dados são solicitados antes do pagamento.
Callback de pagamento
Se um pagamento for bem-sucedido, um callback com o seguinte conteúdo será enviado para o chat do usuário:
tg_payment 1372995196 120.75 USD 2ff747b9-000f-5000-b000-16d7e3517aa', onde
- course_pay - payload - o payload da solicitação original de criação da fatura;
- 1372995196 - o ID do chat onde a fatura foi originalmente enviada;
- 120.75 - o valor total do pagamento;
- USD - a moeda;
- 2ff747b9-000f-5000-b000-16d7e3517aa9 - o ID do pagamento no sistema do comerciante.
Além disso, se o nome, número de telefone e/ou email do usuário foram solicitados, as variáveis correspondentes serão atribuídas ao cliente:
tg_payment_name, tg_payment_phone e tg_payment_email
Um callback de sucesso de pagamento será enviado para as mensagens diretas do usuário com o bot.
O usuário deve ter um chat existente com o bot (ou seja, deve ter iniciado ou se inscrito no bot) antes do pagamento ser feito. Caso contrário, o bot não pode enviar a mensagem direta.
Uma vez recebido o webhook de pagamento, o pagamento será automaticamente confirmado através do método answerPreCheckoutQuery. https://core.telegram.org/bots/api#answerprecheckoutquery
Mensagem fixada com um botão de pagamento
Você precisa usar o recurso de fixar mensagem após conectar o sistema de pagamento.
tg_pin_chat_message(platform_id, message_id, disable_notification)
Exemplo:
Passo 1:
prices = [["curso", 100], ["IVA", 20.75]]
result=tg_send_invoice('381764678:TEST:129736', platform_id, 'Curso sobre cursos', 'Criar cursos é fácil', 'USD', prices, 'https://salebot.pro/promo.png', 'course_pay','0', '0', '1', '1', '1', '', '{"inline_keyboard": [[{"text":"Pagar", "pay":"True"}]]}')
Passo 2:
Como resultado do primeiro passo, você receberá uma resposta da qual precisa extrair o valor message_id usando a função get().
res=get(result,'result')
m_id=get(res,'message_id')
Em seguida, fixe a mensagem: tg_pin_chat_message(#{platform_id}, #{m_id}, 1)
Exemplo: conjunto mínimo de parâmetros
prices = [["super curso", 100]]
result= tg_send_invoice('381764678:TEST:129736', platform_id, 'Curso sobre cursos', 'Criar cursos é super fácil', 'USD', prices)
Exemplo: teclado
prices = [["curso", 100], ["IVA", 20.75]]
tg_send_invoice('381764678:TEST:129736', platform_id, 'Curso sobre cursos', 'Criar cursos é fácil', 'USD', prices, 'https://mavibot.ai/promo.png', 'course_pay','0', '0', '1', '1', '1', '', '{"inline_keyboard": [[{"text":"Pagar", "pay":"True"}], [{"text":"Outro botão", "callback_data": "Outro botão"}]]}')
