Magento

Integroi Cost+ maksutavaksi Magento-kauppaasi. Cost+-laajennus on saatavilla Magento 2 (2.4.6 – 2.4.8) ja Magento 1.9 (mukaan lukien OpenMage LTS 20+) -versioille.

Edellytykset

Aktiivinen Cost+-kauppiastili
Magento 2.4.6 – 2.4.8 -asennus
PHP 8.2 – 8.4
Ylläpitäjän pääsy Magento-hallintapaneeliin
SSH-yhteys palvelimellesi (Composer-asennusta varten)

Aktiivinen Cost+-kauppiastili
Magento 1.9.x tai OpenMage LTS 20+
PHP 7.4 tai uudempi
Ylläpitäjän pääsy Magento-hallintapaneeliin
SSH- tai FTP-yhteys palvelimellesi

1. Asenna laajennus

Tapa A: Asennus Composerilla (suositeltava)

Yhdistä Magento-palvelimeesi SSH:lla ja siirry Magento-juurihakemistoon.

Asenna lisäosa:

composer require nopayn/nopayn-magento-2

Suorita Magenton asennuskomennot:

php bin/magento setup:upgrade
php bin/magento module:enable GingerPay_Payment
php bin/magento cache:clean

Jos olet tuotantotilassa, suorita myös:

php bin/magento setup:static-content:deploy

Tapa B: Manuaalinen asennus

Siirry app/code-hakemistoon
Lataa ja pura Cost+-julkaisu GitHubista
Suorita asennuskomennot:

php bin/magento setup:upgrade
php bin/magento cache:clean

Jos tuotantotilassa:

php bin/magento setup:static-content:deploy

Lataa tai kloonaa moduuli GitHubista.

Kopioi app/-kansion sisältö Magento-juuresi app/-hakemistoon:

cp -r app/* /path/to/magento/app/

Tyhjennä Magenton välimuisti:

rm -rf var/cache/*

Kirjaudu Magento-hallintapaneeliin ja siirry kohtaan System → Configuration → Sales → Payment Methods varmistaaksesi, että NoPayn Payment Gateway -osio näkyy.

Moduuli luo nopayn_transactions-taulun tietokantaasi maksutapahtumien seurantaa varten. Tämä luodaan automaattisesti ensimmäisellä käyttökerralla.

2. Määritä lisäosa

Siirry kohtaan Stores → Configuration → Sales → Payment Methods → Cost+ Payments
Syötä API-avaimesi (katso vaihe 3 alla)
Ota käyttöön hyväksytyt maksutavat
Tallenna muutokset

Siirry kohtaan System → Configuration → Sales → Payment Methods
Etsi NoPayn Payment Gateway -osio
Syötä API-avaimesi (katso vaihe 3 alla)
Ota yksittäiset maksutavat käyttöön (Credit / Debit Card, Apple Pay, Google Pay, Vipps MobilePay)
Voit halutessasi rajoittaa maittain
Tallenna asetukset

3. Syötä API-tunnukset

Kirjaudu kauppiasportaaliin ja siirry kohtaan Websites, napsauta sitten verkkosivustoa, jonka haluat yhdistää. Napsauta Integration, josta löydät API-avaimesi.

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

Liitä API-avain asetuskenttään ja tallenna.

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

Tuetut maksutavat

Kassan nimi	NoPayn-tunniste
Credit / Debit Card	`credit-card`
Apple Pay	`apple-pay`
Google Pay	`google-pay`
Vipps MobilePay	`vipps-mobilepay`

Maksukulku

Asiakas valitsee maksutavan kassalla ja tekee tilauksen
Asiakas ohjataan NoPayn-isännöidylle maksusivulle
Maksun jälkeen asiakas palaa ja tilauksen tila päivittyy automaattisesti
NoPayn lähettää webhookin asynkroniseen tilanvahvistukseen

Asiakas valitsee maksutavan kassalla ja tekee tilauksen
Tilaus luodaan tilalla Pending Payment
Asiakas ohjataan NoPaynin turvalliselle maksusivulle
Maksun jälkeen:
- Onnistunut — asiakas palaa, tila vahvistetaan API:n kautta, tilaus asetetaan tilaan Processing
- Peruutettu — asiakas palaa, tilaus asetetaan tilaan Canceled
- Vanhentunut (5 minuutin aikakatkaisu) — webhook laukeaa, tilaus asetetaan tilaan Canceled
NoPayn lähettää webhookin asynkroniseen tilanvahvistukseen

Tilauksen tilakartoitus

NoPayn-tila	Magento-tilauksen tila	Magento-tilauksen näyttötila
`new`	pending_payment	Pending Payment
`processing`	pending_payment	Pending Payment
`completed`	processing	Processing
`cancelled`	canceled	Canceled
`expired`	canceled	Canceled
`error`	canceled	Canceled

Moduuli rekisteröi webhook-päätepisteen osoitteeseen /nopayn/payment/webhook. Tämä URL lähetetään automaattisesti NoPaynille tilauksia luotaessa. Webhook vahvistaa aina tilauksen tilan NoPayn API:n kautta ennen Magento-tilauksen päivittämistä.

Manuaalista webhook-asetusta ei tarvita — moduuli hoitaa rekisteröinnin automaattisesti.

4. Testaa asetukset

Tee muutama testitapahtuma — sekä onnistuneita että epäonnistuneita
Varmista, että kaikki käyttöön otetut maksutavat näkyvät kassalla
Määritä veloituskäyttäytyminen (automaattinen veloitus vs. manuaalinen) toimitusprosessisi mukaan

Tuki

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