PrestaShop

• Conta de comerciante Cost+ ativa
• PrestaShop 9.1 ou superior
• PHP 8.1 ou superior
• SSL/HTTPS ativado
• Acesso de administrador ao back office do seu PrestaShop

• Conta de comerciante Cost+ ativa
• Instalação PrestaShop 8.x
• PHP 8.0 ou superior
• Acesso de administrador ao back office do seu PrestaShop
• MySQL 5.4 ou superior

• Conta de comerciante Cost+ ativa
• Instalação PrestaShop 1.7.x
• PHP 5.4 ou superior
• Acesso de administrador ao back office do seu PrestaShop
• MySQL 5.4 ou superior

• Conta de comerciante Cost+ ativa
• Instalação PrestaShop 1.6.1.x
• PHP 5.6 ou superior (com extensões cURL e OpenSSL)
• SSL/HTTPS ativado na loja
• Acesso de administrador ao back office do seu PrestaShop

Transfira o módulo a partir do GitHub.

Método A: Carregar Através do Painel de Administração (Recomendado)

1. Vá a Módulos → Gestor de Módulos no painel de administração
2. Clique em Carregar um módulo
3. Arraste e largue o ficheiro ZIP ou selecione-o manualmente
4. Aguarde que a instalação termine
5. Pesquise "NoPayn" e clique em Configurar

Método B: Carregamento Manual

1. Copie a pasta nopaynpayment/ para o diretório modules/ do seu PrestaShop
2. Vá a Módulos → Gestor de Módulos
3. Pesquise "NoPayn" e clique em Instalar
4. Clique em Configurar para abrir as definições

Transfira o módulo a partir do GitHub.

Método A: Carregar Através do Painel de Administração (Recomendado)

1. Vá a Improve > Module Manager no painel de administração
2. Clique em Upload a module
3. Arraste e largue o ficheiro ZIP ou selecione-o manualmente
4. Aguarde que a instalação termine
5. Desloque-se até à secção "Other" e clique em Configure em Cost+

Método B: Carregamento Manual via (S)FTP

1. Extraia o ficheiro ZIP transferido
2. Utilizando um cliente SFTP (ex.: FileZilla, WinSCP), carregue todas as pastas para o diretório /modules/ da sua instalação PrestaShop
3. Vá a Improve > Modules > Module Catalog
4. Pesquise "Cost+" -- verifique o separador Uninstalled Modules se necessário
5. Clique em Install

Transfira o módulo a partir do GitHub.

Método A: Carregar Através do Painel de Administração (Recomendado)

1. Vá a Improve > Module Manager no painel de administração
2. Clique em Upload a module
3. Arraste e largue o ficheiro ZIP ou selecione-o manualmente
4. Aguarde que a instalação termine
5. Desloque-se até à secção "Other" e clique em Configure em Cost+

Método B: Carregamento Manual via (S)FTP

1. Extraia o ficheiro ZIP transferido
2. Utilizando um cliente SFTP (ex.: FileZilla, WinSCP), carregue todas as pastas para o diretório /modules/ da sua instalação PrestaShop
3. Vá a Modules > Module Manager
4. Pesquise "Cost+" -- verifique o separador Uninstalled Modules se necessário
5. Clique em Install

Transfira o módulo a partir do GitHub.

Método A: Carregar Através do Painel de Administração (Recomendado)

1. Transfira costpluspayment.zip a partir da página Releases do GitHub
2. Vá a Modules and Services no back office do PrestaShop
3. Clique em Add a new module
4. Carregue o ficheiro ZIP
5. Localize Cost+ Payment Gateway na lista de módulos e clique em Install

Método B: Carregamento Manual via (S)FTP

1. Extraia o ficheiro ZIP transferido
2. Utilizando um cliente SFTP, carregue a pasta costpluspayment/ para /modules/costpluspayment/ na sua instalação PrestaShop
3. Vá a Modules and Services no back office
4. Localize Cost+ Payment Gateway e clique em Install

Na configuração do módulo NoPayn, introduza a sua chave API e configure as seguintes definições:

Cole a chave no campo API Key na página de configuração da Cost+ Library e clique em Save.

Cole a chave no campo API Key na página de configuração da Cost+ Library e clique em Save.

Após a instalação, clique em Configure no módulo Cost+ Payment Gateway e defina o seguinte:

Após guardar, abra Payment > Restrictions e ative o módulo Cost+ Payment Gateway para cada moeda que aceitar.

Os métodos de pagamento são configurados diretamente nas definições do módulo (ver passo 2 acima). Ative ou desative cada método conforme necessário.

Após guardar a sua chave API, carregue cada módulo de método de pagamento separadamente via Upload a module.

Regresse a Improve > Module Manager, clique em Upload a module novamente e carregue cada ficheiro ZIP para os métodos de pagamento que pretende ativar (ex.: Credit Card, MobilePay, Swish).

Os módulos de pagamento terão uma opção Configure (se for necessária configuração adicional) ou apenas um interruptor Ativar/Desativar.

Após guardar a sua chave API, carregue cada módulo de método de pagamento separadamente via Upload a module.

Regresse a Improve > Module Manager, clique em Upload a module novamente e carregue cada ficheiro ZIP para os métodos de pagamento que pretende ativar (ex.: Credit Card, MobilePay, Swish).

Os módulos de pagamento terão uma opção Configure (se for necessária configuração adicional) ou apenas um interruptor Ativar/Desativar.

Os métodos de pagamento são ativados diretamente na página de configuração do módulo (ver passo 2 acima). Ative cada método que pretenda disponibilizar no checkout.

Webhook

O URL do webhook é automaticamente configurado por encomenda:

https://your-shop.com/module/nopaynpayment/webhook

Captura Manual

Quando ativada para pagamentos com cartão de crédito:

• O pagamento é autorizado mas não capturado no checkout
• A captura ocorre quando a encomenda é expedida / marcada como concluída
• Se a encomenda for cancelada, a autorização é automaticamente anulada

Reembolso Automático

Se uma encomenda com pagamento capturado for cancelada, o módulo emite automaticamente um reembolso total. Reembolsos parciais podem ser processados via notas de crédito do PrestaShop.

Etiquetas do Botão de Checkout

Para a melhor experiência do utilizador com fluxos de redirecionamento externo, considere atualizar a etiqueta do botão de checkout para "Rever encomenda" em vez de "Confirmar e pagar", uma vez que o pagamento real acontece na página alojada da Cost+. Esta é uma definição global do PrestaShop, não específica do módulo.

Webhook

O webhook é automaticamente configurado pelo módulo. Não é necessária configuração manual.

Webhook

O webhook é automaticamente configurado pelo módulo. Não é necessária configuração manual.

Webhook

A página de configuração do módulo mostra um URL de webhook. Copie-o para o seu painel Cost+ se a sua conta Cost+ exigir um registo estático do webhook.

O endpoint do webhook recebe eventos da Cost+ e, em seguida, chama a Cost+ novamente com GET /orders/{id} antes de atualizar a encomenda PrestaShop — isto mantém o tratamento do URL de retorno e do webhook idempotente.

Cron de Expiração

A página de configuração do módulo mostra um URL de cron de expiração. Agende-o para ser executado a cada minuto:

* * * * * curl -fsS "https://your-shop.example/index.php?fc=module&module=costpluspayment&controller=cron&token=..." >/dev/null

Utilize o URL exato mostrado no seu back office do PrestaShop — o token é gerado durante a instalação e é diferente para cada loja. O endpoint do cron cancela encomendas Cost+ pendentes obsoletas após o Checkout Expiry configurado.

Captura Manual e Reembolsos

• Com Manual Capture ativado, os pagamentos são autorizados no checkout e capturados quando a encomenda é expedida / marcada como concluída
• Se uma encomenda capturada for cancelada, o módulo emite automaticamente um reembolso total
• Reembolsos parciais são processados via notas de crédito do PrestaShop