Bepaid (ru)
Cómo conectar
Para conectar el sistema de pago bePaid necesitará el ID de la tienda, la clave secreta y la clave pública. Después de obtenerlas, pasamos a la configuración en MaviBot.
En MaviBot abrimos la sección "Pasarela de pago", seleccionamos bePaid. Es necesario introducir los datos obtenidos.
Tenga en cuenta que el último campo es un selector del host de la API según el país de uso: Bielorrusia o Rusia.
Cómo generar un enlace de pago
Para generar un enlace de pago, debe establecer el valor de la variable payment_sum (por ejemplo 150 o 100.55 (¡con punto!)); inmediatamente después aparecerá la variable bepaid_pay_url. Esta variable se puede mostrar en pantalla como enlace o colocarla en un botón con el texto "Pagar".
El enlace tiene el siguiente aspecto: https://checkout.bepaid.by/widget/hpp.html?token=a05eabd3f9368725efbc175614c7d469da08f198cc51916b07fb75e53f9a3e1a
Además, antes de establecer el valor de la variable payment_sum, se pueden definir las siguientes variables opcionales para configurar el pago.
Por defecto se establece el rublo bielorruso; si necesita otra moneda, debe establecer el valor de la variable currency
language
idioma de la página de pago
Por defecto - en.
Valores permitidos:
en - Inglés
es - Español
tr - Turco
de - Alemán
it - Italiano
ru - Ruso
zh - Chino
fr - Francés
da - Danés
sv - Sueco
no - Noruego
fi - Finlandés
pl - Polaco
ja - Japonés
uk - Ucraniano
be - Bielorruso
ka - Georgiano
ro - Rumano
payment_description
descripción del pago
link_expired
tiempo de vida del enlace de pago, en formato dd.mm.aaaa (por ejemplo 25.06.2025).
Por defecto, el pago debe realizarse en un plazo de 24 horas
También se puede en el campo "Asignación de variables al pasar" indicar: link_expired = current_date + 2 (el enlace será válido durante 2 días hasta las 00:00)
link_expired también se puede indicar una fecha con hora exacta, separada por un espacio, en formato dd.mm.aaaa hh:mm (por ejemplo: 25.06.2025 12:23). Por defecto, el pago debe realizarse en un plazo de 24 horas
También se pueden usar variables estándar, por ejemplo, establezcamos el tiempo de validez del enlace en 30 minutos:
time = current_time + 30
link_expired = "#{current_date} #{time}"
russian_host
indicador de registro de la tienda en el host ruso de bePaid. Especifique este parámetro con el valor 1 si su tienda está registrada en el sitio bepaid.tech
Si es necesario cambiar el host al bielorruso, especifique el parámetro con el valor ''
test_payments
la variable se necesita para pagos de prueba; si se necesita un pago de prueba, añádala con cualquier valor.
bepaid_attempts
indica el número de intentos para realizar un pago; por defecto se proporciona 1 intento.
customer_data
un arreglo que contiene first_name, last_name y email del pagador. Los datos son necesarios para enviar el recibo al correo del pagador y están disponibles para su edición en la página de pago.
El parámetro debe pasarse como una lista en formato JSON, compuesta por pares clave-valor
por ejemplo:
customer_data = ‘{“first_name”: “Vladimir”, “last_name”: “Popov”, “email”: “[email protected]” }’
bepaid_contract (condicionalmente obligatorio)
destino del pago por token.
Valores esperados: “recurring” (para pagos periódicos con una frecuencia definida) o “card_on_file” (para pagos no periódicos, por ejemplo, pago posterior por un servicio prestado)
Después de completar el pago, se añadirá al trato la variable bepaid_callback_data, que contiene los datos de respuesta del sistema de pago sobre la operación realizada. Del diccionario recibido se pueden extraer los datos necesarios mediante el método get.
Cómo probar los pagos
Para realizar un pago de prueba antes de especificar la variable payment_sum, debe definir la variable test_payments con cualquier valor.
¡No olvide eliminarla al iniciar el bot en modo de producción!
Tarjetas para pruebas:
4200000000000000 éxito
4005550000000019 fallido
Si algo no funciona, compare los datos con los del sitio oficial: https://docs.bepaid.by/ru/test-integration#test-card-number
Ejemplo de creación del enlace de pago
Crearemos un enlace de pago por un importe de 100 rublos bielorrusos (moneda predeterminada)
Tenga en cuenta que primero definimos las variables adicionales para la configuración y luego payment_sum. Las variables también se pueden definir antes en la cadena y no en un solo bloque; este es solo un ejemplo.
Luego, en el lugar necesario, mostramos la variable bepaid_pay_url, en la que se contiene el enlace
Gestión de suscripciones
La integración del sistema de pago ofrece la posibilidad de crear suscripciones para sus clientes.
Antes de comenzar a usar la funcionalidad de MaviBot, cree un plan de suscripción en el área privada de bePaid.
Si en el área privada no aparece el menú “Planes” y “Suscripciones”, póngase en contacto con su gestor.
Creación de una suscripción y obtención del enlace de pago
Utilice la función get_bepaid_subscription_url, pasando el parámetro plan_id, donde
plan_id
es el id del plan en el sistema bePaid.
Como resultado de la ejecución, la función creará una suscripción y devolverá un enlace para su pago.
Envíe el enlace al cliente y espere a que finalice el pago.
Tras un pago exitoso, la suscripción se activará, al trato se añadirán las variables bepaid_subscription_id y bepaid_subscription_status, y al bot llegará un callback (véase la sección “Cómo procesar el resultado”).
Obtención de información sobre la suscripción
Para obtener los datos de la suscripción actual del cliente, llame a la función get_bepaid_subscription_info, pasando el parámetro subscription_id (el valor se puede tomar de la variable bepaid_subscription_id).
Cancelación de la suscripción
Para cancelar la suscripción, utilice la función cancel_bepaid_subscription.
Esta función acepta un único parámetro subscription_id (el valor se puede tomar de la variable bepaid_subscription_id).
Al cancelarse correctamente, la variable bepaid_subscription_status tomará el valor “canceled”, y al bot llegará un callback (véase la sección “Cómo procesar el resultado”).
Estados de las suscripciones
trial
Suscripción activa o cancelada del período de prueba.
active
Suscripción activa, cuyo pago se realizó a tiempo.
failed
Suscripción fallida. bePaid no pudo procesar el siguiente pago.
error
Se produjo un error al intentar bePaid procesar el pago.
canceled
La suscripción está cancelada y ya no está vigente.
Pagos recurrentes
También puede organizar un sistema de suscripciones sin crear un plan en el área privada de bePaid.
Para ello necesitará el token de la tarjeta del cliente.
Para obtener el token de la tarjeta, el cliente debe realizar un pago inicial mediante el enlace generado a través de payment_sum.
Antes de establecer el valor de payment_sum, defina la variable bepaid_contract, en la que indique el destino de los futuros pagos por token: “recurring” para pagos periódicos con una frecuencia definida o “card_on_file” para pagos no periódicos (por ejemplo, pago posterior por un servicio prestado).
La opción “card_on_file” no es compatible con todos los adquirentes. Si desea usarla, póngase en contacto con su account manager.
Después de un pago exitoso, se añadirá al trato la variable bepaid_client_card_token, donde se guardará el token de la tarjeta del cliente. Este token permite debitar fondos de la tarjeta del cliente sin su participación.
Luego configure el embudo y establezca la fecha o la condición para el cargo automático y llame a la función del calculador make_bepaid_token_payment, pasándole los parámetros necesarios.
Orden de los parámetros:
amount -> currency -> description -> contract
Descripción de los parámetros:
amount (obligatorio)
importe del pago, el valor esperado es un número entero o decimal, por ejemplo 100 o 100.5;
currency (obligatorio)
moneda de pago en ISO-4217 formato, por ejemplo “USD”
description (obligatorio)
descripción del motivo del cargo, por ejemplo, “Pago de la suscripción semanal para participar en el club de intereses”;
contract (obligatorio)
destino del pago por token. Valores esperados: “recurring” o “card_on_file”.
¡El valor de contract обязательно debe coincidir con el valor indicado al crear el enlace para el pago inicial!
Si el pago se realizó correctamente, la función devolverá el mensaje “Cargo exitoso por token bePaid“, recibirá un callback de pago exitoso y la variable del trato bepaid_token_payment_completed tomará el valor “True”.
Si el pago no se realizó, la función devolverá un mensaje indicando el motivo del fallo, al bot llegará un callback con el sufijo “_fail”, y la variable del trato bepaid_token_payment_completed tomará el valor “False”.
El banco puede solicitar que el cliente complete el pago. En ese caso, la función devolverá un enlace con la solicitud de autenticación 3-D Secure.
Cómo procesar el resultado
En respuesta a las acciones del cliente, llegarán al bot callbacks compuestos por los 20 primeros caracteres de la clave secreta y un sufijo que depende del tipo y del resultado de la operación.
En el sistema, el callback aparece como un mensaje del usuario, sin embargo, el propio usuario no lo ve.
Para pagos
Como resultado de un pago que no esté relacionado con una suscripción, recibirá uno de los mensajes:
numeroClave_success - en caso de pago exitoso;
numeroClave_fail - en caso de pago fallido;
El estado del último pago también se puede seguir mediante las variables bepaid_payment_completed (para pagos con participación del cliente) y bepaid_token_payment_completed (para pagos sin aceptación por token de tarjeta)
Para suscripciones
Después de la activación exitosa de la suscripción, en el primer o en el pago repetido, llegará al bot el mensaje numeroClave_success.
Si la suscripción fue cancelada, recibirá numeroClave_canceled.
En caso de pago fallido de la suscripción, recibirá el mensaje numeroClave_fail.
Última actualización