Square

Unachohitaji

Kwa nini tunauliza kila sehemu

Access token

Huidhinisha kuunda kiungo cha checkout, ili malipo yapite kwenye akaunti yako.

Webhook signature key

Huthibitisha webhook inayoingia ni kweli kutoka Square, ili mtu yeyote asighushi tukio la "paid". Ni thamani tofauti na access token.

Location ID

Huiambia Square ni eneo gani linalopokea fedha, na huweka sarafu ya checkout. Si siri.

Success and Cancel URL

Mipangilio ya kawaida: pale mnunuzi anapoingia baada ya kulipa au kujiondoa. Si siri.

Sanidi

1. Fungua dashibodi ya Msanidi wa Square

   Ingia kwenye developer.squareup.com. Kila programu ina vitambulisho vyake, na Sandbox ya bure inaundwa pamoja nayo kwa majaribio. Mwongozo huu unatembea kwenye Sandbox; mtiririko wa Live ni sawa kabisa, badilisha tu kitufe cha Sandbox / Production na utumie vitambulisho vyako vya uzalishaji. Kuunda programu mpya, bofya tile ya + kwenye skrini ya Applications.

   ⤢
2. Ipe programu jina

   Ipe programu jina utakalolitambua (kwa mfano "Coin Moebius"), kisha ubofye Next.

   ⤢
3. Nakili access token yako

   Fungua programu na nenda Credentials. Thibitisha kitufe cha Sandbox / Production juu kinaoanisha mazingira unayoyasanidi. Bofya ikoni ya kunakili karibu na Access token na uweke pembeni.

   ⤢

   Access token ni siri, itendee kama nywila. Sandbox na Production zina tokeni tofauti, kwa hiyo usizichanganye.

4. Nakili Location ID yako

   Kwenye menyu ya kushoto, fungua Locations. Nakili Location ID ya eneo linalopaswa kupokea malipo. Huweka sarafu ya checkout, kwa hiyo chagua eneo ambalo sarafu yake unataka kutoza.

   ⤢
5. Fungua Webhooks → Subscriptions

   Square huita kituo cha webhook "subscription." Kwenye menyu ya kushoto, panua Webhooks, fungua Subscriptions, na ubofye Add subscription.

   ⤢
6. Ongeza usajili na uchague matukio

   Ipe jina (kama "coin-moebius"). Katika Notification URL, bandika anwani ya webhook ya Square ya mradi wako (hapa chini). Kisha, chini ya Events, tafuta na weka alama kwenye matukio ambayo Coin Moebius husikiliza, na ubofye Save.

   • Malipo ya mara moja: payment.created, payment.updated, refund.created, refund.updated, dispute.created, dispute.state.updated.
   • Usajili (tu kama unauza): subscription.created, subscription.updated, subscription.canceled, subscription.deactivated, invoice.payment_made, invoice.scheduled_charge_failed. Kama hufaidishi kwa msingi wa mara kwa mara, ruka hizi.

   https://api.coinmoebius.com/webhook/square/<your project id>

   ⤢

   Nambari ya mradi wako iko chini ya jina la mradi kwenye dashibodi ya Coin Moebius; iingize kwenye anwani hapo juu. Matukio ya ziada hayana madhara, tunapuuza chochote tusichokitumia. Kadi ya mtoa huduma iliyounganishwa (hatua ya mwisho) inaonyesha URL ileile kwa rejea.

7. Fungua usajili uliouunda

   Square huhifadhi usajili na kuuorodhesha chini ya Webhooks hali yake ikiwa Enabled. Bofya jina lake kufungua paneli ya maelezo ambapo funguo ya kutia sahihi ipo.

   ⤢
8. Nakili Signature key

   Katika paneli ya Properties ya usajili, bofya ikoni ya kunakili karibu na Signature key. Hii ndiyo thamani ambayo Coin Moebius hutumia kuthibitisha kila webhook ilitoka kweli kwa Square. Ipo tu baada ya usajili kuundwa, ndiyo maana webhook ilikuja kabla ya hatua ya kuunganisha.

   ⤢
9. Kurudi kwenye Coin Moebius: Ongeza mtoa huduma → Square

   Katika mradi wako, fungua kichupo cha Watoa huduma, bofya Ongeza mtoa huduma, chagua Unganisha huduma, na uchague Square. Weka Success URL na Cancel URL yako. Kwenye kichupo cha Live, bandika Access token, Webhook signature key, na Location ID yako, kisha ubofye Hifadhi. Unasanidi na vitambulisho vya sandbox kwanza? Badala yake vibandike kwenye kichupo cha Test, kisha uongeze vitambulisho vya live baadaye kutoka Hariri.

   ⤢
10. Umeunganishwa

    Square sasa inaonekana kwenye kichupo chako cha Watoa huduma na tarehe iliyounganishwa. Kadi inaonyesha URL ileile ya webhook uliyobandika kwenye Square, pamoja na Hariri na Tenganisha. Tumia kitufe cha kubadilisha Hali ya majaribio kupitia agizo la sandbox mwanzo hadi mwisho kabla ya kwenda live.

    ⤢

    Kadi za sandbox hazitozi kamwe kadi halisi. Tumia kadi 4111 1111 1111 1111, CVV 111, tarehe yoyote ya baadaye ya kuisha, msimbo wowote halali wa posta (kwa mfano 94103).

Baada ya kuunganisha

Endesha malipo moja ya majaribio kabla ya kuanza rasmi:

1. Unda bidhaa na uweke Mazingira yake kuwa Testing. Hilo huendesha bidhaa kwenye vibali vyako vya sandbox, ili uweze kuweka agizo kamili bila kuhamisha fedha. (Kama uliruka seti ya sandbox, bidhaa ya Testing hurudi kwa live, kwa hiyo iongeze kwanza.)
2. Weka kitufe cha kununua kwenye ukurasa (faili la HTML la ndani hufanya kazi) kilichoelekezwa kwenye mradi wako.
3. Maliza ununuzi na kadi ya majaribio ya sandbox kutoka hapo juu.
4. Fungua kichupo cha Miamala. Safu mpya hujitokeza, ikiwa imewekewa alama Testing. Hali yake inapofika succeeded, vibali vyako na webhook vyote vinafanya kazi mwanzo hadi mwisho.

Badilisha Mazingira ya bidhaa kuwa Live ukiwa tayari kwa malipo halisi.

Utatuzi wa matatizo

Anza na Verify. Kwenye dashibodi, bofya Verify (au Verify test credentials) kukagua access token na eneo lako.

Verify inashindwa.

Nakili tena access token na Location ID. Production na Sandbox zina tokeni tofauti, kwa hiyo usizichanganye.

Uthibitishaji wa sahihi unashindwa, au agizo linabaki linasubiri.

Square hutia sahihi juu ya URL kamili ya arifa pamoja na mwili. URL unayoisajili kwenye Square lazima ilingane na URL yako ya webhook herufi kwa herufi, bila slash ya mwisho na bila query string ya ziada. Kisha nakili tena signature key kutoka kituo kilekile.

Thibitisha mwanzo hadi mwisho.

Square Developer Console → Webhooks → usajili wako → Send Test Event, kisha utazame agizo likisasishwa.

Vizuri kujua

Sarafu hufuata eneo. Checkout hutoza katika sarafu ya eneo ambalo unatoa nambari yake.

Kuzungusha siri. Zungusha access token au signature key wakati wowote, kisha ubandike thamani mpya. Sehemu za siri hubaki tupu wakati wa kuhariri.

Maswali? Join our Discord