# Wallet pay

## Conectando el sistema de pago ### Conectando del lado de Telegram **Paso 1.** Inicia sesión en tu cuenta de socio {% hint style="info" %} [Para ello, sigue el enlace](https://pay.wallet.tg/) {% endhint %} En la página que se abre, haz clic en "Iniciar sesión vía Telegram", luego introduce tu número de teléfono en la ventana emergente "Aparece oauth.telegram.org" y haz clic en "Aplicar". Es necesario conectar el sistema de pago tanto a través del navegador web como a través de la aplicación: * Recibirás un mensaje de Telegram solicitando autorización: haz clic **"Aplicar".** * También necesitas hacer clic en "Aplicar" en la ventana emergente **"oauth.telegram.org" en un navegador web.** {% hint style="success" %} Se recomienda usar una cuenta a la que tenga acceso la persona a cargo de las finanzas. Para personas jurídicas: un representante autorizado. {% endhint %} **Paso 2.** Realiza una breve encuesta

Fig. 1. Rellenando la información sobre el comerciante

Si inicias sesión por primera vez o necesitas información adicional, WalletPay te ofrece responder algunas preguntas para obtener información más detallada. Hay dos pasos: #### 1. Cuestionario #### 2. Verificaciones KYB (Conoce tu negocio) o KYC (Conoce a tu cliente) Al finalizar, tu solicitud será revisada pronto y se te notificarán los resultados. Si todo va bien, verás la comisión cobrada por el servicio y obtendrás acceso a tu cuenta, donde podrás comenzar la integración. {% hint style="warning" %} Para personas jurídicas, el formulario solo puede ser completado por una persona de confianza: un director o un empleado con poder. {% endhint %} **Paso 3.** *Crea la primera "Tienda".* Después de completar con éxito la "Encuesta", se te sugerirá crear tu primera tienda. **Paso 4.** *Crear una "clave API"* Después del nombre de la primera tienda, se te sugerirá configurarla: * Generar clave API. * Copia tu clave API y comienza a integrarte con Mavibot. **Paso 5**. *Crear un pedido y recibir un enlace de pago* Si quieres poner un enlace en un botón, usa **Botón en línea.** Ten en cuenta que solo el "customerTelegramUserId" especificado puede abrir la página de pago. **Paso 6.** *Retirar fondos* Después de que el cliente confirme el pago, los fondos se acreditan a tus activos y se retienen durante 48 horas de forma predeterminada. Transcurrido este tiempo, podrás retirar los fondos al saldo de tu Wallet, que usaste para iniciar sesión en el servicio Paypal Wallet. **Paso 7.** *Devolución de fondos* Actualmente, la retirada de fondos está disponible desde tu cuenta de Wallet, que utilizas para iniciar sesión en WalletPay. Pero pronto estará disponible en tu cuenta Merchant. ### ¿Cómo se ve el botón de pago? Al integrar tu bot de Telegram con la "Wallet Pay API", asegúrate de que el botón de pago cumpla con las siguientes recomendaciones: 1. Nombrado de una de estas dos formas: * :purse: Wallet Pay * :purse: Pagar vía Wallet 2. Ubicado encima de los otros botones (si es que tienes alguno). > Nota. :purse: — es un emoji (ver ). > > Vea el ejemplo en \[[Demo Store Bot](https://t.me/PineAppleDemoWPStoreBot)]. ## Conectando con Mavibot Inicia sesión en el proyecto y haz clic en el **“Conectar”** botón de Wallet Pay en la sección “Sistemas de pago”.

Fig. 2. La sección "Adquisición" para conectar el servicio a Mavibot

En la ventana que se abre, introduce la clave API generada para tu tienda WalletPay.

Fig. 3. Un formulario con el campo de entrada de la clave API

* [x] ¡Listo! Ahora los clientes pueden pagar las compras en tu tienda en criptomonedas (USDT, Toncoin y Bitcoin) usando el servicio Paypal Wallet. ### Cómo generar un enlace de pago Crea un bloque del constructor de embudos y llama a **“wallet\_pay\_generate\_payment\_url”** función en la calculadora, pasándole los parámetros necesarios: | Parámetros | Descripción de los parámetros | | ---------------------- | ------------------------------------------------------------------------------------------------------------- | | **amount** | la cantidad del pago en criptomoneda u otra moneda fiduciaria disponible para su conversión a “TON”. | | **código\_de\_moneda** | La moneda de pago predeterminada es “RUB". Lista de monedas disponibles: "TON" "BTC" "USDT" "EUR" "USD" "RUB" | | **description** | una breve descripción del pedido de 5 a 100 caracteres. | | **timeout\_seconds** | El período de validez del enlace es en segundos; el valor predeterminado es 3600 segundos. |

Fig. 4. Ejemplo de transmisión de parámetros

Cuando el bloque se activa en un chat con un bot, el cliente recibirá un enlace de pago, y el **wallet\_pay\_payment\_completed** variable del cliente se creará con el valor **False.** {% hint style="warning" %} Este enlace solo puede abrirse en un chat con un bot conectado a una cuenta de facturación de WalletPay. {% endhint %} ### Verificación del pago Después de un pago exitoso, el **wallet\_pay\_payment\_completed** variable del cliente se establecerá en **True,** y el vendedor recibirá una devolución de llamada en forma de **4690FE98\_success**, que consiste en: * “4690FE98” - estas son las primeras 8 caracteres de la clave API de Wallet Pay. * palabras sobre un éxito **!** si hay un error en el pago, recibirás un **callback** con el sufijo “**\_fail**”. Dirección para notificaciones (callbacks): - insertada en la configuración del sistema de pago Se puede incrustar una devolución de llamada en la condición del bloque para enviar un mensaje al cliente sobre un pago exitoso (o un error de pago):

Fig. 5. Un ejemplo de la reacción a una devolución de llamada en el bloque "Condición inicial"

Fig. 6. Un ejemplo de una respuesta a una devolución de llamada en el bloque "Condición sin estado"

{% hint style="info" %} Si no quieres sacar al cliente del esquema principal del chatbot, usa el bloque "Condición sin estado". No puedes ir a este bloque, así que el cliente no será sacado del embudo principal después del pago y recibirá una notificación de pago exitoso.\ notificación de pago exitoso. Y si necesitas continuar el embudo con una reacción a un pago exitoso, entonces usa el bloque "Condición de inicio", luego el cliente pasará del bloque de pago al bloque "Condición de inicio", desde el cual puedes continuar el embudo. {% endhint %} {% hint style="info" %} Más información sobre los bloques condicionales se proporciona en el artículo del mismo nombre. enlace[блоках с условием рассказали](broken://pages/9c7b0563335b0dd52b155c8996e05cb9a6b2c0c9) {% endhint %} ### Enlaces útiles \[[Soporte empresarial de Wallet Pay](https://t.me/WalletPay_supportbot)] \[[Demo Store Bot](https://t.me/PineAppleDemoWPStoreBot)] \[[Comunidad de comerciantes](https://t.me/+6TReWBEyZxI5Njli)] --- # 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/pago/wallet-pay.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.