DocsnopCommerce
Integroi Cost+ nopCommerce-kauppaasi virallisen maksulisäosan avulla
Integroi Cost+ maksutavaksi nopCommerce-kauppaasi. Virallinen NoPayn Payment Gateway -lisäosa tukee useita maksutapoja suoralla uudelleenohjauksella valittuun maksutapaan — täysin PCI DSS -yhteensopiva.
Edellytykset
- Aktiivinen Cost+-kauppiastili
- nopCommerce 4.90 tai uudempi
- .NET 9
- Ylläpitäjän pääsy nopCommerce-hallintapaneeliin
- Pääsy nopCommercen lähdekoodiin (lisäosan asennusta varten)
Tuetut maksutavat
| Kassan näyttönimi | NoPayn-tunniste |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
1. Asenna lisäosa
Kopioi lisäosakansio nopCommercen lähdekoodihakemistoon:
src/Plugins/Nop.Plugin.Payments.NoPayn/Lisää projekti ratkaisuusi ja käännä:
dotnet sln add src/Plugins/Nop.Plugin.Payments.NoPayn/Nop.Plugin.Payments.NoPayn.csproj
dotnet buildnopCommerce-hallintapaneelissa:
- Siirry kohtaan Configuration → Local plugins
- Etsi NoPayn Payment Gateway ja napsauta Install
- Siirry kohtaan Configuration → Payment methods
- Aktivoi NoPayn Payment Gateway
- Napsauta Configure avataksesi asetukset
2. Määritä lisäosa
Kirjaudu kauppiasportaaliin ja siirry kohtaan Websites, napsauta sitten verkkosivustoa, jonka haluat yhdistää. Napsauta Integration, josta löydät API-avaimesi.
Lisäosan asetuksissa syötä API-avaimesi ja ota haluamasi maksutavat käyttöön:
| Asetus | Kuvaus |
|---|---|
| API Key | NoPayn API-avaimesi |
| Enable Credit / Debit Card | Ota luotto-/pankkikorttimaksut käyttöön |
| Enable Apple Pay | Ota Apple Pay -maksut käyttöön |
| Enable Google Pay | Ota Google Pay -maksut käyttöön |
| Enable Vipps MobilePay | Ota Vipps MobilePay -maksut käyttöön |
Ota käyttöön vain ne maksutavat, jotka on hyväksytty ja joista olet saanut vahvistuksen.
3. Maksukulku
- Asiakas valitsee kassalla NoPayn Payment Gateway -maksutavan
- Alamaksutavan valinta tulee näkyviin (Credit Card, Apple Pay jne.)
- Asiakas valitsee tavan ja vahvistaa tilauksen
- Tilaus luodaan tilalla Pending
- Asiakas ohjataan suoraan valittuun maksutapaan NoPayn-maksusivulla
- Maksun jälkeen:
- Onnistunut — tilaus merkitään tilaan Paid / Processing
- Peruutettu / Epäonnistunut / Vanhentunut — tilaus asetetaan tilaan Cancelled
- NoPayn lähettää webhookin asynkroniseen tilanvahvistukseen
Tapahtumat vanhenevat 5 minuutin kuluttua. Jos asiakas ei suorita maksua tässä ajassa, tilaus peruutetaan automaattisesti webhookin kautta.
4. Tilauksen tilakartoitus
| NoPayn-tila | nopCommerce-maksutila | nopCommerce-tilauksen tila |
|---|---|---|
new | Pending | Pending |
processing | Pending | Pending |
completed | Paid | Processing |
cancelled | Voided | Cancelled |
expired | Voided | Cancelled |
error | Voided | Cancelled |
5. Webhookit
Lisäosa rekisteröi webhook-päätepisteen osoitteeseen /NoPayn/Webhook. NoPayn lähettää POST-dataa, joka sisältää tilauksen tunnisteen tilanmuutoksissa. Lisäosa vahvistaa nykyisen tilan API-kutsulla ennen tilauksen päivittämistä.
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.