Drupal Commerce

Integra Cost+ como metodo de pago en tu tienda Drupal Commerce. El modulo oficial NoPayn Payment Gateway utiliza el flujo de pagina de pago alojada, de modo que ningun dato de tarjeta toca tu servidor — totalmente compatible con PCI DSS.

Requisitos previos

• Cuenta de comerciante Cost+ activa
• Drupal 10 u 11
• Drupal Commerce 3.x
• PHP 8.1 o posterior
• Acceso de administrador a tu sitio Drupal

Metodos de pago soportados

• Credit / Debit Card — Visa, Mastercard y mas
• Apple Pay
• Google Pay
• Vipps / MobilePay

1. Instalar el modulo

Copia el modulo commerce_nopayn en tu instalacion de Drupal y habilitalo:

cp -r commerce_nopayn /path/to/drupal/web/modules/custom/
drush en commerce_nopayn -y
drush cr

2. Agregar una pasarela de pago

1. Navega a Commerce → Configuration → Payment gateways (/admin/commerce/config/payment-gateways)
2. Haz clic en Add payment gateway
3. Selecciona NoPayn Payment Gateway como plugin

3. Configurar la pasarela

Introduce los siguientes ajustes:

• NoPayn API Key — Tu clave API de comerciante del portal de comerciante
• Payment Methods — Habilita o deshabilita Credit Card, Apple Pay, Google Pay, Vipps MobilePay
• Mode — Establece en Test cuando uses una clave API de un sitio web sandbox, o Live cuando uses una clave de sitio web de produccion

Ajustes opcionales

• Manual Capture — Autorizar pagos con tarjeta de credito sin captura inmediata (los fondos se reservan y se capturan cuando se cumple el pedido)
• Debug Logging — Habilitar para registrar todas las solicitudes y respuestas de la API en el log de Drupal para solucion de problemas

Haz clic en Save cuando termines.

4. Flujo de pago

Una vez configurado, el flujo de pago funciona de la siguiente manera:

1. El cliente agrega productos al carrito y procede al checkout
2. En el paso de pago, los metodos de Cost+ habilitados se muestran como botones de radio
3. El cliente selecciona un metodo y confirma el pedido
4. El modulo crea un pedido a traves de la API de Cost+ y redirige a la pagina de pago alojada
5. El cliente completa el pago en la pagina de Cost+
6. El cliente regresa a la tienda — el pago se verifica via API
7. Un webhook de Cost+ confirma de forma asincrona el resultado del pago

5. Configuracion de webhooks

La URL del webhook se genera automaticamente por Drupal Commerce:

https://your-store.com/payment/notify/{gateway_machine_name}

Por ejemplo: https://your-store.com/payment/notify/nopayn

Esta URL debe ser accesible desde internet sin autenticacion. El modulo siempre verifica el estado del pago via la API — nunca confia unicamente en el payload del webhook.

Captura manual

Cuando la captura manual esta habilitada para tarjetas de credito:

1. La tarjeta del cliente es autorizada (fondos reservados) durante el checkout
2. La captura ocurre automaticamente cuando el pedido transiciona a Fulfilled
3. Si el pedido se cancela, la autorizacion se anula via webhook

Reembolsos

Los reembolsos pueden procesarse directamente desde el panel de administracion de Commerce. Se soportan tanto reembolsos totales como parciales.

Tablas de base de datos

El modulo crea dos tablas para seguimiento:

Desinstalacion

drush pmu commerce_nopayn -y
drush cr

Probar y lanzar

Realiza algunas transacciones de prueba para asegurarte de que todo funciona correctamente. Establece el Mode de la pasarela en Test y verifica tanto pagos exitosos como fallidos antes de cambiar a Live.

Soporte

Necesitas ayuda? Contacta a nuestro equipo de soporte en support@costplus.io.