Shopware

Integrujte Cost+ s vaším Shopware 6 obchodem pomocí oficiálního platebního pluginu

Integrujte Cost+ jako platební metodu do vašeho Shopware 6 obchodu. Oficiální plugin NoPayn Payment podporuje více platebních metod na prodejní kanál a využívá tok hostované platební stránky — plně v souladu s PCI DSS.

Předpoklady

Aktivní obchodní účet Cost+
Shopware 6.7 nebo novější
PHP 8.2 nebo novější
SSH nebo terminálový přístup k serveru Shopware

Podporované platební metody

Název v checkoutu	Technický název	NoPayn identifikátor
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`

Každou metodu lze povolit nebo zakázat pro jednotlivé prodejní kanály z konfigurace pluginu.

1. Nainstalujte plugin

Naklonujte nebo zkopírujte plugin do adresáře custom/plugins/ Shopware:

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

Poté nainstalujte a aktivujte přes CLI Shopware:

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

2. Nakonfigurujte plugin

V administraci Shopware přejděte na Settings → Extensions → NoPayn Payment
Zadejte svůj API Key z obchodního portálu — přejděte na Weby, klikněte na web, který chcete propojit, a poté klikněte na Integrace pro nalezení API klíče
Přepněte jednotlivé platební metody zapnuto nebo vypnuto
Uložte

Obchodní portál Cost+ zobrazující API klíč

Pokud provozujete více obchodů, můžete nakonfigurovat jiný API klíč pro každý prodejní kanál.

Aktivujte pouze platební metody, pro které jste byli schváleni a obdrželi potvrzení.

3. Platební tok

Zákazník vybere platební metodu při checkoutu a potvrdí objednávku
Objednávka je vytvořena se stavem transakce in_progress
Zákazník je přesměrován na hostovanou platební stránku NoPayn
Po platbě:
- Úspěch — zákazník se vrátí, stav je ověřen přes API, transakce nastavena na paid, objednávka na processing
- Zrušeno — zákazník se vrátí, transakce a objednávka nastaveny na cancelled
- Vypršelo (5minutový timeout) — webhook se aktivuje, transakce a objednávka nastaveny na cancelled

4. Mapování stavů objednávek

Stav NoPayn	Stav transakce	Stav objednávky
`new`	in_progress	open
`processing`	in_progress	open
`completed`	paid	in_progress
`cancelled`	cancelled	cancelled
`expired`	cancelled	cancelled
`error`	cancelled	cancelled

5. Webhooky

Plugin automaticky registruje webhook endpoint na /api/nopayn/webhook. Tato URL je odeslána NoPayn při vytváření objednávek a zajišťuje asynchronní potvrzení stavu všech transakcí.

Ruční konfigurace webhooku není nutná — plugin zajišťuje registraci automaticky.

6. Otestujte a spusťte

Proveďte několik testovacích transakcí, abyste se ujistili, že vše funguje hladce. Doporučujeme otestovat jak úspěšné, tak neúspěšné platby pro ověření, že jsou všechny scénáře správně zpracovány.

Podpora

Potřebujete pomoc? Obraťte se na náš tým podpory na support@costplus.io.

On this page