Volver

VibeFox Klarna for OpenCart — Ayuda

Requisitos

OpenCart: 3.0.x (probado en 3.0.5.0) o 4.0.2 y posteriores (probado en 4.1.0.3).

PHP: 8.0 o posterior.

Cuenta de comerciante de Klarna: necesitas las credenciales de API de Klarna (nombre de usuario y contraseña) de tu cuenta de comerciante para una región de API, y las credenciales de prueba del portal Klarna Playground (consulta Configuración). Cada región de API tiene sus propias credenciales. Solo se puede usar una cuenta de comerciante (una región de API) por tienda.

Moneda: una moneda de Klarna de tu región: EUR, SEK, NOK, DKK, GBP, CHF, PLN, CZK, HUF o RON en Europa; USD, CAD o MXN en Norteamérica; AUD o NZD en Oceanía. La moneda debe existir en System > Localisation > Currencies.

Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un dominio.

Instalación

La descarga es un único archivo zip con los paquetes para ambas versiones de OpenCart. Descomprímelo en tu ordenador. Contiene README.txt, el paquete de OpenCart 3 wcp_klarna_payment-oc3-(version).ocmod.zip y el paquete de OpenCart 4 wcp_klarna_payment.ocmod.zip. Instala solo el paquete de tu versión de OpenCart. La clave de licencia es la misma para ambas versiones.

OpenCart 3

1. En el panel de administración ve a Extensions > Installer, haz clic en Upload y elige el archivo wcp_klarna_payment-oc3-(version).ocmod.zip. La extensión no tiene modificaciones OCMOD, así que Extensions > Modifications no necesita actualizarse. En lugar del instalador, puedes copiar el contenido de la carpeta upload de este paquete en la carpeta raíz de tu tienda.

2. Ve a Extensions > Extensions y elige el tipo Payments. Busca VibeFox Klarna Payments y haz clic en Install (el botón verde +). Tu usuario de administración necesita el permiso para modificar la lista de extensiones de pago.

3. Haz clic en Edit (el botón del lápiz) para abrir la página de configuración. Pega tu clave de licencia de VibeFox en License key, en el bloque de licencia de la parte superior de la página, y haz clic en Activate (consulta Clave de licencia).

4. Elige la API region de tu cuenta de comerciante de Klarna.

5. Introduce el nombre de usuario y la contraseña de prueba del portal Klarna Playground, deja activado Test mode, activa Enable/Disable, haz clic en Save y realiza un pedido de prueba.

6. Introduce el nombre de usuario y la contraseña reales del Klarna Merchant Portal, desactiva Test mode y elige cuándo se capturan los pedidos (predeterminado: cuando el pedido se envía o se completa).

OpenCart 4

1. En el panel de administración ve a Extensions > Installer, haz clic en Upload y elige el archivo wcp_klarna_payment.ocmod.zip. No cambies el nombre del archivo: OpenCart 4 toma el código de la extensión del nombre del archivo, y un paquete renombrado no funciona.

2. El paquete aparece en la lista de extensiones instaladas en la misma página. Haz clic en Install (el botón verde +) junto a él.

3. Ve a Extensions > Extensions y elige el tipo Payments. Busca VibeFox Klarna Payments, haz clic en Install (el botón verde +) y luego en Edit (el botón del lápiz).

4. Introduce la clave de licencia, la región de API, las credenciales y el modo de captura como en los pasos 3 a 6 de OpenCart 3. La página de configuración y sus campos son los mismos en ambas versiones. Solo la URL de notificación es distinta (consulta Notificaciones).

Una instalación nueva empieza con el método de pago desactivado y el modo de prueba activado. La URL de notificación se envía con cada pedido de Klarna, así que no hace falta configurar nada en Klarna.

Configuración

Todos los ajustes están en la página de la extensión: Extensions > Extensions > Payments > VibeFox Klarna Payments > Edit. Las secciones aparecen a la izquierda; el botón Save situado debajo de la lista guarda toda la página. Encima de los ajustes, la página muestra TEST MODE: Klarna playground, no real payments. o LIVE: real Klarna payments. La página avisa si falta el nombre de usuario o la contraseña del modo activo (en ese caso, Klarna no aparece en la finalización de compra) y si Klarna no admite la moneda predeterminada de la tienda en la región de API seleccionada. Sin el permiso para modificar la extensión, la página muestra los ajustes pero no permite guardarlos.

Al guardar, Title no puede estar vacío (máximo 128 caracteres), Sort Order debe ser un número entero (se permiten números negativos), Total debe ser un número igual o mayor que 0, y la región de API, el modo de captura, la zona geográfica y los estados de pedido deben ser válidos. Si no, no se guarda nada y la página indica el campo incorrecto. Las credenciales que faltan no impiden guardar.

Pagos con Klarna

Enable/Disable: activa o desactiva el método de pago. Predeterminado: desactivado. Klarna aparece en la finalización de compra solo si el nombre de usuario y la contraseña del modo activo están rellenados y el país de facturación del cliente es un mercado de Klarna de la región de API, con pago en la moneda de ese país.

Title: el nombre del método de pago que ve el cliente en la finalización de compra. También es el nombre del método de pago guardado en el pedido. Predeterminado: Klarna. Obligatorio.

Description: el texto que ve el cliente en el paso Confirm Order, encima del widget de Klarna. Predeterminado: Pay now, later or in instalments with Klarna.

Sort Order: la posición de Klarna entre los métodos de pago en la finalización de compra. Déjalo vacío o introduce un número entero.

Geo Zone: ofrece Klarna solo para direcciones de pago de la zona geográfica seleccionada. Predeterminado: All zones. Las zonas geográficas se configuran en System > Localisation > Geo Zones.

Total: el total de la compra, en la moneda predeterminada de la tienda, que un pedido debe alcanzar para que se ofrezca Klarna. Déjalo vacío para ofrecer Klarna con cualquier importe.

Credenciales de API

Las credenciales de API de Klarna (nombre de usuario y contraseña) se crean en el Klarna Merchant Portal, en Settings > Klarna API credentials (allí hay enlaces a la sección). Las credenciales de prueba proceden del portal Playground: una para Europa y otra para Norteamérica y Oceanía. Cada región de API tiene sus propias credenciales.

Test mode: usa el entorno Klarna Playground (credenciales de prueba, sin pagos reales). Predeterminado: activado. Mientras el modo de prueba esté activado, los clientes ven TEST MODE: Klarna playground, no real payment is made. en el paso Confirm Order. Los pedidos conservan el entorno en el que se realizaron: las capturas y los reembolsos de pedidos de Playground siempre usan las credenciales de prueba.

API region: la región de tu cuenta de comerciante de Klarna. Los clientes solo pueden pagar con Klarna desde los países de esta región, en la moneda de su país. El país se toma de la dirección de pago del pedido.

Europe: Austria, Bélgica, Finlandia, Francia, Alemania, Grecia, Irlanda, Italia, Países Bajos, Portugal, Eslovaquia y España (EUR), Suecia (SEK), Noruega (NOK), Dinamarca (DKK), Reino Unido (GBP), Suiza (CHF), Polonia (PLN), República Checa (CZK), Hungría (HUF), Rumanía (RON). Predeterminado.
North America (US, CA, MX): Estados Unidos (USD), Canadá (CAD), México (MXN).
Oceania (AU, NZ): Australia (AUD), Nueva Zelanda (NZD).

Live username (UID): el nombre de usuario de la API de producción, por ejemplo PK12345_abcdef012345.

Live password: la contraseña de la API de producción (secreto compartido).

Test username (UID): el nombre de usuario de la API de Playground.

Test password: la contraseña de la API de Playground (secreto compartido).

Las contraseñas guardadas nunca se vuelven a mostrar. El campo queda vacío y muestra Saved — leave empty to keep it. Escribe un valor nuevo solo si quieres cambiarlo. Para eliminar una contraseña guardada, marca Clear the saved password on save debajo del campo y haz clic en Save.

Gestión de pedidos

Un pedido de Klarna realizado es una autorización: el cliente solo se cobra cuando el pedido se captura. Las autorizaciones no capturadas caducan, normalmente a los 28 días, así que envía los pedidos a tiempo o usa la captura automática.

Capture: el momento en que se cobra al cliente. Los reembolsos solo son posibles por importes capturados.

When the order is shipped / completed (recommended): captura cuando cambies el pedido a un estado completado, es decir, uno de los estados seleccionados en System > Settings > Option > Completed Order Status (por defecto, Completado y Enviado). Predeterminado. Si la captura falla, el estado no cambia y el motivo se muestra en la página del pedido (consulta Pedidos y reembolsos).
Immediately (auto capture): cobra al cliente de inmediato, para bienes digitales o servicios.
Manually in the Klarna portal: la extensión no captura. Captura el pedido en el Klarna Merchant Portal.

Cancellation: cancela el pedido de Klarna (libera la autorización) cuando un pedido aún no capturado se cambia al estado Canceled Status de abajo. Predeterminado: activado.

Estados del pedido

OpenCart crea el pedido en el paso Confirm Order sin estado (un pedido ausente). Solo recibe un estado cuando Klarna ha registrado el pedido de Klarna para la compra aprobada en el widget. Una compra que Klarna no aprueba deja el pedido sin estado, y el cliente permanece en el paso Confirm Order. Cada campo de abajo muestra tus estados de pedido de OpenCart.

Order Status After Payment: Klarna aceptó la compra (estado de fraude ACCEPTED). El importe se autoriza y se captura según Capture. Predeterminado: Procesando.

Awaiting Fraud Review Status: Klarna registró el pedido como PENDING (revisión antifraude). No lo envíes hasta que la notificación de Klarna lo acepte; el pedido se actualiza automáticamente. Predeterminado: Pendiente de pago.

On Hold Status: Klarna devolvió un estado de fraude inesperado, o el importe o la moneda que informó Klarna no coinciden con el pedido. Una nota explica qué revisar. Predeterminado: Pendiente de pago.

Payment Error Status: Klarna rechazó o detuvo la compra después de la revisión antifraude. No envíes el pedido. Predeterminado: Fallido.

Canceled Status: cambiar un pedido no capturado a este estado cancela el pedido de Klarna (consulta Cancellation). Klarna también lo establece cuando informa de que el pedido de Klarna está cancelado, caducado o cerrado. Predeterminado: Cancelado.

Refunded Status: el importe capturado se reembolsó por completo desde la pestaña VibeFox Klarna Payments de la página del pedido. Los reembolsos parciales solo añaden una nota. Predeterminado: Reembolsado.

OpenCart no tiene estados propios para una revisión antifraude o un pago retenido. Puedes crearlos en System > Localisation > Order Statuses y seleccionarlos aquí.

Notificaciones

Klarna informa del resultado de una revisión antifraude (pedidos registrados como pendientes) a la dirección indicada en Notification URL. En OpenCart 3 tiene este aspecto: https://your-store/index.php?route=extension/payment/wcp_klarna_payment/notification; en OpenCart 4, https://your-store/index.php?route=extension/wcp_klarna_payment/payment/wcp_klarna_payment.notification. La URL se envía automáticamente con cada pedido, así que no hay nada que configurar en Klarna. El contenido de la notificación nunca se da por válido: cada notificación se verifica con la Klarna Order Management API, con las credenciales del entorno y la región en los que se realizó el pedido, y el pedido de Klarna debe hacer referencia a este número de pedido. La extensión actúa según lo que informa Klarna:

ACCEPTED: Klarna aceptó la compra. El pedido pasa a Order Status After Payment después de comprobar el importe y la moneda.
REJECTED or STOPPED: la compra no superó la revisión antifraude. El pedido pasa a Payment Error Status.
Klarna order CANCELLED, EXPIRED or CLOSED: no se cobró al cliente. El pedido pasa a Canceled Status.

Si Klarna acepta una compra después de que hayas cancelado o reembolsado el pedido, el pedido no se reabre y la autorización de Klarna se libera. La notificación funciona mientras la tienda está en modo mantenimiento: OpenCart 3 deja pasar las solicitudes de las extensiones de pago, y en OpenCart 4 la extensión añade una acción de inicio que deja pasar la notificación y el regreso del cliente desde Klarna.

Avanzado

Debug log: registra las llamadas a la API y los eventos de pago en wc_kl_debug.log.php, en la carpeta de registros de OpenCart (storage/logs). El archivo no se puede abrir desde la web. Los errores siempre se registran. El registro nunca contiene credenciales, tokens de autorización ni datos de clientes. Predeterminado: desactivado.

Log: muestra el tamaño y las últimas entradas del registro. Haz clic en Clear log para vaciarlo.

Delete data on uninstall: si está activado, al desinstalar la extensión se eliminan los ajustes de la pasarela, el registro y las sesiones temporales del widget. Los datos de pedidos (ID de pedidos de Klarna, reembolsos) siempre se conservan. Predeterminado: desactivado.

Importar / Exportar

Export: Download JSON guarda los ajustes en un archivo JSON. Las contraseñas no se exportan.

Import: pega un JSON exportado previamente y haz clic en Import para restaurar los ajustes. Las contraseñas guardadas se conservan.

Finalización de compra

En el paso Payment Method, el cliente elige el método de pago (por defecto, Klarna). OpenCart crea el pedido en el paso Confirm Order, todavía sin estado. En este paso, el cliente ve la insignia de Klarna, tu descripción y el widget de Klarna. La extensión crea la sesión de Klarna en el servidor a partir de ese pedido: productos con sus opciones, certificados de regalo, envío, descuentos con cupón, vale y puntos de recompensa, impuestos y direcciones. En el widget, el cliente elige pagar ahora, pagar más tarde o pagar a plazos, según lo que ofrezca Klarna. Cuando el cliente hace clic en Confirm Order, Klarna autoriza la compra en el widget y la extensión registra el pedido de Klarna en el servidor con los datos del pedido de OpenCart. El pedido de Klarna incluye el número de pedido de OpenCart como referencia del comerciante.

En OpenCart 4, el cliente elige el método de pago con el botón Choose del bloque del método de pago, en la ventana Payment method options. El widget de Klarna aparece entonces en el bloque de confirmación del pedido al final de la finalización de compra, encima del botón Confirm Order. OpenCart 4 no tiene certificados de regalo, así que no se envía ninguno a Klarna. De forma predeterminada, OpenCart 4 no pide una dirección de pago; en ese caso, la extensión usa la dirección de envío como dirección de facturación y su país como país de compra.

El resultado depende del estado de fraude de Klarna:

ACCEPTED: el pedido recibe Order Status After Payment de la forma habitual de OpenCart, con los correos electrónicos de pedido habituales y la actualización del stock, y el cliente ve la página de éxito del pedido de OpenCart. El importe se autoriza y se captura según Capture.
PENDING: el pedido recibe Awaiting Fraud Review Status hasta que llegue la notificación de Klarna. No lo envíes antes.
REJECTED: el pedido se queda sin estado y recibe una nota. El cliente permanece en el paso Confirm Order con el mensaje Klarna could not approve this purchase. Please choose another payment method.
Other fraud status: el pedido recibe On Hold Status con una nota.

Si Klarna no puede aceptar el pedido, el cliente permanece en el paso Confirm Order con un mensaje breve, por ejemplo Klarna could not accept this order. Please check your billing details or choose another payment method., Klarna did not respond. Please try again in a moment. o, si la autorización ha caducado, una petición para hacer clic de nuevo en "Confirm Order". Los detalles se escriben en el registro y el pedido recibe una nota. Si el país y la moneda del cliente no coinciden con un mercado de Klarna de tu región, el cliente ve Klarna is not available for your billing country and currency. Please choose another payment method.

Hacer clic dos veces, recargar la página o pagar el mismo carrito en una segunda pestaña del navegador nunca crea un segundo pedido de Klarna (OpenCart 3 crea un pedido nuevo cada vez que se muestra el paso Confirm Order; OpenCart 4 actualiza el pedido de la compra, así que, tras una compra rechazada, el cliente paga el mismo pedido). Si Klarna aprobó la compra pero no se pudo establecer el estado del pedido, el cliente ve Your Klarna purchase was approved, but the order could not be completed automatically. Please contact us — do not pay again. El siguiente intento o la notificación de Klarna establecen el estado a partir del pedido de Klarna guardado, sin una nueva autorización. Un cambio en el carrito, incluida una nueva cantidad, cuenta como un carrito nuevo que necesita su propio pago.

OpenCart 4 mantiene el pedido en la finalización de compra hasta que se muestra la página de éxito. Si ese pedido se ha cerrado sin pago mientras tanto (por ejemplo, lo has cancelado), el cliente vuelve a la finalización de compra con Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. Si el pedido ya está realizado y el carrito ha cambiado, el mensaje es Your previous order #(number) has already been placed. Your cart has changed: please confirm the new order to pay for it. En ambos casos, el siguiente Confirm Order paga un nuevo pedido del carrito. Estos mensajes se muestran encima de la página de finalización de compra.

La extensión no incluye Klarna Checkout (KCO, que sustituye por completo la finalización de compra), los botones Klarna Express Checkout, On-site messaging ni Sign in with Klarna, tampoco suscripciones ni métodos de pago guardados, ni capturas parciales por línea de pedido. Las líneas del pedido no se vuelven a enviar a Klarna cuando editas un pedido después de realizado.

Pedidos y reembolsos

Estados del pedido

No status (missing order): el cliente no ha completado la autorización de Klarna, o Klarna rechazó la compra. En Sales > Orders, estos pedidos solo se muestran con el filtro Order Status establecido en Missing Orders.

Order Status After Payment (default Processing): Klarna aceptó la compra. Una nota muestra el ID del pedido de Klarna y cuándo se capturará.

Awaiting Fraud Review Status (default Pending): la compra está pendiente de la revisión antifraude de Klarna. La notificación de Klarna mueve el pedido a Order Status After Payment, Payment Error Status o Canceled Status.

On Hold Status (default Pending): Klarna devolvió un estado de fraude inesperado, o el importe o la moneda que informó Klarna no coinciden con el pedido. La nota lo explica. Revisa el pedido en el Klarna Merchant Portal.

Payment Error Status (default Failed): Klarna rechazó o detuvo la compra después de la revisión antifraude. No envíes el pedido.

Canceled Status (default Canceled): tú cancelaste el pedido, o Klarna informa de que el pedido de Klarna está cancelado, caducado o cerrado. Con Cancellation activado, cancelar un pedido aún no capturado cancela el pedido de Klarna y libera la autorización, de modo que el cliente no se cobra. Un pedido que ya está capturado no se cancela en Klarna: reembólsalo para devolver el dinero.

Refunded Status (default Refunded): el importe capturado se reembolsó por completo a través de la extensión.

Las notas son entradas del History del pedido que el cliente no ve. Empiezan con la palabra Klarna.

Capture

Con When the order is shipped / completed, al cambiar el estado de un pedido en Sales > Orders (Add History) a un estado completado, se captura el total del pedido antes de guardar el nuevo estado. Si Klarna rechaza la captura, por ejemplo porque el total del pedido superó el importe que aún está autorizado tras editar el pedido, el estado no cambia, no se envía ningún correo y la página del pedido muestra el motivo en lugar del mensaje de éxito. Una nota indica que el cliente NO ha sido cobrado. Corrige el problema y cambia el estado de nuevo para reintentar, o captura en el Klarna Merchant Portal y cambia Capture a manual. Una captura correcta añade una nota con el importe capturado y el ID de la captura. El primer estado de un pedido nuevo y un cambio de un estado completado a otro estado completado no capturan nada. Las capturas y las cancelaciones siguen funcionando mientras la extensión esté instalada pero desactivada. En OpenCart 4.1, el cambio de estado rechazado muestra también el motivo en la página del pedido; en OpenCart 4.0.x el estado también se rechaza, pero el motivo solo aparece en la nota del historial del pedido.

Pestaña VibeFox Klarna Payments

En Sales > Orders, abre un pedido pagado con Klarna. En la parte inferior de la página del pedido, junto a History y Additional, la pestaña VibeFox Klarna Payments muestra el ID del pedido de Klarna con su entorno y región, una etiqueta Playground para los pedidos de prueba, el estado de fraude y el estado de Klarna, el importe Authorized, los importes Captured / refunded, el formulario de reembolso, el historial de reembolsos y las Klarna notes del pedido. La pestaña se muestra a los usuarios que tienen acceso a la extensión.

Reembolsos

En la pestaña VibeFox Klarna Payments, introduce el Amount (se rellena el importe que aún no se ha reembolsado), opcionalmente un Reason (optional), y haz clic en Refund via Klarna. Confirma la pregunta Refund this amount through Klarna? This cannot be undone. Se admiten reembolsos totales y parciales de importes capturados, hasta lo que Klarna informe como capturado menos lo ya reembolsado. Necesitas el permiso para modificar la extensión (se configura en System > Users > User Groups). El reembolso se envía al entorno y a la región en los que se realizó el pedido, así que deben estar configuradas las credenciales de ese entorno. Si Klarna no acepta el reembolso, la pestaña muestra el error y no se registra ningún reembolso. Un reembolso correcto se añade al historial de reembolsos y a las notas con el ID del reembolso de Klarna. Un reembolso total establece el pedido en Refunded Status sin notificar al cliente y sin devolver productos al stock, igual que un cambio manual de estado. Un reembolso parcial no cambia el estado. Un reembolso que se reintenta nunca se hace dos veces.

Un pedido que aún no se ha capturado no se puede reembolsar: en su lugar, cancélalo para liberar la autorización. Con Capture en manual, la tienda no sabe qué has capturado en el Klarna Merchant Portal. En ese caso, el formulario de reembolso se muestra con el importe vacío, y Klarna comprueba el importe cuando lo envías.

Las devoluciones de productos en Sales > Returns no devuelven dinero a través de Klarna. Los reembolsos realizados en el Klarna Merchant Portal no se añaden a la pestaña, pero sí cuentan para el importe que Klarna todavía permite reembolsar.

Clave de licencia

La extensión funciona con una clave de licencia de VibeFox obtenida en vibefox.net. El bloque de licencia License — VibeFox Klarna Payments es el primer bloque de Extensions > Extensions > Payments > VibeFox Klarna Payments > Edit, por encima de los ajustes. Pega la clave en License key y haz clic en Activate. Después, el bloque muestra la clave enmascarada, el estado (por ejemplo, la fecha hasta la que la licencia está activa y tu dominio) y los botones Check now para volver a comprobar el estado, Change key para introducir otra clave y Remove key para eliminar la clave de esta tienda. Debajo aparecen la línea Product: opencart-payment-klarna y el enlace Manage licenses and domains in your account, que abre tu cuenta de vibefox.net. Solo los usuarios administradores con el permiso Modify para la extensión pueden cambiar la clave. Los textos del bloque siguen el idioma del panel de administración (se incluyen inglés y ruso).

Si la clave no se acepta, el bloque indica el motivo, por ejemplo Key not found, This key belongs to another product, Domain limit reached o License expired on seguido de una fecha. Después de cambiar la dirección de la tienda, o después de liberar una plaza de dominio en tu cuenta, haz clic en Check now. Si no se puede acceder al servidor de licencias, la extensión sigue funcionando con el último estado conocido.

Una clave funciona en un dominio: la dirección de la tienda de la configuración de OpenCart. Eliminar la clave de la tienda no libera su plaza de dominio. Libérala en tu cuenta de vibefox.net.

Sin una clave activa, Klarna no se muestra a los clientes en la finalización de compra. Si un pago se inicia de todos modos, el cliente ve This payment method is not available. Please choose another one. Un usuario administrador que haya iniciado sesión en el panel en el mismo navegador sigue viendo el método de pago en la tienda, marcado como (unlicensed — visible to admins only), para que puedas configurar y probar la extensión antes de comprar una clave. En OpenCart 4 esta vista previa no está disponible: la tienda no ve el inicio de sesión del administrador, así que, sin una clave activa, el método de pago se oculta para todos. Después de abrir la página Edit una vez, aparece un recordatorio en el Dashboard del panel. Ciérralo con × para ocultarlo durante 7 días. Los pedidos existentes no se ven afectados: las notificaciones de Klarna se siguen procesando, y los pedidos se pueden seguir capturando, cancelando y reembolsando.

Cuando una licencia caduca, la extensión sigue funcionando, pero las actualizaciones y el soporte requieren una renovación. El estado se vuelve a comprobar automáticamente al abrir el Dashboard o la página Edit del panel: una vez al día durante los primeros 14 días después de introducir la clave, y después una vez a la semana. No hace falta ningún cron job. Desinstalar la extensión siempre elimina la clave de licencia y el estado de la licencia.

Solución de problemas

Klarna no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable/Disable está activado y que las credenciales del modo activo están rellenadas: nombre de usuario y contraseña de prueba en modo de prueba, y los de producción en modo real. La página de ajustes muestra un aviso cuando faltan. El país de pago del cliente debe ser un país de Klarna de tu API region, con pago en la moneda de ese país (por ejemplo, un cliente de Suecia debe pagar en SEK). Comprueba también que la dirección de pago esté en la Geo Zone seleccionada y que el pedido alcance el Total configurado en los ajustes.

El pago se realizó, pero el pedido sigue en Awaiting Fraud Review Status: la compra está pendiente de la revisión antifraude de Klarna, y el pedido se actualiza cuando llega la notificación de Klarna. Comprueba que tu tienda puede recibir solicitudes de Klarna en la Notification URL que aparece en los ajustes, y que las credenciales del entorno en el que se realizó el pedido siguen introducidas. Activa Debug log y consulta el campo Log de la página de la extensión.

La notificación responde Not configured: faltan las credenciales del entorno (prueba o real) en el que se realizó el pedido, así que la notificación no se puede verificar. Introdúcelas. Klarna volverá a intentar la notificación.

La notificación responde Verification failed: no se pudo leer el pedido de Klarna desde la Order Management API. Klarna volverá a intentar la notificación.

La notificación responde Busy: otra solicitud estaba actualizando el pedido en ese mismo momento. Klarna volverá a intentar la notificación.

La notificación responde mismatch_ref o Unknown order: el pedido de Klarna no hace referencia a este pedido, o la extensión no lo conoce. El pedido no se modifica.

El widget no se carga: el cliente ve Klarna could not be loaded. Please try again or choose another payment method. o Klarna is not available for this purchase. Comprueba las credenciales del modo activo y el país y la moneda del cliente.

El cambio de estado a Complete o Shipped se rechaza: la captura de Klarna falló. Lee el motivo en la página del pedido o en la nota. El total del pedido puede necesitar más de lo que aún está autorizado, el pedido de Klarna puede no estar aceptado todavía, o la autorización puede haber caducado. Corrígelo y vuelve a cambiar el estado, o captura en el Klarna Merchant Portal.

El reembolso falla: lee el mensaje de la pestaña. Es posible que el pedido aún no esté capturado (cancélalo en su lugar), que el importe supere lo que aún se puede reembolsar, o que falten las credenciales del entorno del pedido.

No hay formulario de reembolso en la pestaña: la pestaña indica el motivo: todavía no hay nada capturado, el importe capturado está reembolsado por completo, o tu grupo de usuarios no tiene permiso para modificar la extensión.

El cliente ve This order is already being paid: hay otra solicitud en curso para la misma compra, por ejemplo por un doble clic. Espera un momento y comprueba si el pedido ha recibido algún estado.

Desinstalación

Ve a Extensions > Extensions, elige el tipo Payments y haz clic en Uninstall (el botón rojo −) junto a VibeFox Klarna Payments. La clave de licencia y el estado de la licencia de esta extensión siempre se eliminan. OpenCart siempre elimina sus propios ajustes de la extensión: Enable/Disable, Sort Order, Geo Zone, Total y los estados de pedido de la sección Order statuses, que vuelven a sus valores predeterminados al reinstalar. Los eventos de OpenCart de la extensión también se eliminan, así que los cambios de estado ya no capturan ni cancelan pedidos de Klarna (en OpenCart 4, también su acción de inicio, que deja pasar la notificación y el regreso del cliente en modo de mantenimiento). Si Delete data on uninstall está activado, se eliminan los demás ajustes de la pasarela (título, descripción, modo de prueba, región de API, credenciales, captura, cancelación, registro), el registro y las sesiones temporales del widget. Si está desactivado, se conservan para una reinstalación posterior. Los pedidos y reembolsos de Klarna siempre se conservan, así que los pedidos realizados antes se pueden seguir capturando y reembolsando después de reinstalar. Los pedidos existentes conservan sus notas de pago.

En OpenCart 4, para eliminar también los archivos de la extensión, ve a Extensions > Installer después de la desinstalación y haz clic en Uninstall (el botón naranja −) junto a VibeFox Klarna Payments en la lista de extensiones instaladas; después, haz clic en Delete (el botón rojo de papelera) para eliminar el paquete subido.

Klarna es una marca comercial de su titular. Esta extensión no está afiliada a Klarna ni cuenta con su respaldo.