Conexión del sistema de pago
Conexión desde el lado de Telegram
Paso 1. Inicia sesión en tu cuenta de socio
En la página que se abre, haz clic en "Iniciar sesión a través de Telegram", luego ingresa 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 en "Aplicar".
- También debes hacer clic en "Aplicar" en la ventana emergente "oauth.telegram.org" en un navegador web.
Se recomienda usar una cuenta a la que tenga acceso la persona responsable de finanzas. Para personas jurídicas: un representante autorizado.
Paso 2. Realiza una pequeña encuesta
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)
Después de completarlo, tu solicitud será revisada pronto y se te notificarán los resultados. Si tiene éxito, verás la comisión que cobra el servicio y obtendrás acceso a tu cuenta donde podrás comenzar la integración.
Para personas jurídicas, el formulario solo puede ser completado por una persona de confianza: un director o un empleado con poder notarial.
Paso 3. Crea la primera "Tienda".
Después de completar la "Encuesta" con éxito, se te sugerirá crear tu primera tienda.
Paso 4. Crea una "Clave API"
Después del nombre de la primera tienda, se te sugerirá configurarla:
- Genera la clave API.
- Copia tu clave API y comienza a integrar con Mavibot.
Paso 5. Crea un pedido y recibe un enlace de pago
Si deseas colocar 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. Retira fondos
Después de que el cliente confirme el pago, los fondos se acreditan en tus activos y se retienen durante 48 horas de forma predeterminada. Después de 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, los fondos de retiro están disponibles desde tu cuenta de Wallet, que usas para iniciar sesión en WalletPay. Pero pronto estará disponible en tu cuenta de Comerciante.
¿Cómo se ve el botón de pago?
Al integrar tu Bot de Telegram con la "API de Wallet Pay", asegúrate de que el botón de pago cumpla con las siguientes recomendaciones:
- Nombrado de una de las dos maneras:
- 👛 Wallet Pay
- 👛 Pagar con Wallet
- Ubicado encima de los otros botones (si los tienes).
Nota. 👛 — es un emoji (ver https://emojipedia.org/purse/).
Consulta el ejemplo en [Demo Store Bot].
Conexión a Mavibot
Inicia sesión en el proyecto y haz clic en el botón “Conectar” para Wallet Pay en la sección “Sistemas de pago”.
En la ventana que se abre, ingresa la clave API generada para tu tienda WalletPay.
- ¡Listo! Ahora los clientes pueden pagar las compras en tu tienda con criptomonedas (USDT, Toncoin y Bitcoin) usando el servicio Paypal Wallet.
Cómo generar un enlace de pago
Crea un bloque constructor de embudo y llama a la función “wallet_pay_generate_payment_url” en la calculadora, pasándole los parámetros necesarios:
| Parámetros | Descripción de parámetros |
|---|---|
| amount | el monto del pago en criptomoneda u otra moneda fiduciaria disponible para conversión a “TON”. |
| сurrency_code | 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 en segundos, el valor predeterminado es 3600 segundos. |
Cuando el bloque se activa en un chat con un bot, el cliente recibirá un enlace de pago y se creará la variable de cliente wallet_pay_payment_completed con el valor False.
Este enlace solo se puede abrir en un chat con un bot conectado a una cuenta de facturación de WalletPay.
Verificación de pago
Después de un pago exitoso, la variable wallet_pay_payment_completed del cliente se establecerá en True, y el vendedor recibirá un callback en forma de 4690FE98_success, que consta de:
- “4690FE98” - estos son los primeros 8 caracteres de la clave API de Wallet Pay.
- palabras de éxito
! si hay un error de pago, recibirás un callback con el sufijo “_fail”.
Dirección para notificaciones (callbacks): https://chatter.salebot.pro/wallet_pay/payment_callback - insertada en la configuración del sistema de pago
Se puede incrustar un callback en la condición del bloque para enviar un mensaje al cliente sobre un pago exitoso (o un error de pago):
Si no deseas sacar al cliente del esquema principal del chatbot, usa el bloque "Condición sin estado". No puedes ir a este bloque, por lo que el cliente no será sacado del embudo principal después del pago y recibirá una 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 se moverá del bloque de pago al bloque "Condición de inicio", desde donde puedes continuar el embudo.
Más información sobre los bloques condicionales se proporciona en el artículo del mismo nombre. bloques con condición explicados