Bepaid
Cómo conectar
Para conectar el bePaid sistema de pago, necesitará un ID de tienda, clave secreta, y clave pública. Una vez que reciba estas credenciales, vaya a la configuración en Salebot.
Para obtener la ID de tienda, clave secreta, y clave pública, póngase en contacto con baPaid el soporte técnico para obtener ayuda.
En MaviBot, abra la "Sistema de pago" sección y seleccione bePaid. Luego introduzca las credenciales que recibió.
Tenga 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, debe asignar un valor a la payment_sum variable (por ejemplo: 150 o 100.55 — use un punto como separador decimal).
Una vez que se configure la payment_sum variable, la bepaid_pay_url variable aparecerá automáticamente. Puede mostrar esta variable en 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 configurar la payment_sum variable, también puede definir las siguientes variables opcionales para personalizar el pago.
De forma predeterminada, la moneda se establece en rublo bielorruso. Si necesita usar una moneda diferente, establezca un valor para la currency variable.
currency
Moneda de pago en formato ISO 4217
Por ejemplo: USD
language
Idioma de la página de pago Predeterminado: 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
Vencimiento del enlace de pago Establezca la fecha de vencimiento en el formato dd.mm.aaaa (por ejemplo: 25.06.2025). De forma predeterminada, el pago debe completarse en un plazo de 24 horas.
También puede usar el campo "Asignar variables en la redirección" para establecer:
link_expired = current_date + 2— el enlace será válido durante 2 días hasta las 00:00.También puede especificar una fecha y hora exactas de vencimiento en el formato dd.mm.aaaa hh:mm (por ejemplo: 25.06.2025 12:23). De forma predeterminada, el pago debe completarse en un plazo de 24 horas.
También se pueden usar variables estándar. Por ejemplo, para establecer la validez del enlace en 30 minutos: time = current_time + 30 link_expired = "#{current_date} #{time}"
russian_host
Indicador de tienda registrada en el host ruso de bePaid Establezca este parámetro en 1 si su tienda está registrada en bepaid.tech.
Si necesita cambiar el host a Bielorrusia, establezca este parámetro en "" (valor vacío).
test_payments
Esta variable se usa para pagos de prueba. Para realizar un pago de prueba, añádala con cualquier valor.
bepaid_attempts
Especifica el número de intentos de pago. De forma predeterminada, 1 intento está permitido.
сustomer_data
Una matriz que contiene el nombre, apellido, y correo electrónicodel pagador. Estos datos son necesarios para enviar el recibo al correo electrónico del pagador y pueden editarse en la página de pago.
El parámetro debe pasarse como una lista de pares clave-valor en formato JSON. Por ejemplo: customer_data = ‘{“first_name”: “Sam”, “last_name”: “Smith”, “email”: “[email protected]” }’
bepaid_contract (condicionalmente obligatorio)
Propósito del pago mediante token
Valores esperados:
“recurring” – para pagos regulares con una frecuencia establecida
“card_on_file” – para pagos únicos o irregulares, por ejemplo, pago posterior por un servicio
Después de completar el pago, la bepaid_callback_data variable se añadirá para el cliente. Contiene la respuesta del sistema de pago para la transacción completada. Puede extraer los datos necesarios de este diccionario usando el método get .
Cómo probar pagos
Para realizar un pago de prueba, antes de configurar la payment_sum variable, establezca la test_payments variable con cualquier valor. Recuerde eliminarla cuando ejecute el bot en modo en vivo!
Tarjetas de prueba:
4200000000000000 — éxito
4005550000000019 — fallido
Si algo no funciona, compare sus 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 para 100 rublos bielorrusos (moneda predeterminada).
Nota: primero, configure las variables adicionales para la configuración y luego establezca payment_sum. Las variables también pueden configurarse antes en el flujo de trabajo, no necesariamente en el mismo bloque: esto es solo un ejemplo.
Finalmente, muestre la bepaid_pay_url variable en la ubicación deseada; contiene el enlace de pago generado.
Gestión de suscripciones
La integración del sistema de pago le permite crear suscripciones para sus clientes.
Antes de usar esta funcionalidad en Salebot, cree un plan de suscripción en su bePaid cuenta.
Si el “Planes” y “Suscripciones” los menús no aparecen en su cuenta, póngase en contacto con su gestor.
Creación de una suscripción y generación de un enlace de pago
Use la get_bepaid_subscription_url función, pasando el parámetro plan_id donde…
plan_id
plan_id es el ID del plan en el bePaid sistema.
Como resultado, la función creará una suscripción y devolverá un enlace de pago.
Envíe el enlace al cliente y espere 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á una devolución de llamada al bot (consulte 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, llame a la get_bepaid_subscription_info función y pase el parámetro subscription_id (el valor puede tomarse de la bepaid_subscription_id variable).
Cancelación de una suscripción
Para cancelar una suscripción, use la cancel_bepaid_subscription función.
Esta función acepta un único parámetro: subscription_id (el valor puede tomarse de la bepaid_subscription_id variable).
Tras una cancelación exitosa, la bepaid_subscription_status variable se establecerá en “canceled”, y se enviará una devolución de llamada al bot (consulte la sección “Cómo manejar el resultado” ).
Estados de suscripción
trial
Activa o cancelada período de prueba suscripción.
active
Suscripción activa con pago realizado a tiempo.
failed
Suscripción fallida. bePaid no pudo procesar el siguiente pago.
error
Se produjo un error mientras bePaid intentaba procesar el pago.
canceled
La suscripción ha sido canceled y ya no está activa.
Pagos recurrentes
También puede configurar un sistema de suscripción sin crear un plan en su bePaid cuenta.
Para ello, necesitará el token de la tarjeta.
del cliente. Para obtener el token de la tarjeta, el cliente debe realizar un pago inicial usando un enlace generado mediante payment_sum.
Antes de configurar la payment_sum valor, establezca la bepaid_contract variable para especificar el propósito de futuros pagos mediante token:
“recurring” – para pagos regulares con una frecuencia establecida
“card_on_file” – para pagos únicos o irregulares, por ejemplo, pago posterior por un servicio
El “card_on_file” la opción no es compatible con todos los adquirentes. Si desea usarla, póngase en contacto con su gestor de cuenta.
Después de un pago exitoso, la bepaid_client_card_token variable se añadirá al trato, almacenando el token de la tarjeta del cliente. Este token le permite cobrar la tarjeta del cliente sin su participación.
A continuación, configure su embudo y especifique una fecha o condición para el cargo automático, luego llame a la make_bepaid_token_payment función, pasando los parámetros requeridos.
Orden de los parámetros: amount → currency → description → contract
Descripciones de parámetros
amount (obligatorio)
Importe del pago – el valor esperado es un entero o número decimal, por ejemplo: 100 o 100.5.
currency (obligatorio)
Moneda del pago en ISO 4217 formato, por ejemplo: “USD”.
description (obligatorio)
Descripción del cargo, por ejemplo: “Pago semanal de suscripción para participar en el club de aficionados”.
contract (obligatorio)
Propósito del pago mediante token. Valores esperados: “recurring” o “card_on_file”.
El 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á una devolución de llamada 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 del pago, se enviará al bot una devolución de llamada con el sufijo “_fail” 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 que solicita al cliente que realice la autenticación 3-D Secure.
Cómo manejar el resultado
En respuesta a las acciones del cliente, el bot recibirá devoluciones de llamada compuestas por los primeros 20 caracteres de la clave secreta y un sufijo, que depende del tipo y del resultado de la operación.
En el sistema, la devolución de llamada aparece como un mensaje del usuario, pero el usuario no la ve.
Para pagos
Para pagos no relacionados con suscripciones, recibirá uno de los siguientes mensajes:
keyNumber_success – para un pago exitoso
keyNumber_fail – para un pago fallido
También puede seguir 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 mediante token de tarjeta
Para suscripciones
Después de que una suscripción se active correctamente, ya sea en el primer pago o en uno recurrente, el bot recibirá el mensaje keyNumber_success.
Si la suscripción se cancela, recibirá keyNumber_canceled.
En caso de un pago de suscripción fallido, se enviará el mensaje keyNumber_fail .
Última actualización