Itumie bila kitufe cha kununua
Kitufe cha kununua ni safu ya urahisi. Chini yake, Coin Moebius ni webhook iliyokodishwa pamoja na vituo vichache vya JSON. Kama ungependa zaidi kujenga UI yako mwenyewe, kuendesha mtiririko wako mwenyewe wa malipo, au kuunganisha Coin Moebius na kitu ambacho kitufe hakiwezi kushughulikia (usajili wa Square au Authorize.Net, fomu maalum ya malipo, skripti ya upande-wa-seva, programu ya simu), kila kituo kitufe kinachotumia pia kinaweza kuitwa kutoka kwa chochote. Hakuna mabadiliko ya msimbo upande wetu.
Kuthibitisha miito ya nyuma
Miito unayofanya kutoka kwa seva yako mwenyewe inaweza kubeba ufunguo wa API wa mradi wako kama tokeni ya mbeba. Tengeneza ufunguo kwenye dashibodi, chini ya funguo za API za mradi wako (huanza na cmk_), na uutume kwenye kichwa cha Authorization:
Authorization: Bearer cmk_live_xxxxxxxxxxxxxxxxxxxxxxxxUfunguo umefungamana na mradi mmoja, na miito iliyothibitishwa hupata kikomo cha juu zaidi cha viwango kuliko isiyojulikana. Kitufe cha kununua chenyewe ni cha umma na hakihitaji ufunguo. Weka ufunguo wako kwenye seva yako. Usiuweke kamwe kwenye kivinjari au msimbo mwingine wa upande-wa-mteja.
Vituo hivi vyote huishi chini ya URL ya mradi wako. Katika uzalishaji msingi huo ni https://api.coinmoebius.com. URL kamili kwa kila moja imeonyeshwa hapa chini (badilisha sehemu za {…} na thamani zako mwenyewe).
| Kituo | Inafanya nini |
|---|---|
POST https://api.coinmoebius.com/api/checkout/{provider}/{projectId} | Anza malipo. POST { productId, metadata }; pokea chochote mtoa huduma anachohitaji (URL ya kuelekeza kwa Stripe, URL ya kuidhinisha kwa PayPal, tokeni kwa Authorize.Net Accept Hosted). Ichore jinsi unavyotaka. |
POST https://api.coinmoebius.com/webhook/{provider}/{projectId} | Mtoa huduma huchapisha hapa. Sisi tunathibitisha sahihi, tunaboresha tukio, tunalihifadhi, tunahesabu kima. Elekeza webhook ya mtoa huduma kwenye URL hii iwe malipo ya awali yalitoka kwenye kitufe chetu au uunganishaji wako mwenyewe. |
GET https://api.coinmoebius.com/status/{projectId}/{txId} | Uliza hali ya sasa ya malipo au usajili. Hurudisha umbo lilelile lililoboreshwa ambalo kitufe cha kununua hupata. |
POST https://api.coinmoebius.com/api/subscriptions/{projectId}/{subscriptionId}/portal-url | Tengeneza URL ya portal iliyopangishwa na mtoa huduma kwa mnunuzi kusimamia usajili wake. Hufanya kazi kwa mtoa huduma yeyote mwenye portal. |
Tambua mnunuzi kwenye mfumo wako mwenyewe kwa kupitisha metadata.customerRef kwenye mwito wa malipo. Inapitisha kupitia mtoa huduma na kurudi kwenye kila tukio la webhook, ili uweze kuunganisha rekodi za Coin Moebius na hifadhidata yako mwenyewe ya watumiaji bila sisi kuhifadhi chochote kuhusu mnunuzi.
Kwa nini mtu hutumia njia hii: mjenzi wa tovuti-tuli anayetaka kuandika kitufe chake mwenyewe kuendana na muundo wa tovuti yake na anahitaji tu webhook ishughulikiwe. Msanidi anayetaka kuruka kitufe kabisa na kuita API kutoka kwa seva yake mwenyewe. Mfanyabiashara anayetaka kuendesha usajili wa Square au Authorize.Net na yu sawa kuunganisha ukusanyaji wa kadi mwenyewe. Kitufe ni mahali pa kuanzia. API ndio bidhaa halisi.
Kusikiliza matukio ya mnunuzi
Kipengele hufyatua matukio matatu ya kivinjari. Sikiliza na addEventListener kwenye kipengele (au kwenye document, matukio hupanda). Matukio yote yanaweza kughairiwa, kuita event.preventDefault() husimamisha mtiririko wa chaguo-msingi.
| Tukio | Linafyatua lini | Mzigo wa maelezo |
|---|---|---|
cm-load-providers | Kidirisha cha kichaguzi kiko karibu kuuliza API orodha ya watoa huduma waliosanidiwa kwenye mradi huu. | Tupu. |
cm-checkout-started | Mnunuzi alichagua mtoa huduma na Coin Moebius iko karibu kuunda kipindi cha malipo (Stripe / NOWPayments) au kuunda nambari ya rejea (manual). | { provider: 'stripe' | 'nowpayments' | 'manual', ... } |
cm-error | Kitu kilishindwa: kosa la mtandao, kushindwa kwa sahihi, hakuna mtoa huduma aliyesanidiwa. | { error: Error } |
document.addEventListener('cm-error', (event) => {
console.error('Coin Moebius:', event.detail.error);
// Show your own error UI, send to your analytics, etc.
});Hakuna tukio la cm-success kwenye kivinjari cha mnunuzi. Kufikia wakati malipo yanapokamilika kweli, mnunuzi tayari ameelekezwa kwenye malipo yaliyopangishwa ya mtoa huduma wa malipo (Stripe Checkout, ukurasa wa ankara wa NOWPayments). Wanarudi kwenye tovuti yako kupitia success_url uliyosanidi (ona sehemu inayofuata), na seva yako hujifunza kuhusu malipo kupitia dashibodi au kwa kuuliza kituo cha /status.
Kuuliza kutoka nyuma yako
Kwa chanzo cha ukweli cha upande-wa-seva, uliza GET /status/:projectId/:txId kutoka nyuma yako. Umbo la jibu:
{
"status": "succeeded",
"amount": 29.99,
"currency": "USD",
"isTest": false,
"createdAt": "2026-05-14T01:04:21.000Z",
"updatedAt": "2026-05-14T01:04:21.000Z"
}Thamani za hali hufuata enum ileile kama dashibodi (ona Hali za miamala). Kituo hakijathibitishwa lakini kina kikomo cha viwango cha maombi 60 / dakika kwa IP. Nambari ya muamala unayopitisha ni chochote SDK iliyorudisha katika tukio la cm-checkout-started au kile kinachoonyeshwa kwenye safu ya Rejea ya dashibodi.
Mtindo wa kawaida: ukurasa wako wa success_url unapopakia, anzisha kazi ya nyuma inayouliza /status/:projectId/:txId kila sekunde 15 hadi ione succeeded (au failed / muda kwisha), kisha timiza agizo.