Cómo Conectarse
Para conectar el sistema de pago bePaid, necesitarás un Store ID, una clave secreta y una clave pública. Una vez que recibas estas credenciales, dirígete a la configuración en Salebot.
Para obtener el Store ID, la clave secreta y la clave pública, comunícate con el soporte técnico de bePaid para obtener asistencia.
En MaviBot, abre la sección "Sistema de pago" y selecciona bePaid. Luego ingresa las credenciales que recibiste.
Ten en cuenta que el último campo es un interruptor que selecciona el alojamiento 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, debes establecer un valor para la variable payment_sum (por ejemplo: 150 o 100.55 — usa un punto como separador decimal).
Una vez que se establezca la variable payment_sum, la variable bepaid_pay_url aparecerá automáticamente. Puedes mostrar esta variable en la pantalla como un enlace o colocarla en un botón con el texto "Pagar".
El enlace de pago se verá así:
https://checkout.bepaid.by/widget/hpp.html?token=a05eabd3f9368725efbc175614c7d469da08f198cc51916b07fb75e53f9a3e1a
Antes de establecer la variable payment_sum, también puedes definir las siguientes variables opcionales para personalizar el pago.
Por defecto, la moneda está configurada como rublo bielorruso. Si necesitas usar una moneda diferente, establece un valor para la variable currency.
Después de que se complete el pago, se agregará la variable bepaid_callback_data para el cliente. Contiene la respuesta del sistema de pago para la transacción completada. Puedes extraer los datos necesarios de este diccionario usando el método get.
Cómo Probar los Pagos
Para realizar un pago de prueba, antes de establecer la variable payment_sum, establece la variable test_payments con cualquier valor.
¡Recuerda eliminarla cuando ejecutes el bot en modo en vivo!
Tarjetas de prueba:
- 4200000000000000 — éxito
- 4005550000000019 — fallo
Si algo no funciona, compara tus datos con la documentación oficial: https://docs.bepaid.by/ru/test-integration#test-card-number
Ejemplo de Generación de un Enlace de Pago
Vamos a crear un enlace de pago por 100 rublos bielorrusos (moneda predeterminada).
Nota: primero, establece las variables adicionales para la configuración, luego establece payment_sum. Las variables también se pueden establecer antes en el flujo de trabajo, no necesariamente en el mismo bloque — esto es solo un ejemplo.
Finalmente, muestra la variable bepaid_pay_url en la ubicación deseada; contiene el enlace de pago generado.
Gestión de Suscripciones
La integración del sistema de pago te permite crear suscripciones para tus clientes.
Antes de usar esta funcionalidad en Salebot, crea un plan de suscripción en tu cuenta de bePaid.
Si los menús "Planes" y "Suscripciones" no aparecen en tu cuenta, comunícate con tu gerente.
Creación de una Suscripción y Generación de un Enlace de Pago
Usa la función get_bepaid_subscription_url, pasando el parámetro plan_id, donde…
Como resultado, la función creará una suscripción y devolverá un enlace de pago.
Envía el enlace al cliente y espera a que se complete el pago.
Una vez que el pago sea exitoso, la suscripción se activará. El trato recibirá las variables bepaid_subscription_id y bepaid_subscription_status, y se enviará un callback al bot (consulta la sección "Cómo Manejar el Resultado").
Obtención de Información de la Suscripción
Para obtener los detalles actuales de la suscripción de un cliente, llama a la función get_bepaid_subscription_info y pasa el parámetro subscription_id (el valor se puede tomar de la variable bepaid_subscription_id).
Cancelación de una Suscripción
Para cancelar una suscripción, usa la función cancel_bepaid_subscription.
Esta función acepta un solo parámetro: subscription_id (el valor se puede tomar de la variable bepaid_subscription_id).
Tras una cancelación exitosa, la variable bepaid_subscription_status se establecerá en "canceled", y se enviará un callback al bot (consulta la sección "Cómo Manejar el Resultado").
Estados de la Suscripción
Pagos Recurrentes
También puedes configurar un sistema de suscripción sin crear un plan en tu cuenta de bePaid.
Para esto, necesitarás el token de tarjeta del cliente.
Para obtener el token de la tarjeta, el cliente debe realizar un pago inicial usando un enlace generado a través de payment_sum.
Antes de establecer el valor de payment_sum, establece la variable bepaid_contract para especificar el propósito de los pagos futuros por token:
- "recurring" – para pagos regulares con una frecuencia establecida
- "card_on_file" – para pagos únicos o irregulares, por ejemplo, pago posterior por un servicio
La opción "card_on_file" no es compatible con todos los adquirentes. Si deseas usarla, comunícate con tu gerente de cuenta.
Después de un pago exitoso, se agregará la variable bepaid_client_card_token al trato, que almacena el token de la tarjeta del cliente. Este token te permite cobrar la tarjeta del cliente sin su participación.
A continuación, configura tu embudo y especifica una fecha o condición para el cobro automático, luego llama a la función make_bepaid_token_payment, pasando los parámetros requeridos.
Orden de los parámetros:
amount → currency → description → contract
Descripciones de los Parámetros
¡El valor de contract debe coincidir exactamente con el valor especificado al crear el enlace de pago inicial!
Si el pago es exitoso, la función devolverá el mensaje "Cobro exitoso mediante token de bePaid", recibirás un callback por el pago exitoso y la variable del trato bepaid_token_payment_completed se establecerá en "True".
Si el pago falla, la función devolverá un mensaje indicando el motivo del fallo, se enviará un callback con el sufijo "_fail" al bot y la variable del trato bepaid_token_payment_completed se establecerá en "False".
El banco puede requerir que el cliente complete el pago. En este caso, la función devolverá un enlace solicitando al cliente que pase por la autenticación 3-D Secure.
Cómo Manejar el Resultado
En respuesta a las acciones del cliente, el bot recibirá callbacks que consisten en los primeros 20 caracteres de la clave secreta y un sufijo, que depende del tipo y resultado de la operación.
En el sistema, el callback aparece como un mensaje del usuario, pero el usuario no lo ve.
Para Pagos
Para pagos no relacionados con suscripciones, recibirás uno de los siguientes mensajes:
- keyNumber_success – para un pago exitoso
- keyNumber_fail – para un pago fallido
También puedes rastrear el estado del último pago usando las variables:
- bepaid_payment_completed – para pagos que involucran al cliente
- bepaid_token_payment_completed – para pagos automáticos basados en token de tarjeta
Para Suscripciones
Después de que una suscripción se active exitosamente, ya sea en el primer pago o en uno recurrente, el bot recibirá el mensaje keyNumber_success.
Si la suscripción se cancela, recibirás keyNumber_canceled.
En caso de un pago de suscripción fallido, se enviará el mensaje keyNumber_fail.