Paano gawin ang Integration?

Panimula

Ang dokumentong ito ay nagbibigay ng mga detalyadong hakbang para sa pag-set up ng iyong merchant profile, paggawa ng processing profile na may access sa merchant wallet, at pag-navigate sa parehong pagsubok (sandbox) at produksyon (live) na kapaligiran. Bukod pa rito, ginagabayan ka nito sa proseso ng pagdeposito gamit ang isang card, na sumasaklaw sa daloy, pagpapatunay, mga callback, paggawa ng transaksyon sa deposito, pag-setup ng webhook ng pag-apruba, pagsusuri ng katayuan, pag-apruba ng transaksyon, pagkansela, at mga pamamaraan sa pagsubok. Sundin ang mga seksyon sa ibaba upang pamahalaan ang iyong account at mga transaksyon nang mahusay.

1. Pag-setup ng Account

Gumawa ng 2 profile kung saan ang unang profile ay ang Merchant na mayroong wallet para makatanggap ng mga pondo at ang isa pang profile ay ang Processing na gagamitin para sa paggawa ng mga transaksyon sa account wallet ng merchant.

1.1 Gumawa ng profile ng merchant

Gumawa ng account sa pamamagitan ng pagrehistro mula sa Login screen. Gamitin ang link upang sundin ang mga hakbang ng pagiging isang Merchant.

1.2 Gumawa ng profile sa pagpoproseso na may access sa merchant wallet

Kinakailangan ang isang profile sa pagpoproseso upang pamahalaan ang mga transaksyon ng merchant. Gamitin ang link upang sundin ang mga hakbang sa paggawa ng profile sa pagpoproseso.

2. Kapaligiran at Pagpapatunayang

Bago simulan ang pagsasama ay kailangang malaman ng gumagamit ang tungkol sa magagamit na kapaligiran at mga pamamaraan ng pagpapatunay na kinakailangan para sa pagsasama. Gamitin ang link upang malaman ang tungkol sa mga detalyeng ito.

3. Magdeposito Gamit ang Card

3.1 Daloy

3.2 Mga Hakbangang

• Lumikha ng Transaksyon ng Deposito Gamit ang Card
• Maghintay ng callback.
• Suriin ang katayuan.

Pagkatapos mong tawagan ang Transaksyon/CardDeposit endpoint, isang kahilingan sa pagbabayad ang ipinadala sa network ng Acquirer upang iproseso ang pagbabayad sa card. Ang isang nakabinbing transaksyon ay ginawa din at ang Xprizo ay magpapatuloy sa pagsubaybay sa Acquirer network hanggang sa isang pag-apruba o pagtanggi ay matanggap.

Kung 'Naaprubahan' (2DS) ang card, idaragdag ang transaksyon sa wallet ng merchant at magbabalik ang API ng status na 'Aktibo'. Walang karagdagang aksyon ang kinakailangan.

Kung may problema sa paggawa ng transaksyon, magbabalik ang API ng status na 'Tinanggihan'.

Posibleng hindi agad naproseso ang isang card tulad ng ilang uri ng pagkaantala o maaaring kailanganin ng user na aprubahan ang transaksyon gamit ang ibang device, pagkatapos ay ibabalik ang status na 'Nakabinbin.'

Sa kaso ng 3DS, maaaring magkaroon ng pag-redirect sa isang kahaliling URL. Sa kasong ito, ibinalik ang isang 'Redirect' status at URL.

Makakakuha ang Merchant ng mga update sa status ng transaksyon sa pamamagitan ng mga callback. Upang makatanggap ng callback, kakailanganin mong hilingin na i-set up ito sa iyong Merchant account (ang profile na ginagamit upang gawin ang transaksyong ito). Magagawa ito sa pamamagitan ng pagpunta sa mga setting/kagustuhan at pagtatakda ng “Approval Webhook” upang tumuro sa isang URL na iyong pinili. Maaari mo ring itakda ito gamit ang Preference/SetApprovalWebhook

Isang callback ang ipapadala kapag

• Ang nakabinbing transaksyon ay ginawa.
• Ang nakabinbing transaksyon ay naaprubahan
• Ang nakabinbing transaksyon ay tinanggihan

Pwede mong gamitin ang link na ito upang makita ang darating na tugon sa Webhook na ito.

**Tandaan: Gayunpaman, dapat mong suriin ang katayuan, pagkatapos mong makakuha ng callback upang kumpirmahin na matagumpay na nakumpleto ang transaksyon. Pwede mong gamitin Transaksyon/Katayuan endpoint upang suriin ang katayuan.

4. Magdeposito Gamit ang Xprizo Wallet

Upang magdeposito, inililipat ang mga pondo mula sa wallet ng isang user patungo sa wallet ng merchant. Ginagawa ang prosesong ito sa pamamagitan ng paghiling ng bayad mula sa user sa pamamagitan ng Transaksyon/Kahilingang Pagbabayad endpoint.

4.1 Daloy

Ito ay isang halimbawa ng daloy na dapat gamitin kapag nagsasama sa Xprizo upang magsagawa ng mga deposito.

• (sa mangangalakal) Gumawa ng bagong transaksyon.
  • Gumawa ng reference na gagamitin para sa transaksyong ito.
  • Itakda ang transaksyon bilang nakabinbin.
• (sa Xprizo) Lumikha ng Xprizo na transaksyon.
  • Hanapin ang wallet ng user gamit ang kanilang numero ng telepono o email o username, at ang tinukoy na pera sa pamamagitan ng Wallet/Impormasyon endpoint.
  • Hanapin ang wallet ng merchant na may parehong pera gamit ang Wallet/Impormasyon endpoint.
  • Gumawa ng transaksyon gamit ang Transaksyon/Kahilingang Pagbabayad 
  • Maghintay para sa callback.
  • Suriin ang katayuan ng transaksyon Transaksyon/Katayuan endpoint.
• (sa mangangalakal) I-update o kanselahin ang transaksyon
  • Kung naaprubahan ang transaksyon, i-update ang status ng transaksyon sa iyong system.
  • Kung tinanggihan ang transaksyon, kanselahin ang transaksyon sa iyong system.

4.2 Mga hakbangang

• Gumawa ng Kahilingan sa pagbabayad
• Maghintay ng callback
• Suriin ang Katayuan

Kapag nakagawa ka na ng kahilingan sa pagbabayad, maghintay para sa isang callback na ipapadala sa sandaling maaprubahan ng user ang kahilingan. Bagama't hindi sapilitan ang paggamit ng mga callback, mas mahusay na gawin ito. Bilang kahalili, maaari mong direktang tawagan ang endpoint ng check status, ngunit hindi ito inirerekomenda dahil kakailanganin mong patuloy na i-poll ang server upang suriin ang status. Gamitin ang endpoint na ito para tingnan ang status Transaksyon/Katayuan.

Upang makatanggap ng mga callback, dapat mong i-set up ito sa iyong account (ang profile na ginagamit upang gawin ang transaksyong ito). Maaari mong i-set up ang callback sa pamamagitan ng pag-access sa mga setting/kagustuhan sa Xprizo. I-configure ang “Approval Webhook” sa iyong gustong API endpoint kung saan mo gustong matanggap ang callback. Bilang kahalili, maaari mong i-set up ito gamit ang Preference/SetApprovalWebhook endpoint.

5. Mga Deposito Gamit ang M-Pesa

Upang makatanggap ng mga deposito mula sa isang user sa pamamagitan ng M-Pesa, simulan ang isang deposito sa pamamagitan ng paglilipat ng mga pondo mula sa M-Pesa account ng user patungo sa wallet ng iyong merchant gamit ang Transaksyon/MPesaDeposit endpoint.

5.1 Daloy

5.2 Mga Hakbangang

• Magdagdag ng M-Pesa deposit Transaction
• Maghintay ng callback
• Suriin ang katayuan

Kapag natawagan mo na ang “MpesaDeposit” endpoint, isang kahilingan sa pagbabayad ang ipapadala sa M-Pesa network at pagkatapos ay kukumpirmahin ng user ang transaksyon sa kanilang telepono. Ang isang nakabinbing transaksyon ay nabuo din, at ang Xprizo ay patuloy na susubaybayan ang M-Pesa network hanggang sa isang kumpirmasyon o pagkabigo ay matanggap.

• Kung natanggap ang isang kumpirmasyon, ang nakabinbing transaksyon ay lilipat sa isang nakumpletong transaksyon.
• Kung kinansela ang transaksyon, bubuo ng notification na naglalaman ng mga detalye tungkol sa pagkansela at ipapadala sa account ng merchant.

Makakatanggap ang mga merchant ng mga update sa status ng transaksyon sa pamamagitan ng mga callback. Upang paganahin ang mga callback, kakailanganin mong i-configure ito sa iyong account (ang profile na ginamit upang gawin ang transaksyon). Magagawa mo ito sa pamamagitan ng pag-navigate sa mga setting/kagustuhan sa Xprizo at pag-configure sa "Approval Webhook" upang tumuro sa isang URL na iyong pinili. Bilang kahalili, maaari mong makamit ang parehong gamit ang Preference/SetApprovalWebhook endpoint.

Isang callback ang ipapadala kapag

• nalikha ang nakabinbing transaksyon.
• ang nakabinbing transaksyon ay naaprubahan
• kinansela ang nakabinbing transaksyon

Hindi mahigpit na kinakailangan na gumamit ng mga callback, mayroon kang opsyon na pana-panahong suriin ang katayuan ng transaksyon. Gayunpaman, hindi ito inirerekomenda dahil kakailanganin nitong patuloy na i-poll ang server upang masuri ang katayuan. Gayunpaman, ipinapayong i-verify ang status pagkatapos makatanggap ng callback upang matiyak na matagumpay na nakumpleto ang transaksyon.

Gamitin ang endpoint na ito para tingnan ang status Transaksyon/StatusByReference