PayPal

Unachohitaji

Kwa nini tunauliza kila sehemu

Client ID

Hutambua programu yako ya PayPal kwenye miito ya API. Hufanya kazi tu inapooanishwa na Client secret.

Client secret

Nusu ya faragha ya uthibitishaji wa API. Pamoja na Client ID, hutuwezesha kuunda agizo, ili malipo yapite kwenye akaunti yako.

Webhook ID

Jinsi tunavyothibitisha webhook ni kweli kutoka PayPal: PayPal hutambua kila webhook kwa ID, na sisi tunaitumia kuiuliza PayPal moja kwa moja kama ujumbe fulani ni halisi. Hilo huzuia mtu yeyote kughushi tukio la "paid".

Success and Cancel URL

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

Sanidi

1. Fungua dashibodi ya Msanidi wa PayPal

   Ingia kwenye developer.paypal.com. PayPal hukupa Sandbox ya bure yenye akaunti za biashara na mnunuzi za bandia, ili uweze kujaribu bila kuhamisha fedha halisi. Mwongozo huu unatembea kwenye Sandbox; mtiririko wa Live ni sawa kabisa, badilisha tu kitufe cha Sandbox / Live (juu kushoto) na utumie akaunti ya PayPal ya Biashara. Kutoka kwenye dashibodi, fungua Apps & Credentials.

   ⤢
2. Unda programu

   Kwenye ukurasa wa API Credentials, thibitisha kitufe cha Sandbox kimechaguliwa, kisha ubofye Create App (juu kulia).

   ⤢
3. Ipe jina na uchague Merchant

   Ingiza App Name (kwa mfano "Coin Moebius"), acha Type kwenye Merchant, chagua akaunti yako ya biashara ya sandbox, na ubofye Create App.

   ⤢
4. Nakili Client ID na Client secret yako

   PayPal hufungua programu yako mpya. Nakili Client ID na ufunue na unakili Secret key. (Unaweza pia kunakili vyote viwili kutoka safu ya Default Application kwenye orodha ya API Credentials.) Viweke pembeni.

   ⤢

   ⤢

   Client secret ni siri, itendee kama nywila. Programu ya sandbox na programu ya live kila moja ina jozi yake, kwa hiyo usizichanganye.

5. Ongeza webhook

   Tembeza chini kwenye ukurasa wa programu hadi sehemu ya Sandbox Webhooks na ubofye Add Webhook. Katika sehemu ya Webhook URL, bandika anwani ya webhook ya PayPal ya mradi wako (hapa chini). Kisha chagua matukio ambayo Coin Moebius husikiliza, na ubofye Save.

   • Malipo ya mara moja: CHECKOUT.ORDER.APPROVED, PAYMENT.CAPTURE.COMPLETED, PAYMENT.CAPTURE.DENIED, PAYMENT.CAPTURE.DECLINED, PAYMENT.CAPTURE.REFUNDED, PAYMENT.CAPTURE.REVERSED, CUSTOMER.DISPUTE.CREATED.
   • Usajili (tu kama unauza): BILLING.SUBSCRIPTION.ACTIVATED, BILLING.SUBSCRIPTION.UPDATED, BILLING.SUBSCRIPTION.CANCELLED, BILLING.SUBSCRIPTION.PAYMENT.FAILED, PAYMENT.SALE.COMPLETED. Kama hufaidishi kwa msingi wa mara kwa mara, ruka hizi.
   • Unaharakisha? Kuchagua All Events (kadi ya wildcard juu) pia inafanya kazi, tunapuuza chochote tusichokitumia.

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

   ⤢

   Nambari ya mradi wako iko chini ya jina la mradi kwenye dashibodi ya Coin Moebius; iingize kwenye anwani hapo juu. Kadi ya mtoa huduma iliyounganishwa (hatua ya mwisho) inaonyesha URL ileile kwa rejea.

6. Nakili Webhook ID

   Webhook yako sasa inaonekana kwenye orodha ya Sandbox Webhooks. Nakili Webhook ID iliyoonyeshwa karibu nayo. Hivi ndivyo Coin Moebius inavyoomba PayPal kuthibitisha kila webhook ni ya kweli. Sajili webhook tofauti katika sandbox na katika live.

   ⤢
7. Kurudi kwenye Coin Moebius: Ongeza mtoa huduma → PayPal

   Katika mradi wako, fungua kichupo cha Watoa huduma, bofya Ongeza mtoa huduma, chagua Unganisha huduma, na uchague PayPal. Weka Success URL na Cancel URL yako. Unajaribu na vitambulisho vya sandbox? Tumia kichupo cha Test (cha hiari) na ubandike Client ID, Client secret, na Webhook ID yako huko, kisha ubofye Hifadhi. Unaenda moja kwa moja kwenye live? Tumia kichupo cha Live. Kundi la Test ni lote-au-bila: sehemu zote tatu, au hakuna.

   ⤢
8. Umeunganishwa

   PayPal sasa inaonekana kwenye kichupo chako cha Watoa huduma na tarehe iliyounganishwa (imewekewa alama TEST ulipotumia vitambulisho vya sandbox). Kadi inaonyesha URL ileile ya webhook uliyobandika kwenye PayPal, pamoja na Hariri na Tenganisha.

   ⤢
9. Jaribu na mnunuzi wa sandbox

   Kulipa kupitia checkout ya majaribio, unahitaji kuingia kwa mnunuzi wako wa sandbox. Katika PayPal, fungua Testing Tools → Sandbox Accounts kuona akaunti zako za bandia za Biashara na za Kibinafsi.

   ⤢
10. Pata maelezo ya kuingia kwa mnunuzi

    Fungua akaunti ya Kibinafsi (mnunuzi) kuona Taarifa yake ya Kuingia: URL ya sandbox, barua pepe, na nywila. Ingia kwenye sandbox.paypal.com na hizo wakati checkout ya majaribio inakuomba kulipa. Hakuna fedha halisi inayohama.

    ⤢

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 kwa kulipa na akaunti yako ya mnunuzi wa sandbox.
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 kwa sandbox) kukagua vibali vyako vya client.

Verify inashindwa.

Nakili tena Client ID na Client secret. Programu ya sandbox na programu ya live zina jozi tofauti, kwa hiyo usizichanganye.

Malipo yanakamilika lakini agizo linabaki linasubiri.

Webhook ID lazima itoke kwenye programu na mazingira yaleyale kama vibali vyako vya client. Vibali vya live vinahitaji webhook ID ya live. Thibitisha URL ya webhook inalingana.

Thibitisha mwanzo hadi mwisho.

PayPal Developer Dashboard → Webhooks Simulator: tuma tukio la sampuli kwenye URL yako ya webhook, kisha utazame agizo likisasishwa.

Vizuri kujua

Kuzungusha siri. Tengeneza client secret mpya wakati wowote, kisha uibandike. Sehemu za siri hubaki tupu wakati wa kuhariri.

Maswali? Join our Discord