Shopware

Integre a Cost+ com a sua loja Shopware 6 utilizando o plugin oficial de pagamento

Integre a Cost+ como método de pagamento na sua loja Shopware 6. O plugin oficial NoPayn Payment suporta múltiplos métodos de pagamento por canal de vendas e utiliza o fluxo de Página de Pagamento Alojada — totalmente compatível com PCI DSS.

Pré-requisitos

Conta de comerciante Cost+ ativa
Shopware 6.7 ou superior
PHP 8.2 ou superior
Acesso SSH ou terminal ao seu servidor Shopware

Métodos de Pagamento Suportados

Nome no Checkout	Nome Técnico	Identificador NoPayn
Credit / Debit Card	`nopayn_credit_card`	`credit-card`
Apple Pay	`nopayn_apple_pay`	`apple-pay`
Google Pay	`nopayn_google_pay`	`google-pay`
Vipps MobilePay	`nopayn_vipps_mobilepay`	`vipps-mobilepay`

Cada método pode ser ativado ou desativado por canal de vendas na configuração do plugin.

1. Instalar o Plugin

Clone ou copie o plugin para o diretório custom/plugins/ do Shopware:

cd /path/to/shopware/custom/plugins
git clone git@github.com:NoPayn/shopware.git NoPaynPayment

Depois instale e ative via o CLI do Shopware:

bin/console plugin:refresh
bin/console plugin:install NoPaynPayment --activate
bin/console cache:clear

2. Configurar o Plugin

Na administração do Shopware, vá a Settings → Extensions → NoPayn Payment
Introduza a sua chave API do Portal do Comerciante — navegue até Websites, clique no website que pretende conectar, depois clique em Integração para encontrar a sua chave API
Ative ou desative métodos de pagamento individuais
Guarde

Portal do Comerciante Cost+ mostrando chave API

Pode configurar uma chave API diferente por canal de vendas se operar múltiplas lojas.

Ative apenas os métodos de pagamento para os quais foi aprovado e recebeu confirmação.

3. Fluxo de Pagamento

O cliente seleciona um método de pagamento no checkout e faz a encomenda
A encomenda é criada com o estado de transação in_progress
O cliente é redirecionado para a Página de Pagamento Alojada NoPayn
Após o pagamento:
- Sucesso — o cliente regressa, o estado é verificado via API, transação definida como paid, encomenda definida como processing
- Cancelado — o cliente regressa, transação e encomenda definidas como cancelled
- Expirado (timeout de 5 minutos) — o webhook é acionado, transação e encomenda definidas como cancelled

4. Mapeamento de Estados da Encomenda

Estado NoPayn	Estado da Transação	Estado da Encomenda
`new`	in_progress	open
`processing`	in_progress	open
`completed`	paid	in_progress
`cancelled`	cancelled	cancelled
`expired`	cancelled	cancelled
`error`	cancelled	cancelled

5. Webhooks

O plugin regista automaticamente um endpoint de webhook em /api/nopayn/webhook. Este URL é enviado ao NoPayn ao criar encomendas, proporcionando confirmação assíncrona do estado para todas as transações.

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.

On this page