Imali izinombolo ezipheleleyo
Yonke imali ingamayunithi amancane — amasenti — njengezinombolo ezipheleleyo. Akulazinombolo ezilamachaphaza ezidlulayo, ngakho akulalutho olugoqelwa ngokwehlukileyo kwelakho icele kulakwethu.
Abakhi
I-API yezinkokhelo ongayikhumbula lula.
IREST phezu kweHTTPS, iJSON ingena iphuma, i-idempotency kukho konke ukubhala, lama-webhooks azamayo futhi uze uwavume. Imali izinombolo ezipheleleyo ngamasenti, ngoba izinombolo ezilamachaphaza kazifanelanga ukuba seduze kwemali.
Indawo yokuzama kusukela ekuqaliseni
Ukubhala okungaphindwayo
Ama-webhooks asayiniweyo
# Charge a customer wallet
POST /v1/charges
Authorization: Bearer sk_live_...
Idempotency-Key: 8f14e45f-ea
{
"amount": 4500,
"currency": "USD",
"source": "wallet:+263771234567",
"reference": "INV-2048"
}
# 201 Created
{
"id": "chg_3Nk2...",
"status": "succeeded",
"amount": 4500,
"fee": 54,
"tax": 90,
"net": 4356
}
Izimiso
Izinqumo zokwakha ozahlangana lazo
Ukubhala kakuphindwa
Thumela i-Idempotency-Key kuyo yonke iPOST. Zama futhi kanenginengi njengoba uthanda; isikhiye esifanayo sibuyisela umphumela wakuqala esikhundleni sokukhokhisa kabili.
Izintengo zisobala
Yonke impendulo yokukhokhisa iphethe i-amount, i-fee, i-tax le-net njengezindawo ezehlukeneyo. Kawusoze udinge ukubala eyodwa usuka kwezinye.
Ama-webhooks ayazama futhi
Izenzakalo zizanywa futhi ngokuphumula amahora angu-24 uze ubuyisele u-2xx. Ngayinye iphethe isihloko sesiginetsha okumele usiqinisekise ungakathembi okuphakathi.
Izimo ziyaphela
Ukukhokhisa kuphela ngesucceeded, failed kumbe reversed. Akulalutho oluguqula isimo buthule ngemva kokuphela.
Izikhiye zilemikhawulo
Izikhiye ezikhutshwayo zingenza kuphela izinhloso zenkokhelo. Izikhiye eziyimfihlo kazifanelanga ukuba sekhodini yomsebenzisi loba endaweni yokugcina ikhodi.
Okutholakalayo
Ama-endpoint ozawasebenzisa
| Indawo yokuxhuma | Indlela | Okwenzayo |
|---|---|---|
| /v1/charges | POST | Ukuqoqa imali from a wallet, mobile money account or card. |
| /v1/charges/:id | GET | Thola ukukhokhisa lentengo yakho, umthelo lokuchasiswa kwemali eseleyo. |
| /v1/refunds | POST | Buyisela konke kumbe ingxenye yokukhokhisa; izintengo zibuyiselwa ngokulinganayo. |
| /v1/payouts | POST | Thumela imali esikhwameni, enomboleni yemali yefoni kumbe e-akhawuntini yebhanga. |
| /v1/payouts/batches | POST | Thumela kufike ku-5,000 wenkokhelo ngokubiza kanye; umugqa ngamunye uyaphumelela kumbe wehluleke wodwa. |
| /v1/balances | GET | Ibhalansi elikhona lelilindileyo, ngemali nganye. |
| /v1/settlements | GET | Ukukhokhelwa lohlu lokuthengiselana olungemuva kwakunye. |
| /v1/events | GET | Phinda izenzakalo ze-webhook ongabe uziphuthelwe. |
Webhooks
Qinisekisa ungakathembi
Sonke isenzakalo siphethe ThumaPay-Signature . Bala i-HMAC yokuphakathi okuluhlaza usebenzisa imfihlo yendawo yakho yokuxhuma uqathanise ngesikhathi esifanayo. Yala loba yini engaqondaniyo, njalo uyale isikhathi esidlula imizuzu emihlanu ukuvimbela ukuphindwa.
// Node — verify a webhook
const sig = req.headers['thumapay-signature'];
const expected = crypto
.createHmac('sha256', endpointSecret)
.update(req.rawBody)
.digest('hex');
if (!crypto.timingSafeEqual(
Buffer.from(sig),
Buffer.from(expected))) {
return res.status(400).end();
}
Imibuzo
Amanothi okuhlanganisa
Yebo. Izikhiye zendawo yokuzama zikhitshwa ngesikhathi esifanayo lezikhiye eziqotho njalo zenza okufanayo, kugoqela ukuthunyelwa kwe-webhook lokulingisa ukwehluleka. Akulamali ehambayo.
Indawo yokuzama iveza amanani abanga imiphumela ethile — imali enganeleyo, ukuqinisekiswa okuphelelwe yisikhathi, owamukelayo ongatholakalanga — ukuze wakhe ukuphatha amaphutha ungalindanga ukwehluleka okuqotho.
Imikhawulo ingesikhiye ngasinye njalo ibuyiselwa kuyo yonke impendulo ezihlokweni zemikhawulo. Ukukhokhela abanengi kubalwa njengesicelo esisodwa kungelani lokuthi milingaki imigqa — yikho okwenza kusetshenziswe.
Ibhalansi ligcinwa ngemali nganye njalo kaliguqulwa buthule. Nxa imali yokukhokha itshiyana leyebhalansi, ukubiza kuyehluleka esikhundleni sokusebenzisa izinga buthule.
Izikhiye zikhitshwa nxa i-akhawunti yakho yebhizimusi isiqinisekisiwe. Qalisa lokho ekhasini leBhizimusi; ukungena endaweni yokuzama kungavunyelwa ukuqinisekiswa kusaqhubeka.
Qalisa ukwakha ngayo lamuhla
Ukungena endaweni yokuzama kakulindi ukuqinisekiswa okugcweleyo. Thola izikhiye, uxhume ukukhokhisa, ubone ukuchasiswa kwentengo empendulweni yakho.