DocsosCommerce
Integroi Cost+ osCommerce 4 -kauppaasi virallisen maksumoduulin avulla
Integroi Cost+ maksutavaksi osCommerce 4 -kauppaasi. Virallinen NoPayn Payments -moduuli käyttää isännöidyn maksusivun kulkua, joten korttitiedot eivät koskaan kosketa palvelintasi — täysin PCI DSS -yhteensopiva.
Edellytykset
- Aktiivinen Cost+-kauppiastili
- osCommerce 4.x
- PHP 8.1 tai uudempi
- cURL-laajennus käytössä
- SSL-sertifikaatti (HTTPS vaaditaan)
- Ylläpitäjän pääsy osCommerce-hallintapaneeliin
Tuetut maksutavat
| Kassan nimi | NoPayn-tunniste |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
Jokainen maksutapa voidaan ottaa erikseen käyttöön tai poistaa käytöstä hallintapaneelista.
1. Asenna moduuli
Lataa tai kloonaa moduuli GitHubista.
Kopioi lib/-hakemisto osCommerce 4 -juurihakemistoosi:
cp -r lib/ /path/to/oscommerce/Tämä sijoittaa moduulitiedostot seuraavaan sijaintiin:
lib/common/modules/orderPayment/nopayn.php
lib/common/modules/orderPayment/nopayn/NoPaynApiClient.php
lib/common/modules/orderPayment/nopayn/NoPaynLogger.php
lib/common/modules/orderPayment/nopayn/NoPaynWebhookHandler.phposCommerce-hallintapaneelissa:
- Siirry kohtaan Modules → Payment → Online
- Ota tarvittaessa käyttöön Show inactive ja Show not installed -suodattimet
- Etsi NoPayn Payments ja napsauta Install
2. Määritä moduuli
Kirjaudu kauppiasportaaliin ja siirry kohtaan Websites, napsauta sitten verkkosivustoa, jonka haluat yhdistää. Napsauta Integration, josta löydät API-avaimesi.
Syötä API-avaimesi ja määritä seuraavat asetukset:
| Asetus | Kuvaus | Oletus |
|---|---|---|
| Enable NoPayn Payments | Pääkytkin käyttöönotolle/poistamiselle | True |
| API Key | NoPayn API-avaimesi | — |
| Enable Credit / Debit Card | Näytä luotto-/pankkikortti kassalla | True |
| Enable Apple Pay | Näytä Apple Pay kassalla | True |
| Enable Google Pay | Näytä Google Pay kassalla | True |
| Enable Vipps MobilePay | Näytä Vipps MobilePay kassalla | True |
| Manual Capture (Credit Card) | Valtuuta vain — veloita tilauksen valmistuessa | False |
| Debug Logging | Kirjaa API-pyynnöt/vastaukset lokiin | False |
| Completed Order Status | Tila, joka asetetaan maksun onnistuessa | Processing |
| Pending Order Status | Tila maksua odotettaessa | Pending |
| Cancelled Order Status | Tila peruutuksen/epäonnistumisen/vanhenemisen yhteydessä | Cancelled |
| Payment Zone | Rajoita maantieteelliseen vyöhykkeeseen (valinnainen) | Kaikki vyöhykkeet |
| Sort Order | Näyttöjärjestys kassasivulla | 0 |
Ota käyttöön vain ne maksutavat, jotka on hyväksytty ja joista olet saanut vahvistuksen.
3. Päivitä kassan tekstit (suositeltava)
osCommercen oletusarvoiset kassan painikkeiden tekstit olettavat yksivaiheista kulkua. Parempaa kokemusta varten ulkoisella maksuuudelleenohjauksella päivitä nämä käännökset kohdassa Admin → Localisation → Languages → English → Define:
| Avain | Oletus | Suositeltava |
|---|---|---|
TEXT_PAY_WITH_CARD | Pay with card | Go to payment |
TEXT_CONFIRM_AND_PAY | Confirm and pay | Review order |
CONFIRM_ORDER | Confirm order | Confirm and pay |
Tämä parantaa asiakaskokemusta tekemällä kassakulun selkeämmäksi — asiakkaat ymmärtävät, että heidät ohjataan suorittamaan maksu turvalliselle sivulle.
4. Maksukulku
Kun asetukset on tehty, maksukulku toimii seuraavasti:
- Asiakas valitsee Cost+-maksutavan kassalla
- Asiakas vahvistaa tilauksen
- Moduuli luo odottavan tilauksen ja kutsuu Cost+ API:a
- Asiakas ohjataan Cost+:n isännöidylle maksusivulle (HPP)
- Asiakas suorittaa maksun turvallisella HPP-sivulla
- Asiakas ohjataan takaisin kauppaan
- Moduuli vahvistaa maksun tilan Cost+ API:n kautta
- Tilauksen tila päivitetään vastaavasti
Maksulinkit vanhenevat 5 minuutin kuluttua. Jos asiakas ei suorita maksua tässä ajassa, tilaus merkitään automaattisesti peruutetuksi.
5. Webhookit
Moduuli rekisteröi webhook-URL:n Cost+:lle palvelin-palvelin-tilapäivityksiä varten. Kun maksun tila muuttuu, Cost+ lähettää ilmoituksen ja moduuli:
- Vastaanottaa webhook-POST-pyynnön
- Vahvistaa maksun tilan API:n kautta (ei koskaan luota webhook-dataan)
- Päivittää tilauksen tilan osCommercessa
Manuaalista webhook-asetusta ei tarvita — moduuli hoitaa rekisteröinnin automaattisesti.
Manuaalinen veloitus
Kun käytössä luottokorttimaksuille:
- Maksu valtuutetaan mutta ei veloiteta kassan yhteydessä
- Varat veloitetaan, kun tilaus siirtyy completed-tilaan
- Jos tilaus peruutetaan, valtuutus mitätöidään automaattisesti
Käytä manuaalista veloitusta, jos haluat veloittaa asiakkaita vasta tilauksen lähettämisen yhteydessä. Tämä on hyödyllistä kauppiaille, joilla on pidempi toimitusaika.
Virheenkorjauslokitus
Kun Debug Logging on käytössä, moduuli kirjoittaa tiedostoon nopayn_debug.log osCommercen lokihakemistossa. Lokimerkinnät sisältävät:
- Kaikki API-pyynnöt ja -vastaukset
- Webhook-tapahtumat ja käsittelytulokset
- Veloitus- ja mitätöintioperaatiot
- Virheet (kirjataan aina riippumatta virheenkorjausasetuksesta)
Kaikki merkinnät alkavat etuliitteellä NoPayn_ helpon suodatuksen mahdollistamiseksi.
Asennuksen poisto
- Siirry hallintapaneelissa kohtaan Modules → Payment → Online
- Valitse NoPayn Payments
- Napsauta Remove
Moduulin poistaminen poistaa asetukset ja pudottaa nopayn_transactions- ja nopayn_refunds-tietokantataulut. Varmista, että viet tarvitsemasi tiedot ennen asennuksen poistoa.
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.