DocsOpenCart
Integre a Cost+ com a sua loja OpenCart (4.x e 3.x / ocStore 3)
Integre a Cost+ como método de pagamento na sua loja OpenCart. A extensão oficial NoPayn Payment Gateway está disponível para OpenCart 4 e OpenCart 3 / ocStore 3.
Pré-requisitos
- Conta de comerciante Cost+ ativa
- OpenCart 4.0.0.0 ou superior
- PHP 8.0 ou superior
- Acesso de administrador ao painel OpenCart
- Conta de comerciante Cost+ ativa
- ocStore 3.0.x ou OpenCart 3.0.3.x
- PHP 7.4 ou superior
- Acesso de administrador ao painel OpenCart
Métodos de Pagamento Suportados
- Credit / Debit Card — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
- Apple Pay
- Google Pay
- Vipps / MobilePay
- Credit / Debit Card — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
- Apple Pay
- Google Pay
- Vipps / MobilePay
- Swish
1. Instalar a Extensão
Método A: Carregar via Painel de Administração (Recomendado)
- Transfira o último release
.ocmod.zipdo GitHub - Na administração OpenCart, vá a Extensions → Installer
- Carregue o ficheiro
.ocmod.zip - Vá a Extensions → Extensions → Payment
- Encontre NoPayn Payment Gateway e clique em Install, depois em Edit
Método B: Carregamento Manual
- Transfira ou clone o repositório
- Copie o conteúdo da pasta
upload/para o diretório raiz do seu OpenCart - Vá a Extensions → Extensions → Payment
- Encontre NoPayn Payment Gateway e clique em Install, depois em Edit
Arquitetura
O OpenCart 3 utiliza uma configuração multi-extensão:
- NoPayn - Global Settings — configuração partilhada (chave API, estados das encomendas, disponibilidade de métodos, captura manual, registo de depuração)
- NoPayn - Card Payments — checkout com cartão de crédito/débito
- NoPayn - Apple Pay / Google Pay — checkout com carteira digital (se apenas uma carteira estiver ativada, a etiqueta ajusta-se automaticamente)
- NoPayn - Vipps MobilePay — checkout Vipps/MobilePay
- NoPayn - Swish — checkout Swish
Método A: Carregar via Painel de Administração (Recomendado)
- Transfira o ficheiro
.ocmod.zipdo último release GitHub
Utilize o ficheiro .ocmod.zip do release — não os downloads "Source code" auto-gerados pelo GitHub, que contêm o layout do repositório, não o layout do instalador.
- Na administração, vá a Extensions → Installer
- Carregue o ficheiro
.ocmod.zip - Vá a Extensions → Extensions → Payments
- Instale NoPayn - Global Settings primeiro
- Abra NoPayn - Global Settings e configure:
- Chave API
- Estados de encomenda concluída, pendente e cancelada
- Métodos de pagamento disponíveis para os quais a sua conta de comerciante foi aprovada
- Opcional: captura manual de cartão
- Opcional: registo de depuração
- Instale os módulos de checkout que pretende expor:
- NoPayn - Card Payments
- NoPayn - Apple Pay / Google Pay
- NoPayn - Vipps MobilePay
- NoPayn - Swish
- Para cada módulo de checkout, defina: Status, Geo Zone e Sort Order
Método B: Carregamento Manual
- Transfira ou clone o repositório
- Copie o conteúdo da pasta
upload/para a raiz da sua loja - Vá a Extensions → Extensions → Payments
- Siga a mesma ordem de instalação que o Método A (Global Settings primeiro, depois módulos de checkout)
2. Introduzir Credenciais da API
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.
Nas definições do NoPayn Payment Gateway, introduza a sua chave API no campo correspondente.
Em NoPayn - Global Settings, introduza a sua chave API no campo correspondente. A chave API é partilhada entre todos os módulos de checkout — só precisa de a introduzir uma vez.
3. Configurar Definições de Pagamento
- Ative os métodos de pagamento para os quais foi aprovado
- Defina os seus estados de encomenda preferidos para pagamentos concluídos, pendentes e cancelados
- Opcionalmente restrinja pagamentos por Geo Zone
- Defina Status como Enabled
- Clique em Save
Definições Globais
NoPayn - Global Settings armazena toda a configuração partilhada:
| Definição | Descrição |
|---|---|
| API Key | A sua chave API NoPayn |
| Order Statuses | Mapeamento de estados concluído, pendente e cancelado |
| Method Availability | Quais métodos de pagamento a sua conta de comerciante foi aprovada |
| Manual Capture | Autorizar apenas pagamentos com cartão — capturar depois |
| Debug Logging | Ativar registo detalhado para resolução de problemas |
Definições do Módulo de Checkout
Cada módulo de checkout tem as suas próprias definições de loja:
| Definição | Descrição |
|---|---|
| Status | Ativar ou desativar este método de pagamento no checkout |
| Geo Zone | Restringir a zonas geográficas específicas |
| Sort Order | Ordem de apresentação na página de checkout |
Ative apenas os métodos de pagamento para os quais foi aprovado e recebeu confirmação.
Fluxo de Pagamento
- O cliente seleciona um método de pagamento Cost+ no checkout
- O cliente é redirecionado para a Página de Pagamento Alojada NoPayn
- Após o pagamento, o cliente regressa e o estado da encomenda é atualizado automaticamente
- O NoPayn envia um webhook para confirmação assíncrona do estado
A extensão utiliza a Página de Pagamento Alojada Cost+, o que significa que os clientes são redirecionados para um formulário de pagamento seguro. Nenhum dado sensível de cartão é tratado pelo seu servidor.
Cada módulo de checkout é uma extensão de pagamento OpenCart separada, dando aos clientes opções de rádio distintas no checkout (ex.: "Card Payments", "Apple Pay & Google Pay").
- O cliente seleciona uma etiqueta de método de pagamento no checkout (ex.: Card Payments)
- A extensão cria uma encomenda de pagamento alojada NoPayn
- O cliente é redirecionado para a página de pagamento segura NoPayn
- Após o pagamento, o cliente regressa e o estado da encomenda é atualizado automaticamente
- O NoPayn envia um webhook para confirmação assíncrona do estado
O módulo Apple Pay / Google Pay envia ambos os métodos numa única transação para que a página alojada NoPayn possa oferecer ambas as opções de carteira digital num único fluxo.
Atualizar da v1.0.0 para a v2.0.0
A versão 1.0.0 utilizava um único método de checkout chamado "NoPayn Checkout". A versão 2.0.0 muda para módulos de checkout separados por método de pagamento. Ao atualizar:
- Carregue o novo pacote
- A sua entrada "NoPayn Checkout" existente torna-se NoPayn - Global Settings
- Reveja e guarde as definições globais
- Instale e ative os novos módulos de checkout que pretende que os clientes vejam
4. 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.