{"id":4425,"date":"2024-02-09T23:35:30","date_gmt":"2024-02-09T19:35:30","guid":{"rendered":"https:\/\/xprizo.com\/?post_type=manual&#038;p=4425"},"modified":"2024-02-13T18:24:59","modified_gmt":"2024-02-13T14:24:59","slug":"how-to-do-integration","status":"publish","type":"manual","link":"https:\/\/xprizo.com\/sw\/manual\/how-to-do-integration\/","title":{"rendered":"Jinsi ya kufanya Integration?"},"content":{"rendered":"<h3 class=\"wp-block-heading\" id=\"bkmrk-introduction\"><strong>Utangulizi<\/strong><\/h3>\n\n\n\n<p id=\"bkmrk-this-document-provid\">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.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"bkmrk-account-setup\"><strong>1. Kuweka Akaunti<\/strong><\/h3>\n\n\n\n<p id=\"bkmrk-create-2-profiles-wh\">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.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"bkmrk-create-a-merchant-pr\"><strong>1.1 Unda wasifu wa mfanyabiashara<\/strong><\/h4>\n\n\n\n<p id=\"bkmrk-create-an-account-by\">Unda akaunti kwa kujiandikisha kutoka kwa skrini ya Kuingia. Tumia\u00a0<a href=\"https:\/\/xprizo.com\/sw\/manual\/how-to-become-a-merchant\/\" target=\"_blank\" rel=\"noreferrer noopener\">kiungo<\/a>\u00a0kufuata hatua za kuwa Mfanyabiashara.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"bkmrk-create-a-processing-\"><strong>1.2 Unda wasifu wa kuchakata na ufikiaji wa pochi ya mfanyabiashara<\/strong><\/h4>\n\n\n\n<p id=\"bkmrk-a-processing-profile\">Wasifu wa kuchakata unahitajika ili kudhibiti miamala ya mfanyabiashara. Tumia\u00a0<a href=\"https:\/\/xprizo.com\/sw\/manual\/processing-profile-creation\/\" target=\"_blank\" rel=\"noreferrer noopener\">kiungo<\/a>\u00a0kufuata hatua za kuunda wasifu wa usindikaji.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"bkmrk-2.-environment-%26-aut\"><strong>2. Mazingira &amp; Uthibitishaji<\/strong><a href=\"https:\/\/xprizo-doc.azurewebsites.net\/docs\/intro#environment\" target=\"_blank\" rel=\"noopener\">.<\/a><\/h3>\n\n\n\n<p id=\"bkmrk-url-for-production-s\">Kabla ya kuanza mtumiaji wa ujumuishaji anahitaji kujua kuhusu mazingira yanayopatikana na mbinu za uthibitishaji zinazohitajika kwa ujumuishaji. Tumia\u00a0<a href=\"https:\/\/xprizo.com\/sw\/api-manual\/introduction\/\" target=\"_blank\" rel=\"noreferrer noopener\">kiungo<\/a>\u00a0kujifunza kuhusu maelezo haya.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"bkmrk-deposit-using-card\"><strong>3. Amana Kwa Kutumia Kadi<\/strong><\/h3>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"bkmrk-flow%E2%80%8B\"><strong>3.1 Mtiririko<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-image size-large\"><img fetchpriority=\"high\" decoding=\"async\" width=\"1024\" height=\"723\" src=\"https:\/\/xprizo.com\/wp-content\/uploads\/2024\/02\/user-journey-mapping-20-1024x723.jpg\" alt=\"\" class=\"wp-image-4477\" srcset=\"https:\/\/xprizo.com\/wp-content\/uploads\/2024\/02\/user-journey-mapping-20-1024x723.jpg 1024w, https:\/\/xprizo.com\/wp-content\/uploads\/2024\/02\/user-journey-mapping-20-300x212.jpg 300w, https:\/\/xprizo.com\/wp-content\/uploads\/2024\/02\/user-journey-mapping-20-768x543.jpg 768w, https:\/\/xprizo.com\/wp-content\/uploads\/2024\/02\/user-journey-mapping-20-18x12.jpg 18w, https:\/\/xprizo.com\/wp-content\/uploads\/2024\/02\/user-journey-mapping-20.jpg 1189w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"bkmrk-steps%E2%80%8B\"><strong>3.2 Hatua<\/strong><a href=\"https:\/\/xprizo-doc.azurewebsites.net\/docs\/merchants\/card-deposits#steps\" target=\"_blank\" rel=\"noopener\">.<\/a><\/h4>\n\n\n\n<ul class=\"wp-block-list\" id=\"bkmrk-add-a-card-deposit-t\">\n<li>Unda Muamala wa Amana kwa Kutumia Kadi<\/li>\n\n\n\n<li>Subiri upige simu.<\/li>\n\n\n\n<li>Angalia hali.<\/li>\n<\/ul>\n\n\n\n<p id=\"bkmrk-after-you-have-calle\">Baada ya kuwaita\u00a0<a href=\"https:\/\/xprizo.com\/sw\/api-manual\/transaction-endpoints-api-transaction\/\" target=\"_blank\" rel=\"noreferrer noopener\">Muamala\/KadiAmana<\/a>\u00a0mwisho, 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.<\/p>\n\n\n\n<p id=\"bkmrk-if-the-card-is-%27appr\">Ikiwa kadi &#039;Imeidhinishwa&#039; (2DS) basi muamala utaongezwa kwenye pochi ya muuzaji na API itarudisha hali ya &#039;Inayotumika&#039;. Hakuna hatua zaidi inayohitajika.<\/p>\n\n\n\n<p id=\"bkmrk-if-there-is-a-proble\">Ikiwa kuna tatizo la kuunda muamala basi API itarudisha hali ya &#039;Imekataliwa&#039;.<\/p>\n\n\n\n<p id=\"bkmrk-it-is-possible-that-\">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 &#039;Inasubiri&#039; itarejeshwa.<\/p>\n\n\n\n<p id=\"bkmrk-in-the-case-of-3ds%2C-\">Kwa upande wa 3DS, kunaweza kuwa na uelekezaji upya kwa URL mbadala. Katika hali hii, hali ya &#039;Elekeza Upya&#039; na URL inarejeshwa.<\/p>\n\n\n\n<p id=\"bkmrk-the-merchant-will-ge\">Muuzaji atapata masasisho kuhusu hali ya muamala kupitia simu.<strong>\u00a0Ili kupokea kupigiwa simu, utahitaji kuomba kusanidi hii kwenye akaunti yako ya Muuzaji (wasifu unaotumika kuunda muamala huu).<\/strong>\u00a0Hili linaweza kufanywa kwa kwenda kwa mipangilio\/mapendeleo na kuweka &quot;Idhini ya Wavuti&quot; ili kuelekeza kwenye URL ya chaguo lako. Unaweza pia kuweka hii kwa kutumia\u00a0<a href=\"https:\/\/xprizo.com\/sw\/api-manual\/preference-endpoints-api-preference\/\" target=\"_blank\" rel=\"noreferrer noopener\">Upendeleo\/SetApprovalWebhook<\/a><\/p>\n\n\n\n<p id=\"bkmrk-a-callback-will-be-s\">Simu itatumwa lini<\/p>\n\n\n\n<ul class=\"wp-block-list\" id=\"bkmrk-the-pending-transact\">\n<li>Muamala unaosubiri umeundwa.<\/li>\n\n\n\n<li>Muamala unaosubiri umeidhinishwa<\/li>\n\n\n\n<li>Muamala unaosubiri umekataliwa<\/li>\n<\/ul>\n\n\n\n<p id=\"bkmrk-you-can-use-this-lin\">Unaweza kutumia&nbsp;<a href=\"https:\/\/books.xprizo.com\/link\/22#bkmrk-approved-transaction\" target=\"_blank\" rel=\"noreferrer noopener\">kiungo hiki<\/a>&nbsp;kuona jibu likija kwenye Webbook hii.<\/p>\n\n\n\n<p id=\"bkmrk-you-should%2C-however%2C\"><strong>**Kumbuka: Unapaswa, hata hivyo, kuangalia hali, baada ya kupata simu tena ili kuthibitisha kwamba muamala umekamilika. Unaweza kutumia&nbsp;<a href=\"https:\/\/books.xprizo.com\/link\/22#bkmrk-transaction-status-c\" target=\"_blank\" rel=\"noreferrer noopener\">Muamala\/Hali<\/a>&nbsp;mwisho ili kuangalia hali.<\/strong><\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"bkmrk-4.-deposit-using-xpr\"><strong>4. Amana kwa kutumia Xprizo Wallet<\/strong><\/h3>\n\n\n\n<p id=\"bkmrk-to-make-a-deposit%2C-f\">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&nbsp;<a href=\"https:\/\/books.xprizo.com\/link\/22#bkmrk-create-payment-reque\" target=\"_blank\" rel=\"noreferrer noopener\">Muamala\/OmbiMalipo<\/a>&nbsp;mwisho.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"bkmrk-4.1-flow-0\"><strong>4.1 Mtiririko<\/strong><\/h4>\n\n\n\n<p>Huu ni mfano wa mtiririko ambao unapaswa kutumika wakati wa kuunganishwa na Xprizo ili kutekeleza amana.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><em>(kwa mfanyabiashara)<\/em>&nbsp;Unda muamala mpya.\n<ul class=\"wp-block-list\">\n<li>Unda rejeleo la kutumika kwa shughuli hii ya ununuzi.<\/li>\n\n\n\n<li>Weka shughuli kama inasubiri.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><em>(kwenye XPrizo)<\/em>&nbsp;Unda muamala wa XPrizo.\n<ul class=\"wp-block-list\">\n<li>Tafuta pochi ya mtumiaji ukitumia nambari yake ya simu au barua pepe au jina la mtumiaji, na sarafu iliyobainishwa kupitia&nbsp;<a href=\"https:\/\/books.xprizo.com\/link\/32#bkmrk-update-approval-webh\" target=\"_blank\" rel=\"noreferrer noopener\">Mkoba\/Maelezo<\/a>&nbsp;mwisho.<\/li>\n\n\n\n<li>Tafuta pochi ya mfanyabiashara yenye sarafu sawa kwa kutumia&nbsp;<a href=\"https:\/\/books.xprizo.com\/link\/32#bkmrk-update-approval-webh\" target=\"_blank\" rel=\"noreferrer noopener\">Mkoba\/Maelezo<\/a>&nbsp;mwisho.<\/li>\n\n\n\n<li>Tengeneza muamala kwa kutumia&nbsp;<a href=\"https:\/\/books.xprizo.com\/link\/22#bkmrk-create-payment-reque\" target=\"_blank\" rel=\"noreferrer noopener\">Muamala\/OmbiMalipo<\/a>&nbsp;<\/li>\n\n\n\n<li>Subiri simu irudishwe.<\/li>\n\n\n\n<li>Angalia hali ya muamala&nbsp;<a href=\"https:\/\/books.xprizo.com\/link\/22#bkmrk-transaction-status-c\" target=\"_blank\" rel=\"noreferrer noopener\">Muamala\/Hali<\/a>&nbsp;mwisho.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><em>(kwa mfanyabiashara)<\/em>&nbsp;Sasisha au ghairi muamala\n<ul class=\"wp-block-list\">\n<li>Ikiwa muamala umeidhinishwa, sasisha hali ya muamala katika mfumo wako.<\/li>\n\n\n\n<li>Ikiwa muamala umekataliwa, ghairi muamala kwenye mfumo wako.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"381\" src=\"https:\/\/xprizo.com\/wp-content\/uploads\/2024\/02\/user-journey-mapping-21-1024x381.jpg\" alt=\"\" class=\"wp-image-4478\" srcset=\"https:\/\/xprizo.com\/wp-content\/uploads\/2024\/02\/user-journey-mapping-21-1024x381.jpg 1024w, https:\/\/xprizo.com\/wp-content\/uploads\/2024\/02\/user-journey-mapping-21-300x112.jpg 300w, https:\/\/xprizo.com\/wp-content\/uploads\/2024\/02\/user-journey-mapping-21-768x286.jpg 768w, https:\/\/xprizo.com\/wp-content\/uploads\/2024\/02\/user-journey-mapping-21-1536x572.jpg 1536w, https:\/\/xprizo.com\/wp-content\/uploads\/2024\/02\/user-journey-mapping-21-18x7.jpg 18w, https:\/\/xprizo.com\/wp-content\/uploads\/2024\/02\/user-journey-mapping-21.jpg 1638w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"bkmrk-4.2-steps%E2%80%8B-0\"><strong>4.2&nbsp;<\/strong><strong>Hatua<\/strong><a href=\"https:\/\/xprizo-doc.azurewebsites.net\/docs\/merchants\/deposits#steps\" target=\"_blank\" rel=\"noopener\">.<\/a><\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Unda Ombi la malipo<\/li>\n\n\n\n<li>Subiri upigie simu<\/li>\n\n\n\n<li>Angalia Hali<\/li>\n<\/ul>\n\n\n\n<p>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&nbsp;<a href=\"https:\/\/books.xprizo.com\/link\/22#bkmrk-transaction-status-c\" target=\"_blank\" rel=\"noreferrer noopener\">Muamala\/Hali<\/a>.<\/p>\n\n\n\n<p>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 &quot;Idhini ya Webhook&quot; hadi mwisho wa API unayotaka ambapo ungependa kupokea simu. Vinginevyo, unaweza kusanidi hii kwa kutumia&nbsp;<a href=\"https:\/\/books.xprizo.com\/link\/31#bkmrk-update-approval-webh\" target=\"_blank\" rel=\"noreferrer noopener\">Upendeleo\/SetApprovalWebhook<\/a>&nbsp;mwisho.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"bkmrk-5.-deposits-using-m--0\"><strong>5. Amana Kwa Kutumia M-Pesa<\/strong><\/h3>\n\n\n\n<p>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&nbsp;<a href=\"https:\/\/books.xprizo.com\/link\/22#bkmrk-create-deposit-reque\" target=\"_blank\" rel=\"noreferrer noopener\">Muamala\/MPesaAmana<\/a>&nbsp;mwisho.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"bkmrk-5.1-flow%E2%80%8B\"><strong>5.1&nbsp;<\/strong><strong>Mtiririko<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-image size-large\"><img fetchpriority=\"high\" decoding=\"async\" width=\"1024\" height=\"723\" src=\"https:\/\/xprizo.com\/wp-content\/uploads\/2024\/02\/user-journey-mapping-20-1024x723.jpg\" alt=\"\" class=\"wp-image-4477\" srcset=\"https:\/\/xprizo.com\/wp-content\/uploads\/2024\/02\/user-journey-mapping-20-1024x723.jpg 1024w, https:\/\/xprizo.com\/wp-content\/uploads\/2024\/02\/user-journey-mapping-20-300x212.jpg 300w, https:\/\/xprizo.com\/wp-content\/uploads\/2024\/02\/user-journey-mapping-20-768x543.jpg 768w, https:\/\/xprizo.com\/wp-content\/uploads\/2024\/02\/user-journey-mapping-20-18x12.jpg 18w, https:\/\/xprizo.com\/wp-content\/uploads\/2024\/02\/user-journey-mapping-20.jpg 1189w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"bkmrk-5.2-steps%E2%80%8B\"><strong>5.2 Hatua<\/strong><a href=\"https:\/\/xprizo-doc.azurewebsites.net\/docs\/merchants\/card-deposits#steps\" target=\"_blank\" rel=\"noopener\">.<\/a><\/h4>\n\n\n\n<ul class=\"wp-block-list\" id=\"bkmrk-add-an-m-pesa-deposi\">\n<li>Ongeza Muamala wa amana ya M-Pesa<\/li>\n\n\n\n<li>Subiri upigie simu<\/li>\n\n\n\n<li>Angalia hali<\/li>\n<\/ul>\n\n\n\n<p>Baada ya kupiga simu &quot;MpesaDeposit&quot;, 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.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Iwapo uthibitisho utapokelewa, muamala unaosubiri utabadilika kuwa muamala uliokamilika.<\/li>\n\n\n\n<li>Ikiwa muamala utaghairiwa, arifa iliyo na maelezo kuhusu kughairiwa itatolewa na kutumwa kwa akaunti ya mfanyabiashara.<\/li>\n<\/ul>\n\n\n\n<p>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 &quot;Appival Webhook&quot; ili kuelekeza kwenye URL ya chaguo lako. Vinginevyo, unaweza kufikia sawa kwa kutumia&nbsp;<a href=\"https:\/\/books.xprizo.com\/link\/31#bkmrk-update-approval-webh\" target=\"_blank\" rel=\"noreferrer noopener\">Upendeleo\/SetApprovalWebhook<\/a>&nbsp;mwisho.<\/p>\n\n\n\n<p>Simu itatumwa lini<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>shughuli inayosubiri imeundwa.<\/li>\n\n\n\n<li>muamala unaosubiri umeidhinishwa<\/li>\n\n\n\n<li>muamala unaosubiri umeghairiwa<\/li>\n<\/ul>\n\n\n\n<p>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.<\/p>\n\n\n\n<p>Tumia sehemu hii ya mwisho kuangalia hali&nbsp;<a href=\"https:\/\/books.xprizo.com\/link\/22#bkmrk-transaction-status-c\" target=\"_blank\" rel=\"noreferrer noopener\">Muamala\/HaliKwaRejelea<\/a><\/p>","protected":false},"template":"","manual-category":[38],"class_list":["post-4425","manual","type-manual","status-publish","hentry","manual-category-merchant-manual"],"uagb_featured_image_src":[],"uagb_author_info":{"display_name":"Alan Loh","author_link":"https:\/\/xprizo.com\/sw\/author\/"},"uagb_comment_info":0,"uagb_excerpt":"Introduction This document provides detailed steps for setting up your merchant profile, creating a processing profile with access to the merchant wallet, and navigating through both testing (sandbox) and production (live) environments. Additionally, it walks you through the deposit process using a card, covering the flow, validation, callbacks, deposit transaction creation, approval webhook setup, status&hellip;","_links":{"self":[{"href":"https:\/\/xprizo.com\/sw\/wp-json\/wp\/v2\/manual\/4425","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/xprizo.com\/sw\/wp-json\/wp\/v2\/manual"}],"about":[{"href":"https:\/\/xprizo.com\/sw\/wp-json\/wp\/v2\/types\/manual"}],"version-history":[{"count":0,"href":"https:\/\/xprizo.com\/sw\/wp-json\/wp\/v2\/manual\/4425\/revisions"}],"wp:attachment":[{"href":"https:\/\/xprizo.com\/sw\/wp-json\/wp\/v2\/media?parent=4425"}],"wp:term":[{"taxonomy":"manual-category","embeddable":true,"href":"https:\/\/xprizo.com\/sw\/wp-json\/wp\/v2\/manual-category?post=4425"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}