Magento

• Conta de comerciante Cost+ ativa
• Instalação Magento 2.4.6 – 2.4.8
• PHP 8.2 – 8.4
• Acesso de administrador ao painel de administração Magento
• Acesso SSH ao seu servidor (para instalação via Composer)

• Conta de comerciante Cost+ ativa
• Magento 1.9.x ou OpenMage LTS 20+
• PHP 7.4 ou superior
• Acesso de administrador ao painel de administração Magento
• Acesso SSH ou FTP ao seu servidor

Método A: Instalação via Composer (Recomendado)

Conecte-se ao seu servidor Magento via SSH e navegue até ao diretório raiz do Magento.

Instale o plugin:

composer require nopayn/nopayn-magento-2

Execute os comandos de configuração do Magento:

php bin/magento setup:upgrade
php bin/magento module:enable GingerPay_Payment
php bin/magento cache:clean

Se estiver em modo de produção, execute também:

php bin/magento setup:static-content:deploy

Método B: Instalação Manual

1. Navegue até ao diretório app/code
2. Transfira e descompacte o release Cost+ do GitHub
3. Execute os comandos de configuração:

php bin/magento setup:upgrade
php bin/magento cache:clean

Se em modo de produção:

php bin/magento setup:static-content:deploy

Transfira ou clone o módulo a partir do GitHub.

Copie o conteúdo de app/ para o diretório raiz app/ do seu Magento:

cp -r app/* /path/to/magento/app/

Limpe a cache do Magento:

rm -rf var/cache/*

Inicie sessão no painel de administração Magento e navegue até System → Configuration → Sales → Payment Methods para verificar que a secção NoPayn Payment Gateway aparece.

1. Vá a Stores → Configuration → Sales → Payment Methods → Cost+ Payments
2. Introduza a sua chave API (ver passo 3 abaixo)
3. Ative os métodos de pagamento para os quais foi aprovado
4. Guarde as alterações

1. Vá a System → Configuration → Sales → Payment Methods
2. Localize a secção NoPayn Payment Gateway
3. Introduza a sua chave API (ver passo 3 abaixo)
4. Ative os métodos de pagamento individuais (Credit / Debit Card, Apple Pay, Google Pay, Vipps MobilePay)
5. Opcionalmente restrinja por país
6. Guarde a configuração

1. O cliente seleciona um método de pagamento no checkout e faz a encomenda
2. O cliente é redirecionado para a Página de Pagamento Alojada NoPayn
3. Após o pagamento, o cliente regressa e o estado da encomenda é atualizado automaticamente
4. O NoPayn envia um webhook para confirmação assíncrona do estado

1. O cliente seleciona um método de pagamento no checkout e faz a encomenda
2. A encomenda é criada com o estado Pending Payment
3. O cliente é redirecionado para a página de pagamento segura NoPayn
4. Após o pagamento:
   • Sucesso — o cliente regressa, o estado é verificado via API, encomenda definida como Processing
   • Cancelado — o cliente regressa, encomenda definida como Canceled
   • Expirado (timeout de 5 minutos) — o webhook é acionado, encomenda definida como Canceled
5. O NoPayn envia um webhook para confirmação assíncrona do estado

Mapeamento de Estados da Encomenda

Webhooks

O módulo regista um endpoint de webhook em /nopayn/payment/webhook. Este URL é automaticamente enviado ao NoPayn ao criar encomendas. O webhook verifica sempre o estado da encomenda via a API NoPayn antes de atualizar a encomenda Magento.