Cost+Docs

Medusa.js

Comhtháthaigh Cost+ le do shiopa Medusa.js v2 ag úsáid an bhreiseáin oifigiúil costplus-medusa

Medusa.js

Comhtháthaigh Cost+ mar sholáthraí íocaíochta i do shiopa Medusa.js v2. Cláraíonn an breiseán oifigiúil costplus-medusa soláthraí íocaíochta Medusa ar leith do gach modh íocaíochta Cost+, úsáideann sé an sreabhadh Leathanach Íocaíochta Óstáilte, agus fíoraíonn sé gach athrú stádais in aghaidh API Cost+ — go hiomlán comhlíontach le PCI DSS.

Réamhriachtanais

  • Cuntas ceannaithe Cost+ gníomhach
  • Medusa.js 2.14.2 nó níos déanaí
  • Node.js 22
  • Rochtain PostgreSQL trí DATABASE_URL Medusa
  • URL poiblí HTTPS de chúl-deireadh Medusa (riachtanach do webhooks)
  • Seiceáil amach storefront a sheolann cart_id agus seisiún íocaíochta á thosú

Modhanna Íocaíochta a dTacaítear Leo

Ainm Seiceála AmachMedusa Provider IdAitheantóir Cost+
Credit / Debit Cardpp_costplus-credit-card_costpluscredit-card
Apple Paypp_costplus-apple-pay_costplusapple-pay
Google Paypp_costplus-google-pay_costplusgoogle-pay
Vipps MobilePaypp_costplus-vipps-mobilepay_costplusvipps-mobilepay

Cruthaíonn gach soláthraí ordú Cost+ do mhodh íocaíochta amháin go díreach, mar sin fanann roghanna seiceála amach an storefront ailínithe leis an sreabhadh atreoraithe leathanach íocaíochta óstáilte Cost+.

1. Suiteáil an Breiseán

Suiteáil an pacáiste i do thionscadal cúl-deireadh Medusa:

npm install costplus-medusa

Is féidir leat suiteáil ó eisiúint Git le clib chomh maith: npm install git+ssh://git@github.com:NoPayn/costplus-medusa.git#vX.Y.Z

2. Cláraigh an Breiseán agus an Soláthraí

Cuir an breiseán agus an soláthraí íocaíochta le do medusa-config.ts:

import { defineConfig } from "@medusajs/framework/utils"

module.exports = defineConfig({
  plugins: [
    {
      resolve: "costplus-medusa",
      options: {},
    },
  ],
  modules: [
    {
      resolve: "@medusajs/medusa/payment",
      options: {
        providers: [
          {
            resolve: "costplus-medusa/providers/costplus",
            id: "costplus",
            options: {},
          },
        ],
      },
    },
  ],
})

Atosaigh cúl-deireadh Medusa ionas go luchtófar an breiseán agus an soláthraí nua.

3. Cumraigh san Admin

I Medusa Admin, oscail Cost+ (bealach /app/costplus) agus cumraigh:

  • API Key — d'eochair API ceannaithe ón Tairseach Ceannaithe (Websites → do shuíomh gréasáin → Integration)
  • Checkout Expiry — am istigh i nóiméid (seoltar chuig Cost+ mar fhad ISO-8601, m.sh. 5 → PT5M, réamhshocrú 5 nóiméad)
  • Manual Capture — roghnach, údaraigh íocaíochtaí cárta gan ghabháil láithreach
  • Debug Logging — roghnach, logáil iarrataí agus freagraí API le haghaidh fabhtcheartaithe

Ar an leathanach Admin Cost+ céanna, cumasaigh na modhanna íocaíochta ar mhaith leat a nochtadh in aghaidh an réigiúin:

  • Cost+ Credit / Debit Card
  • Cost+ Apple Pay
  • Cost+ Google Pay
  • Cost+ Vipps MobilePay

Ná gníomhachtaigh ach na modhanna íocaíochta atá ceadaithe duit agus a bhfuil dearbhú faighte agat dóibh.

Athraíonn scoradh modhanna ar an leathanach seo na naisc soláthraí íocaíochta réigiúin i Medusa do sholáthraithe Cost+, sa chaoi nach gcuireann an chríochphointe Store API caighdeánach /store/payment-providers?region_id=... ach na modhanna Cost+ atá cumasaithe ar ais. Má tá gach modh Cost+ díchumasaithe do réigiún, ní chuirfidh an Store API aon soláthraí Cost+ ar ais don réigiún sin.

4. Comhtháthú Storefront

Agus seisiún íocaíochta Cost+ á thosú agat, seol cart_id Medusa i data:

await sdk.store.payment.initiatePaymentSession(paymentCollection.id, {
  provider_id: "pp_costplus-credit-card_costplus",
  data: {
    cart_id: cart.id,
    return_url: `${origin}/${countryCode}/checkout/costplus/return?cart_id=${cart.id}`,
    failure_url: `${origin}/${countryCode}/checkout?step=payment&costplus_cancelled=1&cart_id=${cart.id}`,
  },
})

Tar éis don seisiún a bheith cruthaithe, atreoraigh an siopadóir chuig payment_session.data.costplus_payment_url.

Is é /checkout/costplus/return?cart_id={cart_id} an bealach ratha réamhshocraithe — ba cheart don leathanach sin glao a chur ar chríochphointe complete-cart Medusa agus ansin an leathanach deimhniúcháin ordaithe a thaispeáint. Ba cheart don URL teipe an siopadóir a chur ar ais chuig céim na híocaíochta gan an ciseán a chríochnú.

Fíoraíonn láimhseáil fillte agus webhook an t-ordú Cost+ i gcónaí le GET /orders/{id}/ sula mapáiltear staid na híocaíochta ar ais chuig Medusa.

Liostaigh modhanna íocaíochta ón Store API

Liostaigh modhanna íocaíochta ó Store API Medusa in ionad ID-anna soláthraí Cost+ a chódú go crua i do shiopa. Má thaisceann an siopa /store/payment-providers, úsáid no-store nó neamhbhailigh an taisce tar éis athruithe modha san Admin, ionas go n-imíonn modhanna díchumasaithe ón checkout láithreach.

Le haghaidh sampla feidhmithe, féach examples/nextjs/costplus-return/ san stór costplus-medusa — leathanach fillte do thosaitheoir DTC Next.js a chuireann handler cliant le gníomh freastalaí ionas go ndéantar críochnú an chairt taobh amuigh de rindreáil an leathanaigh agus athsheoltar go hiontaofa go /order/{id}/confirmed.

5. Webhooks

Cláraíonn an breiseán go huathoibríoch críochphointe webhook ag /hooks/payment/{identifier}_costplus. Caithfidh URL chúl-deireadh Medusa a bheith insroichte go poiblí thar HTTPS ionas gur féidir le Cost+ nuashonruithe stádais aisioncronacha a sheachadadh.

Má fhanann orduithe ar feitheamh i bhfad tar éis na héaga cumraithe, léiríonn sé sin fadhb seachadta webhook nó sreabhadh fillte seachas socrú na héaga féin.

6. Slándáil agus Stóráil Socruithe

Criptítear an eochair API sula stórálfar í i mbunachar sonraí Medusa. Socraigh COSTPLUS_SETTINGS_SECRET i dtáirgeadh:

COSTPLUS_SETTINGS_SECRET=your-strong-secret

Mura bhfuil COSTPLUS_SETTINGS_SECRET socraithe, titeann an breiseán siar ar COOKIE_SECRET nó JWT_SECRET Medusa.

Socraigh COSTPLUS_API_KEY sa timpeallacht chun foinse na heochrach API a ghlasáil — nuair atá sé socraithe, ní rachaidh leathanach an Admin thar ní. Fág folamh é nuair is ceart do na ceannaithe an eochair a bhainistiú san Admin.

7. Tástáil agus Seol

Cinneann an eochair API timpeallacht Cost+ — ritheann eochair shuíomh gréasáin sandbox i mód tástála, ritheann eochair shuíomh gréasáin táirgeachta i mód beo (gan URL sandbox ar leithligh). Déan cúpla idirbheart tástála chun na sreafaí rathúla, cealaithe agus éagtha a fhíorú sula dtéann tú beo.

Tacaíocht

An bhfuil cabhair uait? Téigh i dteagmháil le foireann tacaíochta ag support@costplus.io.

On this page