La integración con PayTR te permite aceptar pagos a través de PayTR, un proveedor de servicios de pago turco. Los clientes completan sus pagos en la página segura de PayTR, donde pueden usar tarjetas bancarias turcas y otros métodos de pago locales.

Obtención de Credenciales de Integración

Antes de conectar PayTR, firma un acuerdo con PayTR y obtén acceso a tu cuenta de comercio.

En el menú izquierdo, abre Bilgi (Información) y localiza la sección API Entegrasyon Bilgileri. Copia los siguientes valores:

Panel de PayTR Campo de Mavibot
Mağaza No ID de Comercio (merchant_id)
Mağaza Anahtarı Clave de Comercio (merchant_key)
Mağaza Şifresi Sal de Comercio (merchant_salt)

Nota: Estas credenciales solo están disponibles para el Ana Kullanıcı (Usuario Principal) y el Teknik Sorumlu (Responsable Técnico). Si no puedes ver esta sección, pide al propietario de la cuenta principal que te conceda los permisos necesarios.

No es necesario configurar una URL de notificación de pago (callback) en el panel de PayTR. Mavibot envía automáticamente la URL de callback con cada solicitud de enlace de pago.

Conexión de PayTR

Abre la configuración de Adquirencia en Mavibot y selecciona PayTR.

Introduce las siguientes credenciales:

  • ID de Comercio (merchant_id) — tu Mağaza No
  • Clave de Comercio (merchant_key) — tu Mağaza Anahtarı
  • Sal de Comercio (merchant_salt) — tu Mağaza Şifresi

Guarda la configuración para completar la integración.

Generación de un Enlace de Pago

Usa la función de calculadora:

get_paytr_payment_url(amount, description, currency, customer_email, product_name, expired, language)

Parámetros

Parámetro Obligatorio Descripción
amount ✅ Monto del pago.
description No Descripción del pago (producto o servicio). Se muestra en la página de pago de PayTR.
currency No Moneda del pago: TL, USD, EUR, GBP o RUB. Valor predeterminado: TL.
customer_email No Dirección de correo electrónico del cliente.
product_name No Nombre del producto que se muestra en la página de pago.
expired No Duración del enlace de pago en segundos. Si se omite, el enlace nunca caduca.
language No Idioma de la página de pago: tr (turco) o en (inglés). Valor predeterminado: tr.

La función devuelve una URL de pago.

Notas

  • El código de moneda TRY se convierte automáticamente a TL.
  • Si se especifica una moneda no compatible, se usa TL automáticamente.
  • El nombre del producto debe contener entre 4 y 200 caracteres.
    • Los nombres de menos de 4 caracteres se rellenan con puntos (.).
    • Los nombres de más de 200 caracteres se truncan automáticamente.

Ejemplo

Paso 1

Crea un mensaje pidiendo al cliente que introduzca su dirección de correo electrónico.

Paso 2

Crea el siguiente bloque debajo del mensaje y abre la configuración de flecha.

Configura la Conexión de la siguiente manera:

  • Tipo de coincidencia: Expresión regular
  • Habilita la opción El usuario introduce datos.
  • Introduce el nombre de la variable: customer_email

Guarda la configuración de la Conexión.

Paso 3

Introduce los parámetros de la función en la calculadora.

Creación de un Botón de Pago

Para enviar un botón de pago en Mavibot:

  1. Crea el bloque con un botón.

  1. Selecciona el tipo Facturación.
  2. Elige PayTR como proveedor de pago.
  3. Especifica:
    • Nombre del producto
    • Monto del pago
    • Moneda
  4. Opcionalmente, proporciona la variable que contiene la dirección de correo electrónico del cliente.

Callbacks de Pago

Después de que el cliente complete el pago, Mavibot recibe un callback y lo publica en la conversación.

Pago Exitoso

SDJ91MTKTT_success 100

Donde:

  • SDJ91MTKTT son los primeros 10 caracteres de tu Clave de Comercio (merchant_key).
  • 100 es el monto del pago.

Para reaccionar a pagos exitosos o fallidos, copia el valor del callback y crea un bloque Inicio (o bloque de Disparador).

Introduce el texto del callback en el disparador.

Luego crea un mensaje informando al cliente si el pago fue exitoso o fallido.

Desde este bloque, puedes continuar con el flujo de tu chatbot según sea necesario.

Nota: La configuración del disparador que se muestra en este ejemplo responderá a cada pago exitoso, ya que usa solo el prefijo del callback sin el monto del pago.
Si deseas reaccionar solo a la compra de un producto específico o a un monto de pago determinado, introduce el texto completo del callback, incluido el monto del pago, y cambia el Tipo de coincidencia a Coincidencia exacta.

Pago Fallido

SDJ91MTKTT_fail 100

Nota: Los enlaces de pago de PayTR son de un solo uso. Después de un pago exitoso, el enlace se desactiva automáticamente. Genera un nuevo enlace de pago para cada nuevo pago.

Variables del Cliente Después de un Pago Exitoso

Variable Descripción
paytr_callback_data Información de pago recibida de PayTR.
paytr_payment_completed "True" si el pago se procesó correctamente.
paytr_merchant_oid Identificador de transacción de PayTR (merchant_oid).