Como conectar
Para conectar o sistema de pagamento Fondy, você precisará de um ID de comerciante e uma chave secreta. Após recebê-los, vá para as configurações no Mavibot.
No Mavibot, abra a seção de sistemas de pagamento e selecione Fondy. Você precisa inserir os dados recebidos.
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 após isso, a variável fondy_pay_url aparece. Esta variável pode ser exibida com um link ou colocada em um botão com o texto "Pagar".
O link tem a forma:
Além disso, antes de definir o valor de payment_sum, você pode especificar as seguintes variáveis opcionais para configurar o pagamento.
A configuração padrão é UAH, se você precisar de outra moeda, defina o valor da variável currency
currency - Moeda do pedido.
Valores válidos:
UAH - Hryvnia ucraniana
RUB - Rublo russo
USD - Dólar americano
EUR - Euro
GBP - Libra esterlina
CZK - Coroa tcheca
payment_description - Descrição do pedido
session_timeout - Tempo de vida 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)
Observe:
- Primeiro especifique os parâmetros opcionais payment_description, etc.
- E por último, atribua o valor da variável payment_sum
Observe, primeiro definimos variáveis adicionais para as configurações, depois payment_sum. Você pode definir variáveis anteriormente em uma cadeia, não em um único bloco, isso é um exemplo.
Em seguida, no local apropriado, imprima a variável fondy_pay_url, que contém o link.
Como processar o resultado
Após o pagamento bem-sucedido, o bot receberá callbacks, pelos quais você pode entender que houve um pagamento bem-sucedido. Esses callbacks no sistema são vistos como mensagens do usuário, para que não possam ser enviados pelo usuário, eles consistem nos primeiros 5 caracteres da chave secreta e na conta de sucesso, por exemplo: h4fd56_success
Se a senha tiver menos de 5 caracteres, a senha será usada completamente, por exemplo, para pagamentos de teste a senha é test, então o callback virá como test_success
Esses callbacks NÃO SÃO VISÍVEIS para o usuário, eles são exibidos apenas para o operador
O tipo de comparação deve ser "Correspondência exata"
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 imprimir a mensagem correspondente para o usuário:
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.
Para fazer um pagamento repetido, você deve redefinir o payment_sum, o link gerado anteriormente e, após redefinir a variável payment_sum, obter um novo link. Você pode especificar um valor anterior.
Como fazer pagamentos de teste
Dados de teste no momento da publicação da documentação:
ID do comerciante: 1396424
Senha: test
Números de cartão 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: https://docs.fondy.eu/ru/docs/page/2/2