# 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**. {% hint style="info" %} 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. {% endhint %} 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í:\ Antes de configurar la **payment\_sum** variable, también puede definir las siguientes variables opcionales para personalizar el pago. {% hint style="info" %} De forma predeterminada, la moneda se establece en **rublo bielorruso**. Si necesita usar una moneda diferente, establezca un valor para la **currency** variable. {% endhint %}

Parámetros de función	Descripción	Más información
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”: “sam_smith@mavibot.ai” }’
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: ## **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. {% hint style="warning" %} Si el **“Planes”** y **“Suscripciones”** los menús no aparecen en su cuenta, póngase en contacto con su gestor. {% endhint %} **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 {% hint style="warning" %} 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. {% endhint %} 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”.

{% hint style="warning" %} El **contract** debe **coincidir exactamente** con el valor especificado al crear el enlace de pago inicial! {% endhint %} 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”**. {% hint style="warning" %} 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**. {% endhint %} ## **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** . --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mavibot.ai/doc/es/integrations/payment/bepaid.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.