Malipo ya kutoka
Kutuma fedha kwa mpokeaji unayemtaja. Imeundwa kukataa badala ya kubahatisha.
Malipo ya kutoka hupendelea kukataa
Malipo yanayoingia yakishindwa hukugharimu mauzo. Malipo ya kutoka yakikosea, fedha zimeenda, kwa mtu asiyedhibitiwa na yeyote, na mara nyingi hazirudi. Kila hali yenye utata katika API hii hukataa, hushikilia, au husubiri mtu — kama malipo ya kutoka yanaonekana kuwa na tahadhari zaidi kuliko API ya kuingiza, hivyo ndivyo ilivyokusudiwa.
Malipo ya kutoka yanapatikana katika Sandbox leo. Bado hakuna njia halisi ya malipo: usakinishaji wa Live hauna adapta iliyowashwa na kila malipo hapo hushindwa kwa usalama na provider_unavailable.
Vizuizi viwili kabla programu haijaweza kulipa
Uwezo wa kulipa nje hutolewa kwa kila mteja na kila mazingira, na wafanyakazi wa Baraka Pay, na umezimwa kwa chaguo-msingi. Kutokuwepo kwa mpangilio kunamaanisha hapana — kila ufunguo wa API uliokuwepo kabla ya malipo ya kutoka bado hauwezi kutuma fedha.
Mfanyabiashara anahitaji salio lililowekwa. Malipo ya kutoka hutolewa kwenye mapato yake, na hakuna mkopo: malipo yanayozidi salio lililopo hukataliwa na hakuna kinachohifadhiwa.
Katika Live, fedha zilizowasili punde haziwezi kutolewa mara moja — malipo yanayoingia hukaa kwa muda wa kushikiliwa kwanza. Mfanyabiashara hapotezi ufikiaji wa chochote; salio lake na malipo yake hayabadiliki. Hii inadhibiti tu kinachoweza kufadhili uhamisho usioweza kutenguliwa kwa mtu wa tatu, kwa sababu malipo yanayoingia yakitolewa kisha yakatenguliwa ni fedha zilizoenda mahali ambapo hakuna anayepadhibiti. Sandbox huweka muda huu sifuri ili uweze kujaribu kuingiza na kutoa kwa mpigo; usidhani Live inafanya vivyo hivyo.
Kuunda malipo ya kutoka
Tuma kiasi kwa vipimo vidogo, njia, kumbukumbu yako mwenyewe, na mahali pa kupeleka. Tumia merchantReference yako kama Idempotency-Key, kama ilivyo.
201 mara ya kwanza. 200 pamoja na malipo YA AWALI kama kumbukumbu hiyo imetumika hapo awali — tofauti hiyo ndiyo kinga nzima dhidi ya ombi lililorudiwa kumlipa mtu mara mbili, hivyo angalia msimbo wa hali badala ya kuupuuza.
Malipo ya kutoka yanahitaji ufunguo wa API, si kikao cha portal
Kuunda na kujaribu upya malipo hukataa kikao cha portal ya Merchant kwa api_key_required. Kusoma, kuorodhesha na kughairi bado hufanya kazi na kikao.
Kikao cha portal ni tokeni inayotegemea nenosiri pekee. Ufunguo wa API ni siri ya upande wa seva. Malipo ya kutoka huenda pale mwitaji anaposema, hivyo huidhinishwa na ile yenye nguvu zaidi — na nenosiri la portal lililoibiwa halibadiliki kuwa uwezo wa kutuma fedha. Marejesho bado huruhusu kikao cha portal kwa makusudi, kwa sababu marejesho hurudi kwa mlipaji wa awali na hayawezi kuelekezwa kwingine.
Idhini ni jambo la kawaida, si hitilafu
Malipo yanayozidi kikomo cha idhini ya kiotomatiki cha mfumo — na, kwa chaguo-msingi, kila malipo ya kwanza kwa mahali ambapo mfanyabiashara huyu hajawahi kulipa kwa mafanikio — hurudi kama requires_approval na kusubiri mfanyakazi wa Baraka Pay.
Kikomo ni namba moja kwa mfumo mzima, kwa kila sarafu, iliyowekwa na ofisi kuu. Malipo yasiyozidi kikomo huenda moja kwa moja. Mfumo usio na mipangilio hushikilia kila malipo hata madogo kiasi gani: mfumo ambao hakuna aliyeuweka mipangilio haupaswi kuwa mfumo unaotuma fedha bila mtu kuangalia.
Kusubiri kwa mahali papya si mashaka juu ya programu yako. Mahali papya kwa mpokeaji aliyeko tayari ndiyo namna ya kawaida ya wizi wa akaunti: mshambuliaji haongezi kiasi, anabadilisha mahali fedha zinapoenda. Panga kwa ajili ya kusubiri: hali ya ombi limewasilishwa na linakaguliwa ni hali ya kawaida.
Mahali pa kupeleka hurudi pakiwa pamefichwa, daima
Baraka Pay huhifadhi kitambulisho kizima kwa sababu njia ya malipo haiwezi kupewa mahali palipofichwa, na hairudishi kwa yeyote — si kwako, si kwenye foleni ya idhini ya wafanyakazi, si kwenye kumbukumbu za ukaguzi.
holderName inahitajika na si mapambo. Ndiyo sehemu pekee inayonasa namba iliyobadilishwa kabla fedha hazijaenda, na pale njia inapothibitisha majina, kutolingana hukataa malipo. Tuma jina ambalo akaunti ya mpokeaji inalo kweli, si lile lililo kwenye rekodi yako.
payout.returned ndiyo kanuni ambayo waunganishaji husahau
Matukio: payout.pending, payout.approved, payout.processing, payout.succeeded, payout.failed, payout.cancelled, payout.returned. Sahihi ile ile na kithibitishaji kile kile kama webhooks za kuingiza — vitumie bila mabadiliko, na usome upya malipo badala ya kuamini mwili wa ujumbe.
Malipo ya simu na benki hurudi nyuma. Pochi iliyofungwa, jina lisilolingana lililogunduliwa baadaye, uhamisho ulioitwa tena — siku kadhaa baada ya programu yako kumwambia mtumiaji fedha zimetumwa. Malipo hubadilika kutoka succeeded kwenda returned, ingizo la fidia hurudisha thamani, na payout.returned huwasilishwa. Programu yako lazima ishughulikie kutenguliwa kwa fedha ambazo tayari imezikopesha.
Baraka Pay habadilishi sarafu kwa malipo ya kutoka: sarafu ya mahali pa kupeleka lazima iwe sawa na ya malipo, na malipo ya sarafu tofauti hukataliwa, hayabadilishwi.