Garanti BBVA
Para usar el Garanti BBVA (Sanal POS) sistema de pago en Mavibot, necesitas obtener el POS virtual terminal POS credenciales del banco e introducirlas en la configuración de la integración. El pago se procesa en la página segura del banco con 3D Secure confirmación.
Obtención de las credenciales
Firma un acuerdo con Garanti BBVA para el Sanal POS (servicio POS virtual). Al activar el servicio, pide al banco que habilite Ortak Ödeme (página de pago compartida) para tu terminal. Sin esta función, los pagos a través de la página de pago del banco no funcionarán.
El banco te proporcionará:
ID de comerciante (Üye İşyeri No) — tu ID de comerciante;
ID de terminal — tu ID de terminal;
ID de usuario de provisión — el nombre de usuario de provisión (normalmente PROVAUT o PROVOOS);
Contraseña de provisión — la contraseña del usuario de provisión.
La Store Key (clave 3D Secure) la creas tú en el Sanal POS panel de administración (Yönetim → 3D Secure). Asegúrate de guardarla, ya que también se requiere para la integración.
¿Cómo conectar Garanti BBVA a Mavibot?
En la Adquirencia sección de Mavibot, selecciona Garanti BBVA y introduce los siguientes datos:
ID de comerciante — tu ID de comerciante.
ID de terminal — tu ID de terminal.
ID de usuario de provisión — el nombre de usuario de provisión. Si se deja en blanco, PROVAUT se utilizará.
Contraseña de provisión — la contraseña del usuario de provisión.
Store Key — tu clave 3D Secure.
Nombre de la tienda — el nombre que se muestra a los clientes en la página de pago del banco. Si se deja en blanco, "Tienda en línea" se mostrará.
Modo de prueba — habilita esta opción para probar la integración utilizando las credenciales de prueba del banco. Para procesar pagos reales, esta opción debe desactivarse.
La integración ya está completa.
Generación de un enlace de pago
Función de la calculadora:
get_garanti_payment_url(amount, description, currency, customer_email, language)
Parámetros:
amount
Importe del pago.
✅
—
description
Descripción del pago.
No
—
currency
Moneda del pago.
No
TRY (predeterminado). Valores admitidos: TRY, USD, EUR, GBP, JPY
customer_email
Dirección de correo electrónico del cliente.
No
—
language
Idioma de la página de pago.
No
tr (predeterminado). Valores admitidos: tr, en
La función devuelve una URL de pago.
Enlace de pago en un botón
Para enviar un botón con un enlace de pago, selecciona el Pago tipo de botón y elige Garanti BBVA como proveedor de pago. Luego introduce el nombre del producto, el importe del pago y, si es necesario, la moneda del pago.
Ejemplo 1: Configuración del flujo de trabajo
Paso 1. Crea un Inicio bloque.
El bloque Inicio se suele usar para mostrar el primer mensaje de bienvenida del flujo de trabajo, junto con cualquier información introductoria que el usuario necesite.
Paso 2. Crea el bloque que se muestra a continuación.
Paso 3. Ve a los Conexión ajustes.
Necesitarás la siguiente expresión regular para verificar que el cliente ha introducido una dirección de correo electrónico válida:
^[-\w.]+@([A-z0-9][-A-z0-9]+.)+[A-z]{2,4}$
Además, activa la opción El usuario introduce datos e introduce customer_email.
Paso 4. Introduce el mensaje en el segundo bloque.
Paso 5. Crea un tercer bloque y abre los Conexión ajustes entre el segundo y el tercer bloque.
Activa el temporizador para avanzar automáticamente al siguiente bloque.
Paso 6. En el tercer bloque, introduce la función en la Calculadora.
Ejemplo para copiar:
Si quieres aceptar pagos en una moneda distinta de la lira turca (TRY), especifica la moneda como se muestra a continuación.
Ejemplo para copiar:
Ejemplo 2. Botón de facturación
Este ejemplo es casi idéntico a Ejemplo 1.
Sin embargo, en lugar de crear un tercer bloque con una función para generar el enlace de pago, puedes crear un botón en el segundo bloque.
En la ventana que se abre:
Introduce el texto del botón.
Selecciona la Facturación función.
Selecciona Garanti BBVA como proveedor de pago.
Luego introduce lo siguiente:
Nombre del producto.
Importe del pago.
Moneda (opcional).
Nombre completo del cliente (opcional). Puedes configurarlo del mismo modo que configuraste la entrada del correo electrónico del cliente.
Correo electrónico del cliente — introduce la variable
#{customer_email}.
Luego haz clic en Añadir.
Notificaciones después del pago
Después de que el cliente siga el enlace de pago y complete el pago, se enviará una notificación (callback) a la conversación.
Para un pago exitoso:
Donde:
SDJ91MTKTTson los primeros 10 caracteres de tu Store Key.100es el importe del pago.
Si el pago falla, se enviará la siguiente notificación:
Cómo enviar una respuesta a un pago exitoso o fallido
Paso 1. Crea un Disparador bloque.
Paso 2. En el campo de condición, introduce el texto de notificación SDJ91MTKTT_success — sin el importe del pago — si quieres reaccionar a cada pago.
En este caso, el Tipo de coincidencia debe establecerse en Por palabras clave.
Como alternativa, introduce todo el texto del callback en el campo Disparador si quieres reaccionar a un pago específico. En este caso, el Tipo de coincidencia debe establecerse en Coincidencia exacta.
Si quieres continuar el flujo de trabajo después de un pago exitoso, puedes crear un Inicio bloque en lugar de un Disparador bloque y continuar construyendo el flujo de tu bot desde ahí.
Variables del cliente después de un pago exitoso
garanti_callback_data
Información de pago recibida del sistema de pago.
garanti_payment_completed
"True" si el pago se ha procesado correctamente.
garanti_auth_code
El código de autorización de la transacción del banco.
Última actualización