DocsnopCommerce
Integra Cost+ con tu tienda nopCommerce usando el plugin oficial de pago
Integra Cost+ como metodo de pago en tu tienda nopCommerce. El plugin oficial NoPayn Payment Gateway soporta multiples metodos de pago con redireccion directa al metodo de pago seleccionado — totalmente compatible con PCI DSS.
Requisitos previos
- Cuenta de comerciante Cost+ activa
- nopCommerce 4.90 o posterior
- .NET 9
- Acceso de administrador a tu panel de administracion de nopCommerce
- Acceso al codigo fuente de nopCommerce (para la instalacion del plugin)
Metodos de pago soportados
| Nombre en checkout | Identificador NoPayn |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
1. Instalar el plugin
Copia la carpeta del plugin en tu directorio de codigo fuente de nopCommerce:
src/Plugins/Nop.Plugin.Payments.NoPayn/Agrega el proyecto a tu solucion y compila:
dotnet sln add src/Plugins/Nop.Plugin.Payments.NoPayn/Nop.Plugin.Payments.NoPayn.csproj
dotnet buildEn el panel de administracion de nopCommerce:
- Ve a Configuration → Local plugins
- Encuentra NoPayn Payment Gateway y haz clic en Install
- Ve a Configuration → Payment methods
- Activa NoPayn Payment Gateway
- Haz clic en Configure para abrir la configuracion
2. Configurar el plugin
Inicia sesion en el portal de comerciante y navega a Websites, luego haz clic en el sitio web que deseas conectar. Haz clic en Integration donde encontraras tu clave API.
En la configuracion del plugin, introduce tu API Key y activa los metodos de pago que deseas ofrecer:
| Ajuste | Descripcion |
|---|---|
| API Key | Tu clave API de NoPayn |
| Enable Credit / Debit Card | Activar/desactivar pagos con tarjeta de credito/debito |
| Enable Apple Pay | Activar/desactivar pagos con Apple Pay |
| Enable Google Pay | Activar/desactivar pagos con Google Pay |
| Enable Vipps MobilePay | Activar/desactivar pagos con Vipps MobilePay |
Solo activa los metodos de pago para los que hayas sido aprobado y hayas recibido confirmacion.
3. Flujo de pago
- El cliente selecciona NoPayn Payment Gateway en el checkout
- Aparece una seleccion de sub-metodos (Credit Card, Apple Pay, etc.)
- El cliente elige un metodo y confirma el pedido
- El pedido se crea con estado de pago Pending
- El cliente es redirigido directamente al metodo de pago seleccionado en la pagina de pago de NoPayn
- Despues del pago:
- Exito — pedido marcado como Paid / Processing
- Cancelado / Fallido / Expirado — pedido establecido como Cancelled
- NoPayn envia un webhook para confirmacion asincrona de estado
Las transacciones expiran despues de 5 minutos. Si un cliente no completa el pago dentro de este periodo, el pedido se cancela automaticamente via webhook.
4. Mapeo de estados del pedido
| Estado NoPayn | Estado de pago nopCommerce | Estado del pedido nopCommerce |
|---|---|---|
new | Pending | Pending |
processing | Pending | Pending |
completed | Paid | Processing |
cancelled | Voided | Cancelled |
expired | Voided | Cancelled |
error | Voided | Cancelled |
5. Webhooks
El plugin registra un endpoint de webhook en /NoPayn/Webhook. NoPayn envia datos POST que contienen el identificador del pedido cuando cambia el estado. El plugin verifica el estado actual mediante una llamada a la API antes de actualizar el pedido.
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.