Skip to content

Plugin WordPress WooCommerce

Descripción

MetrePay ofrece un plugin para WordPress WooCommerce que permite integrar los medios de pago de MetrePay directamente en la tienda en línea del comercio. El plugin gestiona la generación de links de pago y la comunicación con la plataforma de MetrePay.

Versión Actual

La última versión disponible es la 1.4.0, accesible en wordpress.org/plugins/metrepay.

Consideraciones

  • El plugin es compatible con el checkout clásico de WooCommerce. No es compatible con el checkout por bloques. La página de checkout debe configurarse manualmente para utilizar el checkout clásico.
  • El plugin puede conectar una sola instancia de MetrePay por sitio e-commerce. Si el comercio tiene configuraciones en portal.metrepay.com y en internacional.metrepay.com, solo podrá utilizar una a la vez.

Instalación

  1. Acceder al panel de configuración de WordPress.
  2. En la barra lateral, acceder a Plugins.
  3. Seleccionar Añadir nuevo.
  4. Buscar "MetrePay" en la barra de búsqueda.
  5. Hacer clic en Instalar ahora en el plugin de MetrePay.
  6. Aguardar la finalización de la descarga e instalación.
  7. Verificar que el plugin aparezca en Plugins instalados.

Configuración

  1. Acceder al panel de WordPress.
  2. En la barra lateral, acceder a WooCommerce > Ajustes.
  3. Seleccionar la pestaña Medios de pago.
  4. Localizar MetrePay en el listado.
  5. Acceder a la configuración del medio de pago.

Parámetros de Configuración

Parámetro Descripción
Título Nombre del medio de pago. Se recomienda "MetrePay".
URL MetrePay Instancia del comercio (ej: portal.metrepay.com). Solo el dominio, sin protocolo.
Token API Key Token proporcionado por MetrePay.
Slug de comercio Identificador del comercio proporcionado por MetrePay.
Moneda del sitio Si se activa, el plugin utiliza la moneda configurada en el sitio WooCommerce. Si se desactiva, se utiliza la moneda por defecto de la instancia MetrePay.
Débito automático Habilita la opción de suscripciones para productos pagados con MetrePay.
Links con login requerido Define si los links de pago requieren login del cliente. El login es obligatorio para débitos automáticos.
Identificador personalizado #1 Si está vacío, se solicita CI/RUC al cliente durante el checkout. Si tiene un valor, se utiliza como identificador constante para todos los links.
Identificador personalizado #2 Si se activa, captura el número de orden (order ID) como identificador adicional.

Instancias MetrePay

URL Descripción
test.metrepay.com Ambiente de pruebas para pagos nacionales (PY). Solo guaraníes (PYG).
portal.metrepay.com Ambiente productivo para pagos nacionales (PY). Solo guaraníes (PYG).
intl-test.metrepay.com Ambiente de pruebas para pagos internacionales. USD y EUR.
internacional.metrepay.com Ambiente productivo para pagos internacionales. USD y EUR.

Condiciones para Débito Automático

Para que el plugin genere un link de pago con débito automático, se deben cumplir las siguientes condiciones:

  1. El producto debe ser de tipo variable.
  2. El producto debe tener un atributo llamado "cuotas".
  3. El valor del atributo debe contener las opciones de cantidad de cuotas separadas por pipes (ej: 2|3|6|12).
  4. El carrito del cliente debe contener un solo producto. Si tiene más de un producto, solo se habilita el pago único.

Uso

Desde el punto de vista del cliente

  1. Accede a la tienda del comercio.
  2. Selecciona productos y los agrega al carrito.
  3. Procede al checkout.
  4. Selecciona MetrePay como medio de pago (único o recurrente).
  5. Hace clic en el botón de pago.
  6. Es redirigido a la página de pago de MetrePay.
  7. Realiza login, selecciona o registra una tarjeta, y completa el pago.

Desde el punto de vista del comercio

  1. Visualiza los links de pago generados en el portal de MetrePay.
  2. Verifica los estados de los pagos para contrastar con WooCommerce.

Notas

  • Si se desactiva el login requerido, se solicita CI/RUC al cliente durante el checkout.
  • Los identificadores personalizados deben estar previamente activados y configurados en la plataforma MetrePay.