Conectando o sistema de pagamento
Conexão no lado do Telegram
Passo 1. Faça login na sua conta de parceiro
Na página que abrir, clique em "Log in via Telegram", em seguida, insira seu número de telefone na janela pop-up "Aparece oauth.telegram.org" e clique em "Apply".
É necessário conectar o sistema de pagamento tanto pelo navegador web quanto pelo aplicativo:
- Você receberá uma mensagem do Telegram solicitando autorização - clique em "Apply".
- Você também precisa clicar em "Apply" na janela pop-up "oauth.telegram.org" em um navegador web.
Recomenda-se usar uma conta à qual a pessoa responsável pelas finanças tenha acesso. Para pessoas jurídicas – um representante autorizado.
Passo 2. Responda a uma pequena pesquisa
Se você está fazendo login pela primeira vez ou precisa de algumas informações adicionais, o WalletPay oferece que você responda a algumas perguntas para obter informações mais detalhadas. Há duas etapas:
1. Questionário
2. Verificações KYB (Know Your Business) ou KYC (Know Your Customer)
Após a conclusão, sua solicitação será revisada em breve e você será notificado dos resultados. Se for bem-sucedido, você verá a comissão cobrada pelo serviço e terá acesso à sua conta, onde poderá iniciar a integração.
Para pessoas jurídicas, o formulário só pode ser preenchido por uma pessoa de confiança: um diretor ou um funcionário por procuração.
Passo 3. Crie a primeira "Loja".
Após concluir a "Pesquisa" com sucesso, será sugerido que você crie sua primeira loja.
Passo 4. Crie uma "Chave de API"
Após o nome da primeira loja, será sugerido que você a configure:
- Gere a chave de API.
- Copie sua chave de API e comece a integrar com o Mavibot.
Passo 5. Crie um pedido e receba um link de pagamento
Se você quiser colocar um link em um botão, use Inline Button.
Observe que apenas o "customerTelegramUserId" especificado pode abrir a página de pagamento.
Passo 6. Retire os fundos
Após o cliente confirmar o pagamento, os fundos são creditados em seus ativos e são retidos por 48 horas por padrão. Após esse tempo, você poderá retirar os fundos para o saldo da sua Wallet, que você usou para fazer login no serviço Paypal Wallet.
Passo 7. Devolução de fundos
Atualmente, a retirada de fundos está disponível a partir da sua conta Wallet, que você usa para fazer login no WalletPay. Mas estará disponível em sua conta Merchant em breve.
Como é o botão de pagamento?
Ao integrar seu Bot do Telegram com a "Wallet Pay API", certifique-se de que o botão de pagamento esteja em conformidade com as seguintes recomendações:
- Nomeado de uma das duas maneiras:
- 👛 Wallet Pay
- 👛 Pagar via Wallet
- Localizado acima dos outros botões (se você tiver algum).
Nota. 👛 — é um emoji (veja https://emojipedia.org/purse/).
Veja o exemplo em [Demo Store Bot].
Conectando ao Mavibot
Faça login no projeto e clique no botão “Connect” para Wallet Pay na seção “Payment systems”.
Na janela que abrir, insira a chave de API gerada para sua loja WalletPay.
- Pronto! Agora os clientes podem pagar por compras em sua loja em criptomoedas (USDT, Toncoin e Bitcoin) usando o serviço Paypal Wallet.
Como gerar um link de pagamento
Crie um bloco construtor de funil e chame a função “wallet_pay_generate_payment_url” na calculadora, passando os parâmetros necessários para ela:
| Parâmetros | Descrição dos parâmetros |
|---|---|
| amount | o valor do pagamento em criptomoeda ou outra moeda fiduciária disponível para conversão em “TON”. |
| сurrency_code | A moeda de pagamento padrão é “RUB". Lista de moedas disponíveis: "TON" "BTC" "USDT" "EUR" "USD" "RUB" |
| description | uma breve descrição do pedido de 5 a 100 caracteres. |
| timeout_seconds | O período de validade do link em segundos, o padrão é 3600 segundos. |
Quando o bloco é acionado em um chat com um bot, o cliente receberá um link de pagamento, e a variável de cliente wallet_pay_payment_completed será criada com o valor False.
Este link só pode ser aberto em um chat com um bot conectado a uma conta de faturamento do WalletPay.
Verificação de pagamento
Após o pagamento bem-sucedido, a variável wallet_pay_payment_completed do cliente será definida como True, e o vendedor receberá um callback no formato 4690FE98_success, que consiste em:
- “4690FE98” - estes são os primeiros 8 caracteres da chave de API do Wallet Pay.
- palavras sobre sucesso
! se houver um erro de pagamento, você receberá um callback com o sufixo “_fail”.
Endereço para notificações (callbacks): https://chatter.salebot.pro/wallet_pay/payment_callback - inserido nas configurações do sistema de pagamento
Um callback pode ser incorporado na condição do bloco para enviar uma mensagem ao cliente sobre um pagamento bem-sucedido (ou um erro de pagamento):
Se você não quiser tirar o cliente do esquema principal do chatbot, use o bloco "Non state condition". Você não pode ir para este bloco, então o cliente não será retirado do funil principal após o pagamento e receberá uma notificação de pagamento bem-sucedido.
omleto sobre pagamento bem-sucedido.E se você precisar continuar o funil com uma reação a um pagamento bem-sucedido, use o bloco "Start condition", então o cliente se moverá do bloco de pagamento para o bloco "Start condition", a partir do qual você pode continuar o funil.
Mais informações sobre blocos condicionais são fornecidas no artigo de mesmo nome. linkblocos com condição explicaram