osCommerce
Comhtháthaigh Cost+ le do shiopa osCommerce 4 ag úsáid an mhodúil íocaíochta oifigiúil

Comhtháthaigh Cost+ mar mhodh íocaíochta i do shiopa osCommerce 4. Úsáideann an modúl oifigiúil NoPayn Payments an sreabhadh Leathanach Íocaíochta Óstáilte, ionas nach dteagmhaíonn aon sonraí cártaí le do fhreastalaí -- go hiomlán comhlíontach le PCI DSS.
Réamhriachtanais
- Cuntas ceannaithe Cost+ gníomhach
- osCommerce 4.x
- PHP 8.1 nó níos déanaí
- Eisínteacht cURL cumasaithe
- Deimhniú SSL (HTTPS riachtanach)
- Rochtain riaracháin ar do phainéal riaracháin osCommerce
Modhanna Íocaíochta a dTacaítear Leo
| Lipéad Seiceála Amach | Aitheantóir NoPayn |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
Is féidir gach modh a chumasú nó a dhíchumasú ar leithligh ón bpainéal riaracháin.
1. Suiteáil an Modúl
Íoslódáil nó clónaigh an modúl ó GitHub.
Cóipeáil an eolaire lib/ isteach i bhfréamh osCommerce 4:
cp -r lib/ /path/to/oscommerce/Cuireann sé seo na comhaid modúil ag:
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.phpI do phainéal riaracháin osCommerce:
- Téigh go Modules -> Payment -> Online
- Cumasaigh scagairí Show inactive agus Show not installed más gá
- Aimsigh NoPayn Payments agus cliceáil Install
2. Cumraigh an Modúl
Logáil isteach sa Tairseach Ceannaithe agus téigh go Suíomhanna Gréasáin, ansin cliceáil ar an suíomh gréasáin ba mhaith leat a cheangal. Cliceáil ar Comhtháthú áit a bhfaighidh tú d'eochair API.

Cuir d'Eochair API isteach agus cumraigh na socruithe seo a leanas:
| Socrú | Cur Síos | Réamhshocrú |
|---|---|---|
| Enable NoPayn Payments | Príomhlasc cumasaithe/díchumasaithe | True |
| API Key | D'eochair API NoPayn | -- |
| Enable Credit / Debit Card | Taispeáin cárta creidmheasa/dochair ag an seiceáil amach | True |
| Enable Apple Pay | Taispeáin Apple Pay ag an seiceáil amach | True |
| Enable Google Pay | Taispeáin Google Pay ag an seiceáil amach | True |
| Enable Vipps MobilePay | Taispeáin Vipps MobilePay ag an seiceáil amach | True |
| Manual Capture (Credit Card) | Údaraigh amháin -- gabh nuair a chríochnaítear an t-ordú | False |
| Debug Logging | Scríobh iarratais/freagraí API go log | False |
| Completed Order Status | Stádas a shocraítear nuair a éiríonn le híocaíocht | Processing |
| Pending Order Status | Stádas a shocraítear agus ag fanacht le híocaíocht | Pending |
| Cancelled Order Status | Stádas a shocraítear ar cheallú/teip/éag | Cancelled |
| Payment Zone | Cuir srian ar chrios geografach (roghnach) | Gach crios |
| Sort Order | Ord taispeána ar an leathanach seiceála amach | 0 |
Ná gníomhachtaigh ach na modhanna íocaíochta atá ceadaithe duit agus a bhfuil dearbhú faighte agat dóibh.
3. Nuashonraigh Lipéid Seiceála Amach (Molta)
Glacann lipéid réamhshocraithe cnaipe seiceála amach osCommerce le sreabhadh aon chéime. Le haghaidh taithí níos fearr leis an atreorú íocaíochta lasmuigh, nuashonraigh na haistriúcháin seo in Admin -> Localisation -> Languages -> English -> Define:
| Eochair | Réamhshocrú | Molta |
|---|---|---|
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 |
Feabhsaíonn sé seo taithí an chustaiméara trí an sreabhadh seiceála amach a dhéanamh níos soiléire -- tuigeann custaiméirí go n-atreorófar iad chun íocaíocht a chríochnú ar leathanach slán.
4. Sreabhadh Íocaíochta
Nuair a bhíonn sé cumraithe, oibríonn an sreabhadh íocaíochta mar seo a leanas:
- Roghnaíonn an custaiméir modh íocaíochta Cost+ ag an seiceáil amach
- Dearbhaíonn an custaiméir an t-ordú
- Cruthaíonn an modúl ordú ar feitheamh agus glaonn sé ar API Cost+
- Atreorófar an custaiméir chuig an Leathanach Íocaíochta Óstáilte Cost+ (HPP)
- Críochnaíonn an custaiméir an íocaíocht ar an HPP slán
- Atreorófar an custaiméir ar ais chuig an siopa
- Fíoraíonn an modúl stádas na híocaíochta tríd an API Cost+
- Nuashonraítear stádas an ordaithe dá réir
Éagann naisc íocaíochta tar éis 5 nóiméad. Mura gcríochnaíonn an custaiméir an íocaíocht laistigh den fhuinneog seo, marcáiltear an t-ordú mar cheallaithe go huathoibríoch.
5. Webhookeanna
Cláraíonn an modúl URL webhook le Cost+ le haghaidh nuashonruithe stádais freastalaí-le-freastalaí. Nuair a athraíonn stádas íocaíochta, seolann Cost+ fógra agus:
- Faigheann an modúl an webhook POST
- Fíoraíonn sé stádas na híocaíochta tríd an API (ní bhíonn sé ag brath ar an sonraí webhook riamh)
- Nuashonraíonn sé stádas an ordaithe in osCommerce
Níl aon chumraíocht webhook de láimh riachtanach -- láimhseálann an modúl clárú go huathoibríoch.
Gabháil de Láimh
Nuair atá sé cumasaithe le haghaidh íocaíochtaí cárta creidmheasa:
- Bíonn an íocaíocht údaraithe ach ní ghabhtar í ag an seiceáil amach
- Gabhtar cistí nuair a aistrítear an t-ordú go stádas completed
- Má chealaítear an t-ordú, neamhnítear an t-údarú go huathoibríoch
Úsáid gabháil de láimh más mian leat custaiméirí a ghearradh nuair a sheoltar a n-ordú. Tá sé seo úsáideach do cheannaithe le hamanna comhlíonta níos faide.
Logáil Dífhabhtaithe
Nuair atá Debug Logging cumasaithe, scríobhann an modúl go nopayn_debug.log in eolaire loganna osCommerce. Áirítear ar iontrálacha loganna:
- Gach iarratas agus freagra API
- Imeachtaí webhook agus torthaí próiseála
- Oibríochtaí gabhála agus neamhnithe
- Earráidí (logáilte i gcónaí, beag beann ar an lasc dífhabhtaithe)
Cuirtear NoPayn_ roimh gach iontráil le haghaidh scagtha éasca.
Díghníomhú
- Téigh go Modules -> Payment -> Online sa phainéal riaracháin
- Roghnaigh NoPayn Payments
- Cliceáil Remove
Má dhíghníomhaítear an modúl, bainfear an chumraíocht agus scaoilfear na táblaí bunachar sonraí nopayn_transactions agus nopayn_refunds. Bí cinnte aon sonraí atá ag teastáil a easpórtáil sula ndíghníomhaíonn tú.
Tástáil agus Seoladh
Cuir cúpla idirbheart tástála isteach chun a chinntiú go n-oibríonn gach rud go réidh. Molaimid íocaíochtaí rathúla agus teipthe araon a thástáil chun gach cás a dhearbhú i gceart.
Tacaíocht
Cabhair ag teastáil? Déan teagmháil lenár bhfoireann tacaíochta ag support@costplus.io.