Ruka hadi kwenye maudhui

Unganisha Stripe na programu yako ya MonstarX

Kwa ufupiStripe huiwezesha programu yako kupokea malipo halisi. Bandika funguo zako za Stripe katika Huduma za wingu → Wingu (au kwenye kadi ambayo MonstarX inaonyesha kwenye mazungumzo), ukichagua Mazingira ya majaribio (funguo za majaribio) unapojaribu mambo, na Mazingira halisi (funguo za matumizi halisi) wateja halisi wanapolipa. MonstarX hukuandikia ukurasa wa malipo.

Pokea malipo ya kadi, usajili wa kulipia na kurasa za malipo katika programu yako.

Aina
Kwa programu yako
Kundi
Malipo na ankara
Unganisha kwa
Ufunguo wa API

Stripe ni kampuni ya malipo: hushughulikia fomu ya kadi, upande wa benki na risiti, kisha hulipa pesa kwenye akaunti yako ya benki. Iunganishe, na programu yako itaweza kuuza vitu — pasi ya madarasa, bidhaa, uanachama wa kila mwezi — kupitia ukurasa salama wa malipo unaoendeshwa na Stripe.

  • Kitufe cha “Nunua sasa” kinachofungua ukurasa wa malipo wa Stripe na kumrudisha mteja kwenye programu yako akishalipa.
  • Pasi na ofa za pamoja, kama “madarasa 5 kwa $90”, vinavyofungua kitu fulani ndani ya programu baada ya kulipiwa.
  • Usajili wa kulipia wa kila mwezi au kila mwaka kwa wanachama au kwa huduma ya kulipia.
  • Historia ya oda kwa kila mteja, na ukurasa wa msimamizi unaoorodhesha malipo.
  • Hatua za kiotomatiki zinazofuata, kama kuweka alama kwamba oda imelipwa na kutuma risiti kwa barua pepe, Stripe inapothibitisha malipo.
  • Akaunti ya Stripe. Kuifungua ni bila malipo; Stripe huchukua ada kutoka kila malipo yanayofaulu (angalia bei za Stripe). MonstarX haiongezi chochote juu yake.
  • Kwa majaribio, huhitaji kitu kingine: kila akaunti ya Stripe inaweza kutumia sandbox, nakala ya mazoezi ya akaunti yako ambapo hakuna pesa halisi inayohamishwa.
  • Kwa malipo halisi, Stripe hukuomba uiwashe akaunti yako kwanza — taarifa za biashara yako na akaunti ya benki ya kupokea pesa.

Stripe hukupa seti mbili za funguo, na MonstarX hukuuliza unabandika ipi kupitia chaguo la Mazingira:

MazingiraFunguo huanza naKinachotokea
Mazingira ya majaribio (funguo za majaribio)sk_test_… na pk_test_…Malipo ya kuigiza kwa nambari za kadi za majaribio. Hakuna kadi halisi inayotozwa na hakuna pesa inayohamishwa. Yatumie unapounda.
Mazingira halisi (funguo za matumizi halisi)sk_live_… na pk_live_…Kadi halisi, pesa halisi, zinazolipwa kwenye benki yako. Yatumie wateja halisi wanapolipa.

Vitu unavyounda upande mmoja havipo upande mwingine: bidhaa, bei, wateja na malipo yaliyofanywa kwenye sandbox hubaki kwenye sandbox.

Kwenye sandbox, ukurasa wa malipo wa Stripe hukubali kadi zake za majaribio zilizochapishwa. Tumia tarehe yoyote ya kuisha muda iliyo mbele (kama 12/34), CVC yoyote ya tarakimu tatu na msimbo wowote wa posta:

Nambari ya kadiInachofanya
4242 4242 4242 4242Malipo yanafaulu.
4000 0000 0000 0002Kadi inakataliwa, ili uone wateja wanachokiona malipo yanaposhindwa.
4000 0025 0000 3155Benki inaomba ukaguzi wa ziada (3D Secure) kabla malipo hayajapita.

Usiandike kamwe nambari ya kadi halisi kwenye ukurasa wa malipo wa sandbox. Stripe inaorodhesha kadi zaidi za majaribio katika mwongozo wake wa majaribio.

  1. Ingia kwenye Stripe Dashboard.

  2. Ili kujaribu, fungua sandbox kutoka kwenye menyu ya akaunti iliyo juu kushoto. Ili kuanza malipo halisi, badilisha kwenda live mode badala yake.

  3. Fungua API keys (chini ya Developers). Nakili Publishable key, kisha ufichue na unakili Secret key.

Unapoomba malipo, kwa kawaida MonstarX huonyesha kadi ya Unganisha Stripe kwenye mazungumzo yenye sehemu hizohizo. Unaweza pia kuiunganisha mwenyewe:

  1. Fungua mradi wako na ubofye Huduma za wingu kwenye upau wa juu, kisha Wingu.

  2. Chini ya Viunganishi, bofya Unganisha kando ya Stripe.

  3. Chagua Mazingira: Mazingira ya majaribio (funguo za majaribio) au Mazingira halisi (funguo za matumizi halisi).

  4. Bandika Ufunguo wa siri na Ufunguo wa umma (publishable key). Acha Siri ya kusaini webhook tupu kwa sasa.

  5. Bofya Unganisha Stripe. Safu inaonyesha Imeunganishwa · mazingira ya majaribio (au Imeunganishwa · mazingira ya matumizi halisi), na hakikisho lako linaanza upya likiwa na funguo.

MonstarX haikagui kama funguo zinalingana na mazingira uliyochagua, kwa hiyo hakikisha funguo za sk_test_ zinaendana na Mazingira ya majaribio na funguo za sk_live_ na Mazingira halisi.

Webhook ni Stripe kuiambia programu yako “malipo haya yamepita”, hata kama mteja alifunga ukurasa kabla ya kurudi. Programu zinazofungua kitu baada ya malipo, au zinazoendesha usajili wa kulipia, zinapaswa kuwa nayo. Iongeze baada ya kuchapisha programu yako, kwa sababu Stripe haiwezi kufikia hakikisho lako la faragha:

  1. Iombe MonstarX: “Anwani ya webhook yangu ya Stripe ni ipi, na inapaswa kusikiliza matukio gani?” Kwa kawaida ni https://your-app.monstarx.app/api/stripe-webhook.

  2. Kwenye Stripe, fungua Webhooks, bofya Create an event destination, chagua matukio hayo, chagua Webhook endpoint kisha ubandike anwani.

  3. Fichua signing secret (inaanza na whsec_) na uinakili.

  4. Kwenye MonstarX, bofya Sasisha funguo kwenye safu ya Stripe, ibandike kwenye Siri ya kusaini webhook kisha ubofye Hifadhi funguo. Chapisha tena ili programu iliyo mtandaoni iipate.

Sandbox na live mode kila moja ina webhooks zake na signing secrets zake.

UnaandikaKinachotokea
“Waruhusu wanachama wanunue pasi ya madarasa 5 kwa $90 kupitia Stripe.”Kitufe cha kununua, ukurasa wa malipo wa Stripe wa kiasi hicho na ukurasa wa shukrani; pasi huongezwa baada ya kulipiwa.
“Ongeza kifurushi cha Pro cha kila mwezi cha $12 kupitia Stripe, na ukurasa wa kuona kifurushi changu.”Ukurasa wa malipo ya usajili na ukurasa unaoonyesha kifurushi cha mwanachama.
“Ongeza ukurasa wa msimamizi unaoorodhesha kila malipo.”Ukurasa unaoorodhesha malipo, pamoja na aliyelipa, alicholipia na lini.
“Ingiza bidhaa zangu za Stripe kwenye duka.”MonstarX inahitaji funguo zako ili kusoma akaunti yako, kwa hiyo kadi inasema MonstarX inahitaji Stripe ili kuendelea, na inaendelea yenyewe mara tu unapounganisha.

Bado huna funguo? Bofya Baadaye kwenye kadi. MonstarX inaunda ukurasa mzima wa malipo hata hivyo, na kitufe kinasema Stripe bado haijaunganishwa hadi uziongeze.

  1. Washa akaunti yako ya Stripe, badilisha kwenda live mode na unakili funguo za live.

  2. Kwenye Huduma za winguWingu, bofya Sasisha funguo kwenye safu ya Stripe.

  3. Weka Mazingira kuwa Mazingira halisi (funguo za matumizi halisi), bandika funguo zote mbili za live (na siri ya kusaini webhook ya live, ikiwa unaitumia) kisha ubofye Hifadhi funguo.

  4. Chapisha programu yako tena. Kuanzia sasa, malipo ni halisi.

  • Funguo zako huhifadhiwa kwa usimbaji fiche pamoja na programu hii pekee. Majina yake yanaonekana kwenye Huduma za winguSiri; thamani zake hazionyeshwi tena kamwe.
  • Ufunguo wa siri na siri ya kusaini webhook hutumiwa na seva ya programu yako pekee. Ufunguo wa umma umeundwa kuonekana kwenye kivinjari, na hilo ni salama.
  • Nambari za kadi huandikwa kwenye ukurasa wa malipo wa Stripe wenyewe. Hazifiki kamwe kwenye programu yako wala kwa MonstarX.
  • Ni mmiliki wa mradi pekee anayeweza kuunganisha, kusasisha au kutenganisha Stripe. Tenganisha huondoa funguo kwenye programu hii; kisha ukurasa wa malipo unaonyesha kuwa Stripe haijaunganishwa.
  • Ufunguo ukivuja, ubadilishe (roll) kwenye Stripe Dashboard na ubandike mpya kwa Sasisha funguo.
  • Programu moja hutumia mazingira moja ya Stripe kwa wakati mmoja. Kurudisha programu iliyo mtandaoni kwenye funguo za sandbox husimamisha malipo halisi hadi ubadilishe tena.
  • Stripe pia hutoa restricted keys (rk_…) zenye ruhusa unazochagua tu. Zinafanya kazi kwenye sehemu ya Ufunguo wa siri ikiwa zinaruhusu kila kitu ambacho programu yako hufanya, kama kuunda checkout sessions.
  • Majaribio ya QA hujaribu mtiririko wa malipo hadi hatua ya Stripe, na huuwekea alama kuwa unahitaji funguo wakati Stripe haijaunganishwa.
Je, MonstarX huchukua sehemu ya mauzo yangu?

Hapana. Malipo huenda moja kwa moja kwenye akaunti yako ya Stripe. Ada za Stripe zenyewe tu ndizo zinazotumika.

Je, ninaweza kujaribu malipo bila kadi halisi?

Ndiyo. Unganisha kwa Mazingira ya majaribio (funguo za majaribio) na ulipe kwa kadi ya majaribio 4242 4242 4242 4242, tarehe yoyote iliyo mbele na CVC yoyote. Hakuna pesa inayohamishwa.

Ninabadilishaje kutoka malipo ya majaribio kwenda malipo halisi?

Bofya Sasisha funguo kwenye safu ya Stripe, weka Mazingira kuwa Mazingira halisi (funguo za matumizi halisi), bandika funguo zako za live, bofya Hifadhi funguo kisha uchapishe tena.

Kwa nini ukurasa wangu wa malipo unasema Stripe haijaunganishwa?

Funguo bado hazijawekwa, au ziliondolewa. Fungua *Huduma za wingu → Wingu* na uunganishe Stripe; hakikisho linaanza upya likiwa na funguo.

Je, ninaweza kuona malipo ndani ya MonstarX?

Programu yako inaonyesha kile MonstarX iliiundia, kama ukurasa wa oda. Rekodi kamili ya kila malipo, marejesho na pesa zilizolipwa kwako iko kwenye Stripe Dashboard yako.