VibeFox Klarna for WooCommerce — Ayuda

Requisitos

WordPress: 6.0 o posterior.

WooCommerce: 7.0 o posterior, instalado y activo. Sin WooCommerce el plugin no se activa.

PHP: 8.0 o posterior.

HTTPS: Klarna requiere HTTPS para los pagos reales.

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 de pruebas de Klarna (véase 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 de la tienda: 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.

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

Instalación

1. En WordPress ve a Plugins > Add New > Upload Plugin, elige el archivo ZIP del plugin y haz clic en Install Now. También puedes subir la carpeta wcp_klarna_payment a /wp-content/plugins/ por FTP.

2. Haz clic en Activate.

3. Abre los ajustes: WooCommerce > Settings > Payments > Klarna Payments > Manage, o haz clic en Settings debajo del nombre del plugin en la página de Extensiones.

4. Introduce tu clave de licencia de VibeFox en el bloque de licencia de la parte superior de la página y haz clic en Activate.

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

6. Introduce el nombre de usuario y la contraseña de prueba del portal de pruebas de Klarna, deja activado Test mode, activa Enable/Disable y haz un pedido de prueba.

7. Introduce el nombre de usuario y la contraseña reales del Klarna Merchant Portal, desmarca Test mode y elige cuándo se capturan los pedidos (por defecto: cuando el pedido se marca como Completado).

Configuración

Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > Klarna Payments. Junto al título de la página aparece una insignia con TEST MODE o LIVE. La página te avisa cuando falta el nombre de usuario o la contraseña del modo activo (en ese caso Klarna no se muestra en la finalización de compra) y cuando la moneda de la tienda no la vende Klarna en la región de API seleccionada. En la lista de métodos de pago, Klarna aparece marcada como pendiente de configuración hasta que se introducen las credenciales del modo activo, y muestra una insignia de modo de prueba mientras el modo de prueba esté activado.

General

Enable/Disable: Enable Klarna Payments activa o desactiva el método de pago. Por defecto: desactivado.

Title: el nombre del método de pago que ve el cliente en la finalización de compra. Por defecto: Klarna.

Description: el texto que ve el cliente encima del widget de Klarna. Por defecto: Pay now, later or in instalments with Klarna.

Credenciales de API

Las credenciales de API de Klarna (nombre de usuario y contraseña) se crean en el Klarna Merchant Portal (portal.klarna.com) en Settings > Klarna API credentials. Las credenciales de prueba se obtienen en el portal de pruebas: playground.eu.portal.klarna.com para Europa, playground.us.portal.klarna.com para Norteamérica y Oceanía.

Test mode: Use the Klarna playground (test credentials, no real payments). Por defecto: activado. Mientras el modo de prueba esté activado, la finalización de compra muestra TEST MODE: Klarna playground, no real payment is made. Los pedidos conservan el entorno en el que se crearon: las capturas y los reembolsos de pedidos de prueba 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.

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). Por defecto.

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 del entorno de pruebas.

Test password: la contraseña de la API del entorno de pruebas (secreto compartido).

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 sin capturar caducan, normalmente a los 28 días, así que completa (envía) los pedidos a tiempo o usa la captura automática.

Capture: cuándo se cobra al cliente. Los reembolsos solo son posibles por importes capturados. Si una captura falla, el pedido pasa a En espera con una nota.

When the order is Completed (recommended): captura al enviar marcando el pedido como Completado (por defecto). El importe capturado es el total del pedido menos lo que ya se había capturado, y nunca más que el importe aún autorizado.

Immediately (auto capture): cobra al cliente de inmediato, para bienes digitales o servicios.

Manually in the Klarna portal: el plugin no captura. Captura el pedido en el Klarna Merchant Portal.

Cancellation: Cancel the Klarna order (release the authorization) when a not yet captured order is Cancelled. Por defecto: activado.

Notificaciones

Klarna informa del resultado de una revisión de fraude (pedidos registrados como "pending") a la URL de notificación que se muestra en esta sección. Tiene este aspecto: https://your-site/wc-api/wc_kl_payment/. 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 considera fiable: cada notificación se verifica con la Order Management API de Klarna, y el pedido de Klarna debe referirse a este pedido de la tienda. El plugin actúa según lo que informa Klarna:

ACCEPTED: Klarna aceptó la compra. El pedido se marca como pagado tras comprobar el importe y la moneda.

REJECTED or STOPPED: la compra no superó la revisión de fraude. El pedido pasa a Fallido.

Klarna order CANCELLED, EXPIRED or CLOSED: el cliente no fue cobrado. El pedido se cancela.

Si Klarna acepta una compra después de que cancelaste o reembolsaste el pedido, el pedido no se reabre y la autorización de Klarna se libera.

Avanzado

Debug log: Log API calls and payment events en WooCommerce > Status > Logs, origen wcp_klarna_payment. Los errores siempre se registran. Los registros nunca contienen credenciales ni datos de clientes. Por defecto: desactivado.

Uninstall: Delete the plugin settings and logs when the plugin is deleted. Los datos de pedidos (los ID de pedido de Klarna) siempre se conservan. Por defecto: desactivado.

Finalización de compra

El cliente elige el método de pago (por defecto Klarna) y el widget de Klarna se carga dentro de la finalización de compra. Ahí el cliente elige pagar ahora, pagar después o a plazos, según lo que ofrezca Klarna. Cuando el cliente hace clic en "Realizar pedido", Klarna autoriza la compra en el widget. En el bloque de Finalizar compra, la sesión de Klarna se actualiza primero con el carrito final, así que los cambios posteriores en el envío o en los totales no hacen que Klarna rechace el pedido. Después, el plugin crea el pedido de Klarna desde el servidor con las líneas, los totales y las direcciones del pedido de WooCommerce.

El resultado depende del estado de fraude de Klarna:

ACCEPTED: el pedido se marca como pagado de inmediato y el cliente pasa a la página de pedido recibido. El importe queda autorizado y se captura según Capture.

PENDING: el pedido queda en espera hasta que llegue la notificación de Klarna. No lo envíes antes.

REJECTED: el pedido pasa a Fallido y el cliente ve Klarna could not approve this purchase. Please choose another payment method.

Si Klarna no puede aceptar el pedido, el cliente ve 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, cuando la autorización ha caducado, una petición para volver a hacer clic en "Realizar pedido". Los detalles se añaden a las notas del pedido y al registro. Si el país de facturación 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.

El método de pago funciona en la finalización de compra clásica, en el bloque de Finalizar compra y en la página Pay for order. Es compatible con el almacenamiento de pedidos de alto rendimiento de WooCommerce (HPOS).

El plugin no incluye Klarna Checkout (KCO, sustitución completa de la finalización de compra), botones de Klarna Express Checkout, On-site messaging ni Sign in with Klarna, ni suscripciones ni métodos de pago guardados, y tampoco 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 crearlo.

Pedidos y reembolsos

Estados del pedido

Processing or Completed: Klarna aceptó la compra. WooCommerce asigna el estado habitual de un pedido pagado. La nota del pedido muestra el ID del pedido de Klarna y cuándo se capturará. El ID de transacción es el ID del pedido de Klarna. Cuando el pedido se captura, una nota muestra el importe capturado y el ID de la captura.

On hold: la compra está pendiente de la revisión de fraude, Klarna devolvió un estado de fraude inesperado, el importe o la moneda que informó Klarna no coincidían con el pedido, o una captura falló. Las notas del pedido indican cuál.

Failed: Klarna rechazó la compra o la detuvo tras la revisión de fraude. No envíes el pedido.

Cancelled: cancelaste el pedido, o Klarna informa de que el pedido de Klarna está cancelado, caducado o cerrado. Con Cancellation activado, al cancelar un pedido aún no capturado se cancela el pedido de Klarna y se libera la autorización, así que el cliente no es cobrado. Un pedido ya capturado no se cancela en Klarna: reembolsa el pedido para devolver el dinero.

Captura

Con When the order is Completed, al marcar el pedido como Completado se captura el total del pedido. Si la captura falla, por ejemplo porque el total del pedido superó el importe autorizado tras editarlo, el pedido pasa a En espera con una nota que indica que el cliente NO ha sido cobrado, y el cliente no recibe el correo de "Pedido completado". Corrige el problema y vuelve a marcar el pedido como Completado para reintentarlo, o captura en el Klarna Merchant Portal.

Reembolsos

Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via Klarna Payments. Se admiten reembolsos totales y parciales de importes capturados, hasta el importe capturado menos lo que ya se reembolsó. El reembolso se envía al entorno y a la región en los que se creó el pedido, así que deben estar configuradas las credenciales de ese entorno. Si Klarna no acepta el reembolso, WooCommerce muestra el error y no se registra ningún reembolso. Un reembolso correcto se añade a las notas del pedido con el ID del reembolso de Klarna. Un reembolso reintentado nunca se hace dos veces.

Un pedido que aún no se ha capturado no se puede reembolsar: cancélalo para liberar la autorización. Los reembolsos hechos en el Klarna Merchant Portal no se sincronizan de vuelta con WooCommerce.

Clave de licencia

El plugin funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia está en la parte superior de WooCommerce > Settings > Payments > Klarna Payments. Pega la clave en License key y haz clic en Activate. El bloque muestra el estado, por ejemplo la fecha hasta la que la licencia está activa y tu dominio. Usa Check now para volver a comprobar el estado, Change key para introducir otra clave y Remove key para quitarla de este sitio. El enlace Manage licenses and domains in your account abre tu cuenta de vibefox.net.

Una clave funciona en un dominio. Quitar la clave de un sitio no libera su plaza de dominio. Libera la plaza en tu cuenta de vibefox.net.

Sin una clave activa, Klarna no se muestra a los clientes en la finalización de compra. Si se inicia un pago igualmente, el cliente ve This payment method is not available. Please choose another one. Los gestores de la tienda que han iniciado sesión siguen viendo el método de pago, marcado como (unlicensed — visible to admins only), para que puedas configurar y probar el plugin antes de comprar una clave. En la página de Extensiones y en las páginas de WooCommerce aparece un recordatorio. Los pedidos existentes no se ven afectados: las notificaciones se siguen procesando, y las capturas, cancelaciones y reembolsos siguen funcionando.

Cuando una licencia caduca, el plugin sigue funcionando, pero las actualizaciones y el soporte necesitan una renovación. El estado se vuelve a comprobar automáticamente en segundo plano.

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 rellenas: nombre de usuario y contraseña de prueba en modo de prueba, y los reales en modo de producción. El país de facturación del cliente debe ser un país de Klarna de tu API region y pagar en la moneda de ese país (por ejemplo, un cliente de Suecia debe pagar en SEK).

El pago se completó, pero el pedido sigue On hold: la compra está pendiente de la revisión de fraude de Klarna, y el pedido se actualiza cuando llega la notificación de Klarna. Comprueba que tu sitio pueda recibir peticiones de Klarna en la URL de notificación que se muestra en los ajustes, y que las credenciales del entorno en el que se creó el pedido sigan introducidas. Revisa WooCommerce > Status > Logs, origen wcp_klarna_payment.

La notificación responde Not configured: faltan las credenciales del entorno (prueba o producción) en el que se creó el pedido, así que la notificación no se puede verificar. Introdúcelas.

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

La notificación responde mismatch_ref: el pedido de Klarna no se refiere a este pedido de la tienda. 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.

Error de captura, pedido On hold: lee la nota del pedido. El total del pedido puede necesitar más de lo que sigue autorizado, el pedido de Klarna puede que aún no esté aceptado o la autorización puede haber caducado. Corrígelo y vuelve a marcar el pedido como Completado, o captura en el Klarna Merchant Portal.

Error en el reembolso: lee el mensaje. Puede 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.

El bloque de licencia muestra un error: sigue el mensaje del bloque. Por ejemplo, si la clave ya se usa en otro dominio, libera una plaza en tu cuenta de vibefox.net y haz clic en Check now. Si cambió la dirección del sitio, haz clic en Check now para activar la clave en el nuevo dominio. Si no se puede acceder al servidor de licencias, el plugin sigue funcionando con el último estado conocido.

Desinstalación

Desactivar el plugin conserva todos los datos. Para eliminarlo, desactívalo y bórralo en la página de Plugins. La clave de licencia y el estado de licencia de este plugin siempre se eliminan. Los ajustes de la pasarela y los registros (origen wcp_klarna_payment) solo se eliminan si Uninstall (Delete the plugin settings and logs when the plugin is deleted) estaba activado. Si no, se conservan para una reinstalación posterior. Los pedidos existentes conservan sus notas de pago y sus ID de transacción.

Klarna es una marca comercial de su respectivo titular. Este plugin no está afiliado a Klarna ni cuenta con su respaldo.