Iyzico

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

Obtención de credenciales de API

1. Inicia sesión en tu panel de comerciante de iyzico.

2. Ve a Configuración → Claves de API (Claves de API del comerciante).

3. Copia las siguientes credenciales:

   • Clave de API

   • Clave secreta

Estas credenciales son necesarias para conectar iyzico con Mavibot.

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

Conectando iyzico

En la pestaña de Adquirencia, selecciona iyzico.

Luego introduce:

• Clave de API — tu clave de API.

• Clave secreta — tu clave secreta.

La integración ya 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

Parámetro	Descripción	Requerido	Valor predeterminado / Valores permitidos
amount	Importe del pago.	✅	—
description	Descripción del pago.	No	—
currency	Moneda del pago.	No	Predeterminado: TRY Admitidos: TRY, USD, EUR, GBP, CHF, NOK
customer_email	Dirección de correo electrónico del cliente.	No	—
customer_phone	Número de teléfono del cliente en formato internacional (por ejemplo, +905XXXXXXXXX).	No	—
full_name	Nombre completo del cliente.	No	—
identity_number	Número de identificación del cliente (para clientes en Turquía, este es el TCKN).	No	—
city	Ciudad del cliente.	No	—
country	País del cliente.	No	—
address	Dirección del cliente.	No	—
product_name	Nombre del producto mostrado en la página de pago. Si se omite, description se usa.	No	Usa description
language	Idioma de la página de pago.	No	Predeterminado: en Admitidos: en, tr

La función devuelve una URL de pago.

ejemplo

Botón de enlace de pago

Para enviar un botón con un enlace de pago, selecciona el Botón de pago tipo y elige iyzico como pasarela de pago. Luego introduce el nombre del producto, el importe 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, el siguiente callback se envía a la conversación cuando el pago se realiza correctamente:

SDJ91MTKTT_success 100

Donde:

• SDJ91MTKTT son los primeros 10 caracteres de tu Clave secreta.

• 100 es el importe 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 del pago recibida de iyzico
iyzico_payment_completed	"True" si el pago se procesó correctamente
iyzico_payment_id	ID del pago de iyzico