Integración de pagos de Bank of Maldives (BML) en LithosPOS

Bank of Maldives (BML) permite que los clientes paguen sus pedidos en línea en la página de pago de BML. LithosPOS envía el total del pedido a BML, el cliente paga con tarjeta en la página de BML y el pedido se envía a tu POS en cuanto BML confirma el pago.

La configuración tiene cuatro pasos:

Obtén tu secreto de API de BML → Agrega el tipo de pago → Registra la URL del webhook → Activa BML en tu tienda en línea

Antes de empezar

• Bank of Maldives está disponible solo para negocios en Maldivas. El Back office lo ofrece como método de pago cuando el país de tu negocio es Maldivas, y a los clientes siempre se les cobra en MVR.
• Necesitas una cuenta de comercio de Bank of Maldives con acceso al BML Merchant Dashboard.
• Primero configura tu tienda en línea (consulta Plataforma de pedidos en línea QK-Order).

Obtener tu secreto de API de Bank of Maldives

1. Inicia sesión en el BML Merchant Dashboard.
2. Ve a Connect → Application.
3. Copia la API key (secret). Deja el panel abierto: volverás a él para agregar la URL del webhook.

Agregar el tipo de pago de Bank of Maldives

1. Inicia sesión en el Back office en my.lithospos.com.
2. Ve a Configuración → Tipos de pago y haz clic en + Agregar tipo de pago.
3. Ingresa un Nombre (por ejemplo, Bank of Maldives) y un Nombre en el recibo, el texto que se imprime en los recibos.
4. En Método de pago, elige Bank Of Maldives.
5. En Clave de autenticación (secreto de API), pega el secreto de API que copiaste de Connect → Application.
6. En Tiendas activadas, deja activado Activado en todas las tiendas o elige las tiendas que aceptan pagos con BML.
7. Deja activado Activo y haz clic en Guardar tipo de pago.

Registrar la URL del webhook en Bank of Maldives

El webhook permite que Bank of Maldives avise a LithosPOS cuando se confirma un pago. La URL es única para tu negocio y aparece debajo del secreto de API.

1. En el panel Agregar tipo de pago (o cuando vuelvas a abrir el tipo de pago de Bank of Maldives), busca URL del webhook y haz clic en Copiar.
2. En el BML Merchant Dashboard, ve a Connect → Webhook.
3. Pega la URL y guárdala.

Activar Bank of Maldives en tu tienda en línea

Bank of Maldives se activa por tienda, así que los clientes solo lo ven en las tiendas que elijas.

1. En el Back office, ve a Pedidos en línea → Configuración.
2. En Editando pedidos en línea para, elige la tienda.
3. Abre la pestaña Quiqqy y luego la pestaña Pagos.
4. Busca Bank of Maldives en Métodos de pago y actívalo. La fila muestra Conectado cuando existe un tipo de pago de Bank of Maldives activo con un secreto de API.
5. Repite estos pasos en cada tienda que acepte pagos con BML.

Si la fila muestra No conectado, haz clic en Configurar para ir a Configuración → Tipos de pago y agregar o corregir el tipo de pago de Bank of Maldives.

Cómo pagan los clientes

1. El cliente hace un pedido en tu tienda en línea y elige Bank of Maldives al finalizar la compra.
2. LithosPOS envía el total del pedido a Bank of Maldives en MVR y el cliente pasa a la página de pago de BML.
3. El cliente paga en la página de BML y vuelve a tu tienda en línea.
4. LithosPOS verifica el pago con Bank of Maldives. Cuando BML lo confirma, se crea el pedido, aparece en Pedidos en línea y en tu POS, y queda registrado en tu tipo de pago de Bank of Maldives.

Si el pago se cancela o no se completa, no se crea ningún pedido. Se informa al cliente de que el pago no se completó y puede volver a pagar o elegir otro método de pago.

Informes y conciliación

Los pagos con Bank of Maldives se registran en el tipo de pago de Bank of Maldives en tus informes de ventas y de pagos. Al conciliar, compara estos informes con las transacciones del BML Merchant Dashboard.

Solución de problemas

• Bank Of Maldives no aparece en la lista Método de pago. El país de tu negocio no es Maldivas. Bank of Maldives solo se ofrece a negocios en Maldivas.
• La pestaña Pagos muestra No conectado. No existe ningún tipo de pago de Bank of Maldives activo con un secreto de API. Agrega uno en Configuración → Tipos de pago, o abre el existente y vuelve a pegar el secreto de API.
• Al activar Bank of Maldives aparece "Selecciona primero una tienda." La tienda aún no tiene configuración de pedidos en línea. Completa y guarda la pestaña Configuración de la tienda de esa tienda y vuelve a intentarlo.
• La compra falla cuando un cliente elige Bank of Maldives. Bank of Maldives rechazó la solicitud, normalmente porque el secreto de API es incorrecto o se generó uno nuevo. Vuelve a copiarlo de Connect → Application y actualiza el tipo de pago.
• Un cliente pagó pero no llegó ningún pedido. El pedido se crea cuando el cliente vuelve desde la página de BML. Si cerró la página antes de volver, busca la transacción en el BML Merchant Dashboard y contacta al soporte de LithosPOS con el ID de la transacción.

Contáctanos para saber más

Para saber más, agenda una reunión con nuestro equipo.

RESERVA UNA DEMOSTRACIÓN