Mari inhamba dzakazara
Mari yose iri muzviyero zvidiki — masendi — senhamba dzakazara. Hapana dhesimari inopfuura, saka hapana chinotenderedzwa zvakasiyana kudivi rako nekudivi redu.
Vagadziri
API yekubhadhara yaunogona kurangarira nyore.
REST paHTTPS, JSON ichipinda nekubuda, idempotency pakunyora kwose, uye webhooks dzinoedzazve kusvika wagamuchira. Mari inhamba dzakazara musendi, nekuti nhamba dzine dhesimari hadzifaniri kuva pedyo nemari.
Nzvimbo yekuedza kubva pazuva rekutanga
Kunyora kusingadzokorori
Webhooks dzakasainwa
# 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
}
Nheyo
Sarudzo dzekugadzira dzauchasangana nadzo
Kunyora hakudzokorori
Tumira Idempotency-Key paPOST yose. Edzazve kakawanda sezvaunoda; kiyi imwe chete inodzosa mhedzisiro yekutanga pane kubhadharisa kaviri.
Mitengo iri pachena
Mhinduro yekubhadharisa yose ine amount, fee, tax uye net semunda yakasiyana. Haumbofaniri kuverenga imwe uchibva pane dzimwe.
Webhooks dzinoedzazve
Zviitiko zvinoedzwazve zvichinonoka kwemaawa 24 kusvika wadzosa 2xx. Chimwe nechimwe chine musoro wesaini waunofanira kusimbisa usati wavimba nezviri mukati.
Mamiriro anopedzisira
Kubhadharisa kunopera nesucceeded, failed kana reversed. Hapana chinochinja mamiriro chakanyarara mushure mekunge kwapera.
Makiyi ane miganho
Makiyi anoburitswa pachena anongogona kugadzira zvinangwa zvemubhadharo. Makiyi akavanzika haafaniri kuva mukodhi yemushandisi kana muhomwe yekodhi.
Zvinowanikwa
Ma-endpoint auchashandisa chaizvo
| Nzvimbo yekubata | Nzira | Zvainoita |
|---|---|---|
| /v1/charges | POST | Kuunganidza mari from a wallet, mobile money account or card. |
| /v1/charges/:id | GET | Tora kubhadharisa nemutengo wako, mutero uye tsananguro yemari yasara. |
| /v1/refunds | POST | Dzosera yose kana chikamu chekubhadharisa; mitengo inodzoserwa maererano. |
| /v1/payouts | POST | Tumira mari kuchikwama, kunhamba yemari yepafoni kana kuakaundi yebhanga. |
| /v1/payouts/batches | POST | Tumira kusvika mibhadharo 5,000 mumudaidzo mumwe; mutsara mumwe nemumwe unobudirira kana kukundikana wega. |
| /v1/balances | GET | Bharansi riripo neriri kumirira, pamhando yemari imwe neimwe. |
| /v1/settlements | GET | Kubhadharwa nerunyorwa rwekutengeserana rwuri shure kwekumwe nekumwe. |
| /v1/events | GET | Dzokorora zviitiko zvewebhook zvaunogona kunge wakapotsa. |
Webhooks
Simbisa usati wavimba
Chiitiko chose chine ThumaPay-Signature . Verenga HMAC yezviri mukati chaizvo uchishandisa chakavanzika chenzvimbo yako yekubata woenzanisa munguva imwe chete. Ramba chero chisingaenderani, uye uramba nguva dzinodarika maminitsi mashanu kudzivisa kudzokororwa.
// 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();
}
Mibvunzo
Zvinyorwa zvekubatanidza
Hongu. Makiyi enzvimbo yekuedza anopiwa panguva imwe chete nemakiyi echokwadi uye anoita zvakafanana, kusanganisira kutumira kwewebhook nekuratidzira kukundikana. Hapana mari inofamba.
Nzvimbo yekuedza inoratidza nhamba dzinokonzera mhedzisiro dzakatarwa — mari isina kukwana, kusimbiswa kwakapera, mugamuchiri asina kuwanikwa — kuti ugone kuvaka kubata kukanganisa usingamiriri kukundikana chaiko.
Miganho iri pakiyi imwe neimwe uye inodzoserwa pamhinduro yose mumisoro yemiganho. Kubhadhara kweboka kunoverengwa sechikumbiro chimwe pasinei nekuwanda kwemitsara, ndicho chikonzero chekuzvishandisa.
Bharansi rinochengetwa pamhando yemari imwe neimwe uye harimbochinjwi pasina kutaurwa. Kana mhando yemari yekubhadhara ichisiyana neyebharansi, mudaidzo unokundikana pane kushandisa mutengo wekuchinja chakanyarara.
Keys are issued once your business account is verified. Start that on the Bhizimisi page; sandbox access can be granted while verification is still in progress.
Tanga kuvaka nayo nhasi
Kupinda munzvimbo yekuedza hakumiriri kusimbiswa kwakazara. Wana makiyi, gadzira kubhadharisa, uone tsananguro yemutengo mumhinduro yako pachako.