Para utilizar la pasarela de pago iyzico en Mavibot, debes obtener tus credenciales API desde tu cuenta de comerciante de iyzico e ingresarlas en la configuración de integración.

Obtención de credenciales API

  1. Inicia sesión en tu Panel de Comerciante de iyzico.
  2. Ve a Configuración → Claves API (Claves API de Comerciante).
  3. Copia las siguientes credenciales:
    • Clave API
    • Clave Secreta

Estas credenciales son necesarias para conectar iyzico con Mavibot.

Para pruebas, iyzico proporciona credenciales separadas con el prefijo sandbox-. Si ingresas estas credenciales, todos los pagos se procesarán automáticamente en modo Sandbox (prueba); no se requiere configuración adicional. Para aceptar pagos en vivo, utiliza tus credenciales de producción (sin el prefijo sandbox-).

Conexión de iyzico

En la pestaña de Adquirencia, selecciona iyzico.

Luego ingresa:

  • Clave API — tu clave API.
  • Clave Secreta — tu clave secreta.

La integración ahora está completa.

Generación de un enlace de pago

Función de calculadora:

get_iyzico_payment_url(amount, description, currency, customer_email, customer_phone, full_name, identity_number, city, country, address, product_name, language)

Parámetros

La función devuelve una URL de pago.

Botón de enlace de pago

Para enviar un botón con un enlace de pago, selecciona el tipo Botón de pago y elige iyzico como pasarela de pago. Luego ingresa el nombre del producto, el monto del pago y, si es necesario, la moneda del pago.

Callbacks de pago

Después de que el cliente abra el enlace de pago y complete el pago, se envía el siguiente callback a la conversación tras un pago exitoso:

SDJ91MTKTT_success 100

Donde:

  • SDJ91MTKTT son los primeros 10 caracteres de tu Clave Secreta.
  • 100 es el monto del pago.

Si el pago falla, se envía el siguiente callback:

SDJ91MTKTT_fail 100

Variables del cliente después de un pago exitoso

Variable Valor
iyzico_callback_data Información de pago recibida de iyzico
iyzico_payment_completed "True" si el pago se procesó correctamente
iyzico_payment_id ID de pago de iyzico