DocsnopCommerce
Integre a Cost+ com a sua loja nopCommerce utilizando o plugin oficial de pagamento
Integre a Cost+ como método de pagamento na sua loja nopCommerce. O plugin oficial NoPayn Payment Gateway suporta múltiplos métodos de pagamento com redirecionamento direto para o método de pagamento selecionado — totalmente compatível com PCI DSS.
Pré-requisitos
- Conta de comerciante Cost+ ativa
- nopCommerce 4.90 ou superior
- .NET 9
- Acesso de administrador ao painel de administração nopCommerce
- Acesso ao código fonte do nopCommerce (para instalação do plugin)
Métodos de Pagamento Suportados
| Nome no Checkout | Identificador NoPayn |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
1. Instalar o Plugin
Copie a pasta do plugin para o diretório source do nopCommerce:
src/Plugins/Nop.Plugin.Payments.NoPayn/Adicione o projeto à sua solução e compile:
dotnet sln add src/Plugins/Nop.Plugin.Payments.NoPayn/Nop.Plugin.Payments.NoPayn.csproj
dotnet buildNo painel de administração nopCommerce:
- Vá a Configuration → Local plugins
- Encontre NoPayn Payment Gateway e clique em Install
- Vá a Configuration → Payment methods
- Ative NoPayn Payment Gateway
- Clique em Configure para abrir as definições
2. Configurar o Plugin
Inicie sessão no Portal do Comerciante e navegue até Websites, depois clique no website que pretende conectar. Clique em Integração onde encontrará a sua chave API.
Na configuração do plugin, introduza a sua chave API e ative os métodos de pagamento que pretende oferecer:
| Definição | Descrição |
|---|---|
| API Key | A sua chave API NoPayn |
| Enable Credit / Debit Card | Ativar pagamentos com cartão de crédito/débito |
| Enable Apple Pay | Ativar pagamentos Apple Pay |
| Enable Google Pay | Ativar pagamentos Google Pay |
| Enable Vipps MobilePay | Ativar pagamentos Vipps MobilePay |
Ative apenas os métodos de pagamento para os quais foi aprovado e recebeu confirmação.
3. Fluxo de Pagamento
- O cliente seleciona NoPayn Payment Gateway no checkout
- Aparece uma seleção de sub-método (Credit Card, Apple Pay, etc.)
- O cliente escolhe um método e confirma a encomenda
- A encomenda é criada com estado de pagamento Pending
- O cliente é redirecionado diretamente para o método de pagamento selecionado na página de pagamento NoPayn
- Após o pagamento:
- Sucesso — encomenda marcada como Paid / Processing
- Cancelado / Falhado / Expirado — encomenda definida como Cancelled
- O NoPayn envia um webhook para confirmação assíncrona do estado
As transações expiram após 5 minutos. Se um cliente não completar o pagamento dentro desta janela, a encomenda é automaticamente cancelada via webhook.
4. Mapeamento de Estados da Encomenda
| Estado NoPayn | Estado de Pagamento nopCommerce | Estado da Encomenda nopCommerce |
|---|---|---|
new | Pending | Pending |
processing | Pending | Pending |
completed | Paid | Processing |
cancelled | Voided | Cancelled |
expired | Voided | Cancelled |
error | Voided | Cancelled |
5. Webhooks
O plugin regista um endpoint de webhook em /NoPayn/Webhook. O NoPayn envia dados POST contendo o identificador da encomenda em alterações de estado. O plugin verifica o estado atual via chamada API antes de atualizar a encomenda.
Não é necessária configuração manual do webhook — o plugin trata do registo automaticamente.
6. Testar e Lançar
Faça algumas transações de teste para garantir que tudo funciona corretamente. Recomendamos testar tanto pagamentos bem-sucedidos como falhados para confirmar que todos os cenários são tratados corretamente.
Suporte
Precisa de ajuda? Contacte a nossa equipa de suporte em support@costplus.io.