> For the complete documentation index, see [llms.txt](https://docs.mavibot.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mavibot.ai/doc/pt/integrations/payment/fondy.md). # Fondy * [Como conectar ](#how-to-connect) * [Como Criar um Link](#how-to-create-a-link) * [Como processar o resultado ](#how-to-process-the-result) * [Como Fazer Pagamentos de Teste](#how-to-make-test-payments) ## Como conectar Para conectar o sistema de pagamento Fondy, você precisará de um ID de comerciante e uma chave secreta. Após recebê-los, vamos para as configurações no Salebot No Salebot, abrimos a seção de sistemas de pagamento, selecionamos Fondy. Você precisa inserir os dados recebidos. ![](/files/4da1e0d42c620b33bb1622b9cf2e6bc050e87afe) ![](/files/4bf98388c8a2d2941776a4e8027beb9f4be8d6ca) Para gerar um link para um pagamento, você precisa definir o valor da variável payment\_sum (como 150 ou 100.55 (usando ponto!)), imediatamente depois disso a variável fondy\_pay\_url aparece. Essa variável pode ser exibida com um link ou colocada no botão com o texto "Pagar". O link tem o formato: Além disso, antes de definir o valor payment\_sum, você pode especificar as seguintes variáveis opcionais para configurar o pagamento. {% hint style="warning" %} A configuração padrão é UAH; se você precisar de outra moeda, deve definir o valor da variável currency {% endhint %} **currency** - Moeda do pedido. **Valores válidos:** UAH - hryvnia ucraniana RUB - rublo russo USD - USD EUR - euro GBP - libra esterlina obrigatória CZK - coroa tcheca **payment\_description** - descrição do pedido **session\_timeout** - duração do pedido em segundos. padrão (36000 segundos = 10 horas). **language** - idioma da página de pagamento: ru - russo uk - ucraniano en - inglês lv - letão fr - francês cs - tcheco ro - romeno it - italiano sk - eslovaco pl - polonês es - espanhol hu - húngaro de - alemão ## Como Criar um Link Crie um link para o pagamento de 122hrn (hryvnia padrão) ![](/files/5d9e0f124aa87e7e375cb77638cf7e3001d3ad0f) {% hint style="info" %} Observe: * Primeiro especifique os parâmetros **payment\_description** opcionais, etc. * E por último, atribua o valor da **payment\_sum** variable {% endhint %} Observação: primeiro definimos variáveis adicionais para as configurações e depois **payment\_sum**. Você pode definir variáveis antes em uma cadeia, não em um único bloco, este é um exemplo. Em seguida, no lugar certo, imprima a **fondy\_pay\_url** variável, que contém o link. ![](/files/dc8898406aff03e7db4ada94c22949dfd2c599fb) ## Como processar o resultado Após o pagamento bem-sucedido, chegarão no bot kolbeks, pelos quais você pode entender que houve um pagamento bem-sucedido. Esses kolbeks no sistema você vê como mensagens do usuário, então eles não podem ser enviados pelo usuário; eles consistem nos primeiros 5 caracteres da chave secreta e na conta de sucesso, por exemplo: h4fd56\_success {% hint style="info" %} Se a senha tiver menos de 5 caracteres, então a senha será usada por completo; por exemplo, para pagamentos de teste a senha é test, então o callback virá test\_success {% endhint %} {% hint style="success" %} Esses callbacks NÃO SÃO VISTOS pelo usuário, eles são exibidos apenas para o operador {% endhint %} {% hint style="warning" %} O tipo de comparação deve ser "Correspondência exata" {% endhint %} Além disso, após o pagamento bem-sucedido, a variável fondy\_payment\_completed é definida como True. Por exemplo, você pode criar um bloco de processamento de pagamento bem-sucedido com uma condição e exibir a mensagem correspondente ao usuário: ![](/files/699e0262c571f0529cb10d16a96d73d51a2d254c) Após a conclusão do pagamento, a variável fondy\_callback\_data será adicionada ao cliente, contendo os dados de resposta do sistema de pagamento para a transação concluída. Você pode extrair os dados necessários do dicionário usando o método get. {% hint style="warning" %} Para fazer um pagamento повторado, você deve redefinir payment\_sum, o link gerado anteriormente e, depois de redefinir a variável payment\_sum, obter um novo link. Você pode especificar um valor anterior. {% endhint %} ## Como Fazer Pagamentos de Teste Dados de teste no momento da publicação da documentação: **ID do comerciante**: 1396424 **Senha**: teste **Números de cartões de teste** 44445566661111 - Sucesso 4444111166665555 - Recusa Período de validade e CVV2: qualquer Se algo não funcionar, compare os dados com os dados no site oficial: --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://docs.mavibot.ai/doc/pt/integrations/payment/fondy.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.