Cost+Docs

osCommerce

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

osCommerce

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 AmachAitheantóir NoPayn
Credit / Debit Cardcredit-card
Apple Payapple-pay
Google Paygoogle-pay
Vipps MobilePayvipps-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.php

I do phainéal riaracháin osCommerce:

  1. Téigh go Modules -> Payment -> Online
  2. Cumasaigh scagairí Show inactive agus Show not installed más gá
  3. 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.

Tairseach Ceannaithe Cost+ ag taispeáint eochair API

Cuir d'Eochair API isteach agus cumraigh na socruithe seo a leanas:

SocrúCur SíosRéamhshocrú
Enable NoPayn PaymentsPríomhlasc cumasaithe/díchumasaitheTrue
API KeyD'eochair API NoPayn--
Enable Credit / Debit CardTaispeáin cárta creidmheasa/dochair ag an seiceáil amachTrue
Enable Apple PayTaispeáin Apple Pay ag an seiceáil amachTrue
Enable Google PayTaispeáin Google Pay ag an seiceáil amachTrue
Enable Vipps MobilePayTaispeáin Vipps MobilePay ag an seiceáil amachTrue
Manual Capture (Credit Card)Údaraigh amháin -- gabh nuair a chríochnaítear an t-ordúFalse
Debug LoggingScríobh iarratais/freagraí API go logFalse
Completed Order StatusStádas a shocraítear nuair a éiríonn le híocaíochtProcessing
Pending Order StatusStádas a shocraítear agus ag fanacht le híocaíochtPending
Cancelled Order StatusStádas a shocraítear ar cheallú/teip/éagCancelled
Payment ZoneCuir srian ar chrios geografach (roghnach)Gach crios
Sort OrderOrd taispeána ar an leathanach seiceála amach0

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:

EochairRéamhshocrúMolta
TEXT_PAY_WITH_CARDPay with cardGo to payment
TEXT_CONFIRM_AND_PAYConfirm and payReview order
CONFIRM_ORDERConfirm orderConfirm 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:

  1. Roghnaíonn an custaiméir modh íocaíochta Cost+ ag an seiceáil amach
  2. Dearbhaíonn an custaiméir an t-ordú
  3. Cruthaíonn an modúl ordú ar feitheamh agus glaonn sé ar API Cost+
  4. Atreorófar an custaiméir chuig an Leathanach Íocaíochta Óstáilte Cost+ (HPP)
  5. Críochnaíonn an custaiméir an íocaíocht ar an HPP slán
  6. Atreorófar an custaiméir ar ais chuig an siopa
  7. Fíoraíonn an modúl stádas na híocaíochta tríd an API Cost+
  8. 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:

  1. Faigheann an modúl an webhook POST
  2. 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)
  3. 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ú

  1. Téigh go Modules -> Payment -> Online sa phainéal riaracháin
  2. Roghnaigh NoPayn Payments
  3. 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.

On this page