Anza kutumia
Tengeneza malipo yako ya kwanza kwenye sandbox ndani ya dakika chache.
Msingi mmoja, ujumuishaji mbili
Kila malipo ya Baraka Pay ni PaymentIntent — rekodi rasmi ya wajibu mmoja wa malipo. API ya moja kwa moja na malipo yanayohifadhiwa na Baraka Pay (hosted checkout) zote mbili huendesha PaymentIntent ile ile, hivyo hesabu zako haziwahi kutofautiana.
Ingia kwenye portal ya Developer ili kuunda ufunguo wa API wa sandbox, kisha uunde intent yako ya kwanza.
Kuunda PaymentIntent
Tuma kiasi katika vitengo vidogo (minor units), kumbukumbu ya muuzaji (merchant reference), na paymentType — kiashiria cha uelekezaji kinachochagua adapta ya mtoa huduma moja kwa moja (angalia Kuchagua aina ya malipo hapa chini). Maandishi yanayorudiwa (retried writes) lazima yabebe Idempotency-Key.
Thibitisha na subiri ukweli
Thibitisha intent; Baraka Pay hurejesha hatua inayofuata isiyoegemea upande wowote wa mtoa huduma. Baadhi ya aina za malipo (chapa za mobile money) zinahitaji msisdn ya mlipaji wakati wa confirm — angalia Kuchagua aina ya malipo. Chukulia webhook iliyotiwa saini (au utafutaji wa upande wa seva) kama ishara pekee inayothibitisha mafanikio.
Kuchagua aina ya malipo
paymentType ni katalogi tambarare: card, eft, qr, mpesa, airtel_money, orange_money, tigo_money, mtn_momo, apple_pay, google_pay, samsung_pay. Inachagua mtoa huduma moja kwa moja — familia (mfano, "wallet" kwa chapa za mobile money na pochi za kifaa) ni upangaji wa uonyeshaji tu, kamwe si uelekezaji.
msisdn inahitajika wakati wa confirm tu kwa aina za malipo za kifaa cha msisdn (chapa za mobile money); aina nyingine zinathibitisha bila hiyo na kuendesha uliobaki kupitia hatua inayofuata iliyorejeshwa.
Malipo yanayohifadhiwa (hosted checkout) hugawa paymentType kwa kuita select-method na chaguo la mlipaji kabla ya confirm; waitaji wa API ya moja kwa moja huiweka wakati wa create badala yake.