Mwubake kandi mugerageze muri MTN sandbox, mujye mubarizika key zose kuri server, kandi mwemere order ko yishyuye nyuma gusa y’uko server yanyu imaze kwemeza status na MTN. Airtel Money ikenera integration yayo cyangwa provider ihuza zombi.
Icyo kiba igihe umukiriya yishyuye
- Umukiriya ahitamo MTN MoMo kuri checkout agashyiramo nimero ye ya MTN.
- Server y’urubuga rwawe yohereza MTN request yo kwishyura amafaranga y’icyo cyemezo, hamwe na reference yihariye.
- Umukiriya ahabwa prompt kuri telefoni ye akemeza ukoresheje MoMo PIN ye. Urubuga rwawe ntirubona PIN na rimwe.
- MTN ivugurura iyo payment ikaba SUCCESSFUL cyangwa FAILED.
- Server yawe yemeza icyo gisubizo kuri MTN, hanyuma igashyiraho ko order yishyuwe no kohereza confirmation.
Mu nyandiko za developer za MTN ibi ni product ya Collections n’ikorwa ryayo ryo gusaba kwishyura. Ibyo muri aka gatabo byose bishingira ku mahame rimwe: order yishyuwe igihe MTN ibivuze, si igihe browser y’umukiriya isubiye kuri page yo kubashimira.
Ibyo ukeneye mbere yo kwandika code
| Ukeneye | Aho ibivuye |
|---|---|
| Konti ya developer | |
| Kwiyandikisha kuri product | Iyandikishe kuri product ya Collections. Portal iguha primary na secondary subscription key. |
| API user na API key byo muri sandbox | Bikorwa binyuze muri sandbox provisioning API, bigenewe testing gusa. |
| Live credentials | Bitangwa MTN imaze kwemeza business ku buryo bwo kwishyura bwa live. Baza MTN Rwanda ibyo business igomba gutanga. |
| Aho callback igomba kujya | Page iri kuri domain yawe, ikoreshwa na HTTPS, yakira ibisubizo by’akazi ko kwishyura. |
Banza ugerageze muri sandbox
Sandbox iguha uburyo bwo kugerageza flow yose utashyizemo amafaranga nyayo. Ibyanditswe na MTN byerekana ibintu bitatu by’ingenzi ugomba kumenya mbere yo gutangira:
Aho testing ikorerwa ni sandbox. Live payments ikoresha environment MTN iguha mu Rwanda. - Ifaranga rikoreshwa muri sandbox ni EUR. Live payments mu Rwanda ni amafaranga y’u Rwanda (RWF), bityo urebe neza ko ifaranga ari setting, atari code yanditse mu buryo buhoraho.
- MTN ishyiraho nimero zo kugerageza zigarura failure zidasanzwe, nko kutabona account cyangwa service itaboneka. Indi nimero yose itanga success.
Icyo cya nyuma ni ingenzi. Niba ugerageza ukoresheje nimero yawe gusa, payment zose zizagenda neza kandi inzira z’aho habaho failure ntizizigera zikora. Koresha test numbers za MTN urebe icyo umukiriya abona iyo payment yanze, n’ibiba kuri order.
Callbacks no kugenzura status
Hari uburyo bubiri bwo kumenya result ya payment. Server yawe ishobora kubaza MTN status ya request, cyangwa MTN igahamagarira callback address yawe igihe status ihindutse. Kugira ngo wakire callback, request igomba kuba irimo callback URL yawe, kandi iyo URL igomba gukoresha HTTPS.
Ibyanditswe na MTN bisobanutse neza ko callback yoherezwa inshuro imwe gusa, nta retry niba server yawe itayakiriye, kandi bigasaba kugenzura status nk’uburyo bwo gusimbura. Bityo bika byombi:
- Teza amatwi kuri callback, ariko uyifate nk’ikimenyetso cyo kugenzura, si gihamya.
- Banza ubaze MTN imiterere y’ishyurwa mbere yo gushyira icyemezo ko order yishyuye, kandi ugenzure ko amafaranga na reference bihura na order.
- Genzura payment zisigara pending nyuma y’iminota mike, kugira ngo callback yabura itazasiga customer yishyuye ategereje.
- Koresha reference imwe rimwe gusa. Callback isubiye ntigomba kurema order ya kabiri cyangwa delivery ya kabiri.
Komeza umutekano
- Bika API key na subscription key kuri server. Ntuzishyire muri browser code, muri theme file umuntu wese ashobora gukuramo, cyangwa muri public code repository.
- Kora reference nshya kuri buri kugerageza kwishyura kandi uyibike hamwe na order.
- Genzura nimero ya telefone mbere yo kohereza request. Nimero za MTN Rwanda zitangirira kuri 078 cyangwa 079.
- Bika log ya buri request n’igisubizo utabika amakuru yihariye arenze ayo ukeneye.
- Mwereke customer ubutumwa busobanutse mu gihe payment iri pending, n’inzira yo kugerageza nanone niba binaniwe.
Airtel Money ihita he
Kuyubaka muri WordPress
Ibindi byo gusoma
Igitabo cyemewe gisobanura ubuyobozi bwa tekiniki bukoreshwa muri iyi nkuru.
