Cómo integrar LuqaPay

Aprenda a configurar la integración de LuqaPay con B2CORE a través de PSS para habilitar retiros

LuqaPay se puede conectar a B2CORE mediante PSS, lo que permite realizar retiros mediante transferencias bancarias en TRY.

Siga las instrucciones a continuación para configurar la conexión de LuqaPay y establecer el método de retiro en el Back Office de B2CORE. Estas instrucciones corresponden al procedimiento general para añadir métodos de sistemas de pago compatibles con PSS, pero incluyen detalles específicos de LuqaPay.

Antes de continuar con las instrucciones, debe haberse registrado en LuqaPay y tener una cuenta activa.

Configurar una conexión con LuqaPay

Para configurar una conexión con LuqaPay para realizar retiros:

En el Back Office de B2CORE, vaya a Sistema > Conexiones externas.

Haga clic en +Crear en la esquina superior derecha de la página.

En la página Crear conexión, complete los siguientes campos:

  • En el campo Nombre, introduzca un nombre para la conexión. El nombre debe ser único y solo puede contener letras latinas, números, guiones y guiones bajos (por ejemplo, Withdrawals_LuqaPay).
  • En el campo Título, introduzca un título que se aplicará a la conexión en el Back Office.
  • En la lista desplegable Proveedor, seleccione PaymentSystemWithdrawal.

En la lista desplegable Controlador que aparece, seleccione LuqaPay.

En la sección Credenciales que aparece, configure los ajustes específicos de LuqaPay:

  • En el campo URL base de la API, especifique:

    • https://wallet.luqapay.com — para el entorno de producción
    • https://sandbox-wallet.luqapay.com — para el entorno de pruebas sandbox
  • En el campo Clave API, introduzca la clave API generada en su cuenta de LuqaPay.

  • En el campo Clave secreta de API, introduzca la clave secreta de API generada en su cuenta de LuqaPay.

Haga clic en Guardar para crear la conexión.

La conexión LuqaPay aparecerá en la lista de conexiones externas.

Compruebe el estado de la conexión.

Si la conexión está inactiva (se muestra No en la columna Habilitado), haga clic en el botón Editar para abrir los detalles de la conexión y establezca la lista desplegable Habilitado en Sí.

Haga clic en Guardar para aplicar los cambios.

Añadir un método de retiro mediante LuqaPay

Para añadir y configurar un método para realizar retiros mediante LuqaPay:

En el Back Office de B2CORE, vaya a Sistema > Sistema de pagos > Métodos de pago.

Haga clic en +Crear en la esquina superior derecha de la página.

En la página Crear un método de pago, complete los siguientes campos:

  • En el campo Nombre, introduzca un nombre para el método. El nombre debe ser único y solo puede contener letras latinas, números, guiones y guiones bajos.
  • En el campo Título, introduzca un título para el método. Este título se asignará al método en el Back Office y será visible para los clientes en la interfaz de B2CORE.
  • En la lista desplegable Proveedor, seleccione PaymentSystemWithdrawal.

Después de seleccionar PaymentSystemWithdrawal, aparecen los siguientes campos:

  • En la lista desplegable Monedas de cuenta disponibles, seleccione una o más monedas. Los retiros mediante LuqaPay estarán disponibles desde cuentas denominadas en las monedas seleccionadas.
  • En la lista desplegable Controlador, seleccione LuqaPay.
  • En la lista desplegable Conexión, seleccione la conexión de LuqaPay configurada anteriormente.

En la sección Configuración, seleccione Türkiye en la lista desplegable País. Este es el único país compatible con esta integración.

Haga clic en Guardar para crear el método de retiro.

El método de retiro LuqaPay aparecerá en la lista de métodos de retiro.

Haga clic en Editar para acceder a los detalles del método y complete los siguientes campos:

  • En la pestaña Configuración, use la lista desplegable Grupo para seleccionar uno o más grupos en los que se debe incluir el método.

  • En el campo Icono, especifique la URL de una imagen que se mostrará como icono del método de retiro en la interfaz de B2CORE.

  • Compruebe el estado del método.

    Si el método está inactivo (se muestra No en el campo Habilitado), actívelo estableciendo la lista desplegable Habilitado en Sí.

  • En la pestaña Monedas PS, añada TRY. Esta es la única moneda compatible para procesar retiros con esta integración.

  • Si es necesario, configure las comisiones para el método en la pestaña Comisiones (para obtener más información, consulte Cómo configurar comisiones para métodos de depósito y retiro).

LuqaPay withdrawal method — Settings tab

Haga clic en Guardar para aplicar los cambios.

El método de retiro LuqaPay ahora está configurado en el Back Office de B2CORE.

Configurar un webhook en LuqaPay

Para recibir actualizaciones de estado de los retiros en B2CORE, se debe configurar un webhook de notificaciones en LuqaPay.

Copiar la URL del webhook desde el Back Office de B2CORE

En el Back Office de B2CORE, vaya a Sistema > Sistema de pagos > Métodos de pago.

Busque el método de retiro LuqaPay configurado y haga clic en Editar para abrir los detalles del método.

Vaya a la pestaña Webhooks.

Copie la URL que se muestra en el campo URL de notificación.

Proporcionar la URL del webhook a LuqaPay

Envíe la URL del webhook copiada al soporte de LuqaPay para que la configure de su lado.

Última actualización

En esta página