← Rudi kwa nyaraka

Webhooks

Matukio yaliyotiwa saini na yasiyorudiwa ndiyo chanzo chako cha ukweli kwa njia zisizolandanishwa (asynchronous).

Baraka Pay inatia saini kila webhook na kuipeleka kwa majaribio ya kurudia (retries) na backoff. Thibitisha saini, ondoa marudio kwa kutumia event id, na hakikisha kishikizi (handler) chako ni idempotent.

Mafanikio, kushindwa, kusubiri, kughairiwa na kuisha muda wa malipo yote hupelekwa kama matukio (events). Usiwahi kutimiza agizo kwa kutegemea uelekezaji wa kivinjari (browser redirect) pekee.

Matukio

Malipo yanayoingia: payment.succeeded, payment.failed, payment.pending, payment.cancelled, payment.expired — pamoja na uchunguzi wa uwasilishaji unaoweza kuucheza tena kutoka portal ya Merchant.

Malipo ya kutoka: payout.pending, payout.approved, payout.processing, payout.succeeded, payout.failed, payout.cancelled, payout.returned. Kumbuka payout.returned inaweza kufika siku kadhaa baada ya kuambiwa yamefanikiwa — ona Malipo ya kutoka.

Amana za fedha taslimu: cash_deposit.confirmed, hutolewa mara fedha zinapothibitishwa kwenye taarifa ya benki yenyewe.

Kila moja hubeba kitambulisho cha kilichobadilika, na si zaidi. Webhook husema NINI kimebadilika; API husema kimebadilikaje, na API pekee ndiyo yenye mamlaka.