# Wallet pay

## Conectando o sistema de pagamento ### Conectando do lado do Telegram **Passo 1.** Faça login na sua conta de parceiro {% hint style="info" %} [Para fazer isso, siga o link](https://pay.wallet.tg/) {% endhint %} Na página que abrir, clique em "Log in via Telegram", depois insira seu número de telefone na janela pop-up "Appears oauth.telegram.org " e clique em "Apply". É necessário conectar o sistema de pagamento tanto pelo navegador quanto pelo aplicativo: * Você receberá uma mensagem do Telegram solicitando autorização - clique **"Apply".** * Você também precisa clicar em "Apply" na janela pop-up **"oauth.telegram.org " em um navegador da web.** {% hint style="success" %} É recomendável usar uma conta à qual a pessoa responsável pelas finanças tenha acesso. Para pessoas jurídicas – um representante autorizado. {% endhint %} **Passo 2.** Faça uma pequena pesquisa

Fig. 1. Preenchimento das informações sobre o comerciante

Se você estiver fazendo login pela primeira vez ou precisar de alguma informação adicional, o WalletPay oferece a possibilidade de responder 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á analisada em breve e você será notificado do resultado. Se aprovado, você verá a comissão cobrada pelo serviço e terá acesso à sua conta, onde poderá iniciar a integração. {% hint style="warning" %} Para pessoas jurídicas, o formulário só pode ser preenchido por uma pessoa de confiança: um diretor ou um funcionário com procuração. {% endhint %} **Passo 3.** *Crie a primeira "Loja".* Após concluir a "Pesquisa" com sucesso, será sugerido que você crie sua primeira loja. **Etapa 4.** *Criar uma "chave API"* Após o nome da primeira loja, será sugerido configurá-la: * Gere a chave API. * Copie sua chave API e comece a integração com a Mavibot. **Etapa 5**. *Crie um pedido e receba um link de pagamento* Se você quiser colocar um link em um botão, use **Botão Inline.** Observe que apenas o "customerTelegramUserId" especificado pode abrir a página de pagamento. **Etapa 6.** *Sacar fundos* Depois que o cliente confirmar o pagamento, os fundos serão creditados em seus ativos e ficarão retidos por padrão por 48 horas. Após esse período, você poderá sacar os fundos para o saldo da sua Wallet, que você usou para fazer login no serviço Paypal Wallet. **Etapa 7.** *Devolução de fundos* Atualmente, o saque de fundos está disponível a partir da sua conta Wallet, que você usa para fazer login no WalletPay. Mas em breve estará disponível em sua conta Merchant. ### 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 atenda às seguintes recomendações: 1. Nomeado de uma de duas formas: * :purse: Wallet Pay * :purse: Pagar via Wallet 2. Localizado acima dos outros botões (se houver). > Observação. :purse: — это смайлик (veja ). > > Veja o exemplo em \[[Demo Store Bot](https://t.me/PineAppleDemoWPStoreBot)]. ## Conectando à Mavibot Faça login no projeto e clique no **“Connect”** botão do Wallet Pay na seção “Sistemas de pagamento”.

Fig. 2. A seção "Acquiring" para conectar o serviço à Mavibot

Na janela que abrir, insira a chave API gerada para sua loja WalletPay.

Fig. 3. Um formulário com campo de entrada da chave API

* [x] Pronto! Agora os clientes podem pagar suas 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 **“wallet\_pay\_generate\_payment\_url”** função 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”. | | **código\_da\_moeda** | 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. |

Fig. 4. Exemplo de transmissão de parâmetros

Quando o bloco é acionado em um chat com um bot, o cliente receberá um link de pagamento, e a **wallet\_pay\_payment\_completed** variável do cliente será criada com o valor **False.** {% hint style="warning" %} Este link só pode ser aberto em um chat com um bot conectado a uma conta de cobrança do WalletPay. {% endhint %} ### Verificação do pagamento Após o pagamento bem-sucedido, a **wallet\_pay\_payment\_completed** variável do cliente será definida como **True,** e o vendedor receberá um callback na forma de **4690FE98\_success**, que consiste em: * “4690FE98” - estes são os primeiros 8 caracteres da chave 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): - inserido nas configurações do sistema de pagamento Um callback pode ser incorporado à condição do bloco para enviar uma mensagem ao cliente sobre um pagamento bem-sucedido (ou um erro de pagamento):

Fig. 5. Um exemplo da reação a um callback no bloco "Starting condition"

Fig. 6.Um exemplo de resposta a um callback no bloco "Non state condition"

{% hint style="info" %} Se você não quiser tirar o cliente do fluxo principal do chatbot, use o bloco "Non state condition". Você não pode ir para esse bloco, então o cliente não será tirado do funil principal após o pagamento e receberá uma notificação de pagamento bem-sucedido.\ омление об успешной оплате. E se você precisar continuar o funil com uma reação a um pagamento bem-sucedido, então use o bloco "Start condition"; assim, o cliente passará do bloco de pagamento para o bloco "Start condition", a partir do qual você pode continuar o funil. {% endhint %} {% hint style="info" %} Mais informações sobre blocos condicionais são fornecidas no artigo de mesmo nome. ссылка[blocks with condition told](broken://pages/9e3be42889ce2d0dcab0abacde702001b37f7a3f) {% endhint %} ### Links úteis \[[Suporte Comercial do Wallet Pay](https://t.me/WalletPay_supportbot)] \[[Demo Store Bot](https://t.me/PineAppleDemoWPStoreBot)] \[[Comunidade de Comerciantes](https://t.me/+6TReWBEyZxI5Njli)] --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mavibot.ai/doc/pt/pagamento/wallet-pay.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.