Drupal Commerce

Integre a Cost+ com a sua loja Drupal Commerce utilizando o módulo oficial de gateway de pagamento

Integre a Cost+ como método de pagamento na sua loja Drupal Commerce. O módulo oficial NoPayn Payment Gateway utiliza o fluxo de Página de Pagamento Alojada, para que nenhum dado de cartão passe pelo seu servidor — totalmente compatível com PCI DSS.

Pré-requisitos

Conta de comerciante Cost+ ativa
Drupal 10 ou 11
Drupal Commerce 3.x
PHP 8.1 ou superior
Acesso de administrador ao seu site Drupal

Métodos de Pagamento Suportados

Credit / Debit Card — Visa, Mastercard e mais
Apple Pay
Google Pay
Vipps / MobilePay

1. Instalar o Módulo

Copie o módulo commerce_nopayn para a sua instalação Drupal e ative-o:

cp -r commerce_nopayn /path/to/drupal/web/modules/custom/
drush en commerce_nopayn -y
drush cr

Pode também transferir o módulo diretamente do repositório GitHub.

2. Adicionar um Gateway de Pagamento

Navegue até Commerce → Configuration → Payment gateways (/admin/commerce/config/payment-gateways)
Clique em Add payment gateway
Selecione NoPayn Payment Gateway como o plugin

3. Configurar o Gateway

Introduza as seguintes definições:

NoPayn API Key — A sua chave API de comerciante do Portal do Comerciante
Payment Methods — Ativar ou desativar Credit Card, Apple Pay, Google Pay, Vipps MobilePay
Mode — Defina como Test ao utilizar uma chave API de um website sandbox, ou Live ao utilizar uma chave de website de produção

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

Definições Opcionais

Manual Capture — Autorizar pagamentos com cartão de crédito sem captura imediata (os fundos são reservados, depois capturados quando a encomenda é processada)
Debug Logging — Ativar para registar todos os pedidos e respostas da API no log do Drupal para resolução de problemas

Clique em Save quando terminar.

4. Fluxo de Pagamento

Depois de configurado, o fluxo de pagamento funciona da seguinte forma:

O cliente adiciona produtos ao carrinho e prossegue para o checkout
No passo de pagamento, os métodos Cost+ ativados são apresentados como botões de rádio
O cliente seleciona um método e confirma a encomenda
O módulo cria uma encomenda via a API Cost+ e redireciona para a página de pagamento alojada
O cliente completa o pagamento na página Cost+
O cliente regressa à loja — o pagamento é verificado via API
Um webhook da Cost+ confirma assincronamente o resultado do pagamento

As sessões de pagamento expiram após 5 minutos segundo os padrões Cost+. O módulo também envia linhas detalhadas da encomenda (produtos e envio) para a Cost+ para registos de transação detalhados.

5. Configuração de Webhooks

O URL do webhook é gerado automaticamente pelo Drupal Commerce:

https://your-store.com/payment/notify/{gateway_machine_name}

Por exemplo: https://your-store.com/payment/notify/nopayn

Este URL deve estar acessível a partir da internet sem autenticação. O módulo verifica sempre o estado do pagamento via API — nunca confia apenas no payload do webhook.

Captura Manual

Quando a captura manual está ativada para cartões de crédito:

O cartão do cliente é autorizado (fundos reservados) durante o checkout
A captura ocorre automaticamente quando a encomenda transita para Fulfilled
Se a encomenda for cancelada, a autorização é anulada via webhook

Utilize a captura manual se quiser cobrar os clientes apenas quando a encomenda é expedida. Isto é útil para comerciantes com tempos de processamento mais longos.

Reembolsos

Os reembolsos podem ser processados diretamente a partir do painel de administração do Commerce. São suportados reembolsos totais e parciais.

Tabelas da Base de Dados

O módulo cria duas tabelas para rastreamento:

Tabela	Objetivo
`nopayn_transactions`	Rastreia encomendas de pagamento criadas com a API Cost+
`nopayn_refunds`	Regista operações de reembolso para fins de auditoria

Desinstalação

drush pmu commerce_nopayn -y
drush cr

Desinstalar o módulo irá eliminar as tabelas nopayn_transactions e nopayn_refunds. Certifique-se de que exporta quaisquer dados necessários antes de desinstalar.

Testar e Lançar

Faça algumas transações de teste para garantir que tudo funciona corretamente. Defina o Mode do gateway como Test e verifique tanto pagamentos bem-sucedidos como falhados antes de mudar para Live.

Suporte

Precisa de ajuda? Contacte a nossa equipa de suporte em support@costplus.io.

On this page