Jinsi ya kufanya Integration?

Utangulizi

Hati hii inatoa hatua za kina za kusanidi wasifu wako wa muuzaji, kuunda wasifu wa kuchakata na ufikiaji wa pochi ya mfanyabiashara, na kupitia mazingira ya majaribio (sanduku la mchanga) na uzalishaji (moja kwa moja). Zaidi ya hayo, inakupitisha katika mchakato wa kuweka pesa kwa kutumia kadi, inayoshughulikia mtiririko, uthibitishaji, upigaji simu, uundaji wa miamala ya amana, usanidi wa uidhinishaji wa wavuti, kuangalia hali, idhini ya muamala, kughairiwa na taratibu za majaribio. Fuata sehemu zilizo hapa chini ili kudhibiti akaunti yako na miamala kwa ufanisi.

1. Kuweka Akaunti

Unda wasifu 2 ambapo wasifu wa kwanza utakuwa wa Mfanyabiashara akiwa na pochi ya kuweza kupokea pesa na wasifu mwingine utakuwa wa Uchakataji ambao utatumika kutengeneza miamala kwenye pochi ya akaunti ya mfanyabiashara.

1.1 Unda wasifu wa mfanyabiashara

Unda akaunti kwa kujiandikisha kutoka kwa skrini ya Kuingia. Tumia kiungo kufuata hatua za kuwa Mfanyabiashara.

1.2 Unda wasifu wa kuchakata na ufikiaji wa pochi ya mfanyabiashara

Wasifu wa kuchakata unahitajika ili kudhibiti miamala ya mfanyabiashara. Tumia kiungo kufuata hatua za kuunda wasifu wa usindikaji.

2. Mazingira & Uthibitishaji.

Kabla ya kuanza mtumiaji wa ujumuishaji anahitaji kujua kuhusu mazingira yanayopatikana na mbinu za uthibitishaji zinazohitajika kwa ujumuishaji. Tumia kiungo kujifunza kuhusu maelezo haya.

3. Amana Kwa Kutumia Kadi

3.1 Mtiririko

3.2 Hatua.

• Unda Muamala wa Amana kwa Kutumia Kadi
• Subiri upige simu.
• Angalia hali.

Baada ya kuwaita Muamala/KadiAmana mwisho, ombi la malipo hutumwa kwa mtandao wa Acquirer ili kuchakata malipo ya kadi. Muamala unaosubiri pia kuundwa na Xprizo itaendelea kufuatilia mtandao wa Mpokeaji hadi idhini au kukataliwa kutakapopokelewa.

Ikiwa kadi 'Imeidhinishwa' (2DS) basi muamala utaongezwa kwenye pochi ya muuzaji na API itarudisha hali ya 'Inayotumika'. Hakuna hatua zaidi inayohitajika.

Ikiwa kuna tatizo la kuunda muamala basi API itarudisha hali ya 'Imekataliwa'.

Inawezekana kwamba kadi haijachakatwa mara moja kama vile aina fulani ya ucheleweshaji au mtumiaji anaweza kuhitaji kuidhinisha muamala kwa kutumia kifaa kingine, kisha hali ya 'Inasubiri' itarejeshwa.

Kwa upande wa 3DS, kunaweza kuwa na uelekezaji upya kwa URL mbadala. Katika hali hii, hali ya 'Elekeza Upya' na URL inarejeshwa.

Muuzaji atapata masasisho kuhusu hali ya muamala kupitia simu. Ili kupokea kupigiwa simu, utahitaji kuomba kusanidi hii kwenye akaunti yako ya Muuzaji (wasifu unaotumika kuunda muamala huu). Hili linaweza kufanywa kwa kwenda kwa mipangilio/mapendeleo na kuweka "Idhini ya Wavuti" ili kuelekeza kwenye URL ya chaguo lako. Unaweza pia kuweka hii kwa kutumia Upendeleo/SetApprovalWebhook

Simu itatumwa lini

• Muamala unaosubiri umeundwa.
• Muamala unaosubiri umeidhinishwa
• Muamala unaosubiri umekataliwa

Unaweza kutumia kiungo hiki kuona jibu likija kwenye Webbook hii.

**Kumbuka: Unapaswa, hata hivyo, kuangalia hali, baada ya kupata simu tena ili kuthibitisha kwamba muamala umekamilika. Unaweza kutumia Muamala/Hali mwisho ili kuangalia hali.

4. Amana kwa kutumia Xprizo Wallet

Ili kuweka pesa, pesa huhamishwa kutoka kwa mkoba wa mtumiaji hadi kwa mkoba wa mfanyabiashara. Utaratibu huu unafanywa kwa kuomba malipo kutoka kwa mtumiaji kupitia Muamala/OmbiMalipo mwisho.

4.1 Mtiririko

Huu ni mfano wa mtiririko ambao unapaswa kutumika wakati wa kuunganishwa na Xprizo ili kutekeleza amana.

• (kwa mfanyabiashara) Unda muamala mpya.
  • Unda rejeleo la kutumika kwa shughuli hii ya ununuzi.
  • Weka shughuli kama inasubiri.
• (kwenye XPrizo) Unda muamala wa XPrizo.
  • Tafuta pochi ya mtumiaji ukitumia nambari yake ya simu au barua pepe au jina la mtumiaji, na sarafu iliyobainishwa kupitia Mkoba/Maelezo mwisho.
  • Tafuta pochi ya mfanyabiashara yenye sarafu sawa kwa kutumia Mkoba/Maelezo mwisho.
  • Tengeneza muamala kwa kutumia Muamala/OmbiMalipo 
  • Subiri simu irudishwe.
  • Angalia hali ya muamala Muamala/Hali mwisho.
• (kwa mfanyabiashara) Sasisha au ghairi muamala
  • Ikiwa muamala umeidhinishwa, sasisha hali ya muamala katika mfumo wako.
  • Ikiwa muamala umekataliwa, ghairi muamala kwenye mfumo wako.

4.2 Hatua.

• Unda Ombi la malipo
• Subiri upigie simu
• Angalia Hali

Baada ya kutuma ombi la malipo, subiri simu itakayotumwa mara tu mtumiaji atakapoidhinisha ombi hilo. Ingawa sio lazima kutumia njia za kurudi nyuma, ni bora zaidi kufanya hivyo. Vinginevyo, unaweza kupiga simu moja kwa moja sehemu ya mwisho ya hali ya kuangalia, lakini hii haipendekezwi kwani utahitaji kupigia kura seva mara kwa mara ili kuangalia hali. Tumia sehemu hii ya mwisho kuangalia hali Muamala/Hali.

Ili kupokea simu, lazima uweke mipangilio hii kwenye akaunti yako (wasifu unaotumika kuunda muamala huu). Unaweza kusanidi urejeshaji simu kwa kufikia mipangilio/mapendeleo katika Xprizo. Sanidi "Idhini ya Webhook" hadi mwisho wa API unayotaka ambapo ungependa kupokea simu. Vinginevyo, unaweza kusanidi hii kwa kutumia Upendeleo/SetApprovalWebhook mwisho.

5. Amana Kwa Kutumia M-Pesa

Ili kupokea amana kutoka kwa mtumiaji kupitia M-Pesa, anzisha amana kwa kuhamisha fedha kutoka kwa akaunti ya M-Pesa ya mtumiaji hadi kwenye pochi ya mfanyabiashara wako kwa kutumia Muamala/MPesaAmana mwisho.

5.1 Mtiririko

5.2 Hatua.

• Ongeza Muamala wa amana ya M-Pesa
• Subiri upigie simu
• Angalia hali

Baada ya kupiga simu "MpesaDeposit", ombi la malipo hutumwa kwa mtandao wa M-Pesa na kisha mtumiaji atathibitisha muamala kwenye simu yake. Muamala unaosubiri kutekelezwa pia utatolewa, na Xprizo itaendelea kufuatilia mtandao wa M-Pesa hadi uthibitisho au kutofaulu kupokelewa.

• Iwapo uthibitisho utapokelewa, muamala unaosubiri utabadilika kuwa muamala uliokamilika.
• Ikiwa muamala utaghairiwa, arifa iliyo na maelezo kuhusu kughairiwa itatolewa na kutumwa kwa akaunti ya mfanyabiashara.

Wauzaji watapokea masasisho kuhusu hali ya muamala kupitia simu. Ili kuwezesha upigaji simu, utahitaji kusanidi hii kwenye akaunti yako (wasifu uliotumiwa kuunda muamala). Unaweza kukamilisha hili kwa kuenda kwenye mipangilio/mapendeleo katika Xprizo na kusanidi "Appival Webhook" ili kuelekeza kwenye URL ya chaguo lako. Vinginevyo, unaweza kufikia sawa kwa kutumia Upendeleo/SetApprovalWebhook mwisho.

Simu itatumwa lini

• shughuli inayosubiri imeundwa.
• muamala unaosubiri umeidhinishwa
• muamala unaosubiri umeghairiwa

Sio lazima kabisa kutumia simu, una chaguo la kuangalia mara kwa mara hali ya muamala. Hata hivyo, haipendekezwi kwani itahitaji kupigia kura seva mara kwa mara ili kuangalia hali. Hata hivyo, inashauriwa kuthibitisha hali baada ya kupokea simu ili kuhakikisha kuwa shughuli hiyo imekamilika.

Tumia sehemu hii ya mwisho kuangalia hali Muamala/HaliKwaRejelea