Cost+Docs

Shopware

Integroi Cost+ Shopware 6 -kauppaasi virallisen maksulisäosan avulla

Shopware

Integroi Cost+ maksutavaksi Shopware 6 -kauppaasi. Virallinen NoPayn Payment -lisäosa tukee useita maksutapoja myyntikanavakohtaisesti ja käyttää isännöidyn maksusivun kulkua — täysin PCI DSS -yhteensopiva.

Edellytykset

  • Aktiivinen Cost+-kauppiastili
  • Shopware 6.7 tai uudempi
  • PHP 8.2 tai uudempi
  • SSH- tai terminaaliyhteys Shopware-palvelimeesi

Tuetut maksutavat

Kassan nimiTekninen nimiNoPayn-tunniste
Credit / Debit Cardnopayn_credit_cardcredit-card
Apple Paynopayn_apple_payapple-pay
Google Paynopayn_google_paygoogle-pay
Vipps MobilePaynopayn_vipps_mobilepayvipps-mobilepay

Jokainen maksutapa voidaan ottaa käyttöön tai poistaa käytöstä myyntikanavakohtaisesti lisäosan asetuksissa.

1. Asenna lisäosa

Kloonaa tai kopioi lisäosa Shopwaren custom/plugins/-hakemistoon:

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

Asenna ja aktivoi Shopware CLI:n kautta:

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

2. Määritä lisäosa

  1. Shopwaren hallintapaneelissa siirry kohtaan Settings → Extensions → NoPayn Payment
  2. Syötä API-avaimesi kauppiasportaalista — siirry kohtaan Websites, napsauta verkkosivustoa, jonka haluat yhdistää, ja napsauta sitten Integration löytääksesi API-avaimesi
  3. Ota yksittäiset maksutavat käyttöön tai poista käytöstä
  4. Tallenna

Cost+-kauppiasportaali näyttää API-avaimen

Voit määrittää eri API-avaimen myyntikanavakohtaisesti, jos sinulla on useita myymälöitä.

Ota käyttöön vain ne maksutavat, jotka on hyväksytty ja joista olet saanut vahvistuksen.

3. Maksukulku

  1. Asiakas valitsee maksutavan kassalla ja tekee tilauksen
  2. Tilaus luodaan tapahtuman tilalla in_progress
  3. Asiakas ohjataan NoPayn-isännöidylle maksusivulle
  4. Maksun jälkeen:
    • Onnistunut — asiakas palaa, tila vahvistetaan API:n kautta, tapahtuma asetetaan tilaan paid, tilaus tilaan processing
    • Peruutettu — asiakas palaa, tapahtuma ja tilaus asetetaan tilaan cancelled
    • Vanhentunut (5 minuutin aikakatkaisu) — webhook laukeaa, tapahtuma ja tilaus asetetaan tilaan cancelled

4. Tilauksen tilakartoitus

NoPayn-tilaTapahtuman tilaTilauksen tila
newin_progressopen
processingin_progressopen
completedpaidin_progress
cancelledcancelledcancelled
expiredcancelledcancelled
errorcancelledcancelled

5. Webhookit

Lisäosa rekisteröi automaattisesti webhook-päätepisteen osoitteeseen /api/nopayn/webhook. Tämä URL lähetetään NoPaynille tilauksia luotaessa ja tarjoaa asynkronisen tilanvahvistuksen kaikille tapahtumille.

Manuaalista webhook-asetusta ei tarvita — lisäosa hoitaa rekisteröinnin automaattisesti.

6. Testaa ja julkaise

Tee muutama testitapahtuma varmistaaksesi, että kaikki toimii sujuvasti. Suosittelemme testaamaan sekä onnistuneita että epäonnistuneita maksuja kaikkien skenaarioiden varmistamiseksi.

Tuki

Tarvitsetko apua? Ota yhteyttä tukitiimiimme osoitteessa support@costplus.io.

On this page