DocsShopware
Integra Cost+ con tu tienda Shopware 6 usando el plugin oficial de pago
Integra Cost+ como metodo de pago en tu tienda Shopware 6. El plugin oficial NoPayn Payment soporta multiples metodos de pago por canal de ventas y utiliza el flujo de pagina de pago alojada — totalmente compatible con PCI DSS.
Requisitos previos
- Cuenta de comerciante Cost+ activa
- Shopware 6.7 o posterior
- PHP 8.2 o posterior
- Acceso SSH o terminal a tu servidor Shopware
Metodos de pago soportados
| Nombre en checkout | Nombre tecnico | Identificador NoPayn |
|---|---|---|
| Credit / Debit Card | nopayn_credit_card | credit-card |
| Apple Pay | nopayn_apple_pay | apple-pay |
| Google Pay | nopayn_google_pay | google-pay |
| Vipps MobilePay | nopayn_vipps_mobilepay | vipps-mobilepay |
Cada metodo puede habilitarse o deshabilitarse por canal de ventas desde la configuracion del plugin.
1. Instalar el plugin
Clona o copia el plugin en tu directorio custom/plugins/ de Shopware:
cd /path/to/shopware/custom/plugins
git clone git@github.com:NoPayn/shopware.git NoPaynPaymentLuego instala y activa mediante el CLI de Shopware:
bin/console plugin:refresh
bin/console plugin:install NoPaynPayment --activate
bin/console cache:clear2. Configurar el plugin
- En tu admin de Shopware, ve a Settings → Extensions → NoPayn Payment
- Introduce tu API Key del portal de comerciante — navega a Websites, haz clic en el sitio web que deseas conectar, luego haz clic en Integration para encontrar tu clave API
- Activa o desactiva los metodos de pago individuales
- Guarda
Puedes configurar una clave API diferente por canal de ventas si operas multiples escaparates.
Solo activa los metodos de pago para los que hayas sido aprobado y hayas recibido confirmacion.
3. Flujo de pago
- El cliente selecciona un metodo de pago en el checkout y realiza el pedido
- El pedido se crea con estado de transaccion in_progress
- El cliente es redirigido a la pagina de pago alojada de NoPayn
- Despues del pago:
- Exito — el cliente regresa, el estado se verifica via API, la transaccion se establece como paid, el pedido como processing
- Cancelado — el cliente regresa, la transaccion y el pedido se establecen como cancelled
- Expirado (timeout de 5 minutos) — el webhook se activa, la transaccion y el pedido se establecen como cancelled
4. Mapeo de estados del pedido
| Estado NoPayn | Estado de transaccion | Estado del pedido |
|---|---|---|
new | in_progress | open |
processing | in_progress | open |
completed | paid | in_progress |
cancelled | cancelled | cancelled |
expired | cancelled | cancelled |
error | cancelled | cancelled |
5. Webhooks
El plugin registra automaticamente un endpoint de webhook en /api/nopayn/webhook. Esta URL se envia a NoPayn al crear pedidos, proporcionando confirmacion asincrona de estado para todas las transacciones.
No se requiere configuracion manual de webhooks — el plugin gestiona el registro automaticamente.
6. Probar y lanzar
Realiza algunas transacciones de prueba para asegurarte de que todo funciona correctamente. Recomendamos probar tanto pagos exitosos como fallidos para confirmar que todos los escenarios se manejan adecuadamente.
Soporte
Necesitas ayuda? Contacta a nuestro equipo de soporte en support@costplus.io.