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

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.2nó níos déanaí - Node.js
22 - Rochtain PostgreSQL trí
DATABASE_URLMedusa - URL poiblí HTTPS de chúl-deireadh Medusa (riachtanach do webhooks)
- Seiceáil amach storefront a sheolann
cart_idagus seisiún íocaíochta á thosú
Modhanna Íocaíochta a dTacaítear Leo
| Ainm Seiceála Amach | Medusa Provider Id | Aitheantóir Cost+ |
|---|---|---|
| Credit / Debit Card | pp_costplus-credit-card_costplus | credit-card |
| Apple Pay | pp_costplus-apple-pay_costplus | apple-pay |
| Google Pay | pp_costplus-google-pay_costplus | google-pay |
| Vipps MobilePay | pp_costplus-vipps-mobilepay_costplus | vipps-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-medusaIs 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 CardCost+ Apple PayCost+ Google PayCost+ 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-secretMura 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.