Cómo conectar
Para conectar el sistema de pago Fondy necesitarás un ID de comerciante y una clave secreta. Después de recibirlos, ve a la configuración en Mavibot.
En Mavibot, abre la sección de sistemas de pago y selecciona Fondy. Debes ingresar los datos recibidos.
Para generar un enlace de pago, debes establecer el valor de la variable payment_sum (por ejemplo, 150 o 100.55 (¡con un punto!)), inmediatamente después aparecerá la variable fondy_pay_url. Esta variable se puede mostrar con un enlace o colocarse en un botón con el texto "Pagar".
El enlace tiene la forma:
Además, antes de establecer el valor de payment_sum, puedes especificar las siguientes variables opcionales para configurar el pago.
La configuración predeterminada es UAH; si necesitas otra moneda, debes establecer el valor de la variable currency.
currency - Moneda del pedido.
Valores válidos:
UAH - Grivna ucraniana
RUB - Rublo ruso
USD - Dólar estadounidense
EUR - Euro
GBP - Libra esterlina
CZK - Corona checa
payment_description - Descripción del pedido
session_timeout - Duración de vida del pedido en segundos.
Valor predeterminado (36000 segundos = 10 horas).
language - Idioma de la página de pago:
ru - Ruso
uk - Ucraniano
en - Inglés
lv - Letón
fr - Francés
cs - Checo
ro - Rumano
it - Italiano
sk - Eslovaco
pl - Polaco
es - Español
hu - Húngaro
de - Alemán
Cómo crear un enlace
Crear un enlace para el pago de 122 grivnas (grivna predeterminada)
Ten en cuenta:
- Primero especifica los parámetros opcionales como payment_description, etc.
- Y por último, asigna el valor de la variable payment_sum.
Nota: primero configuramos las variables adicionales para los ajustes, luego payment_sum. Puedes definir las variables antes en una cadena, no necesariamente en un solo bloque; esto es solo un ejemplo.
A continuación, en el lugar adecuado, imprime la variable fondy_pay_url, que contiene el enlace.
Cómo procesar el resultado
Después de un pago exitoso, llegarán al bot callbacks que te permitirán saber que se realizó un pago exitoso. Estos callbacks en el sistema se ven como mensajes del usuario, por lo que no pueden ser enviados por el usuario; consisten en los primeros 5 caracteres de la clave secreta y la palabra "success", por ejemplo: h4fd56_success
Si la contraseña tiene menos de 5 caracteres, se usará la contraseña completa; por ejemplo, para pagos de prueba la contraseña es "test", entonces el callback será test_success.
Estos callbacks NO SON VISIBLES para el usuario, solo se muestran al operador.
El tipo de comparación debe ser "Coincidencia exacta".
Además, después de un pago exitoso, la variable fondy_payment_completed se establece en True.
Por ejemplo, puedes crear un bloque de procesamiento de pago exitoso con una condición e imprimir el mensaje correspondiente al usuario:
Después de que se complete el pago, se agregará al cliente la variable fondy_callback_data, que contiene los datos de respuesta del sistema de pago para la transacción completada. Puedes extraer los datos necesarios del diccionario usando el método get.
Para realizar un pago repetido, debes restablecer payment_sum, el enlace generado anteriormente, y después de restablecer la variable payment_sum para obtener un nuevo enlace. Puedes especificar un valor anterior.
Cómo hacer pagos de prueba
Datos de prueba en el momento de la publicación de la documentación:
ID de comerciante: 1396424
Contraseña: test
Números de tarjeta de prueba
44445566661111 - Exitosa
4444111166665555 - Rechazo
Período de validez y CVV2: cualquiera
Si algo no funciona, compara los datos con los del sitio oficial: https://docs.fondy.eu/ru/docs/page/2/2