3c6e651166259643669b9f527ed5d142074efdd3
The API returns five fields the SDKs were dropping, so a caller could not
act on any of them:
retryable TRUE means we could not reach the bank. In that case
verified=false is NOT a verdict on the payment -- it is
"not checked yet". Retry, or fall back to manual review.
Never reject an order on it. Check it BEFORE acting on
verified=false.
code Stable machine-readable reason; branch on this instead of
parsing the human-readable error string. Empty/null on
success. RECEIPT_NOT_FOUND, AMOUNT_MISMATCH,
RECEIVER_MISMATCH, RECEIPT_EXPIRED, RECEIPT_UNREADABLE,
REFERENCE_INVALID, RECEIVER_ACCOUNT_REQUIRED,
UNSUPPORTED_INPUT, VERIFICATION_FAILED,
DUPLICATE_REFERENCE, UPSTREAM_UNAVAILABLE (retryable).
paid_amount What the receipt ACTUALLY shows, so a short payment can be
compared to the expected figure rather than only described
in prose.
receiver_source Which receiver identity was actually checked: 'settings'
(your saved dashboard account -- strongest), 'request' (the
receiver_name/account you sent), or 'none' (NOTHING was
checked: verified=true with 'none' means the reference
exists and the amount matches, but says nothing about who
received the money).
sandbox True only on TEST-... responses.
Additive only. Defaults are filled in on the way out so a caller never sees a
missing value, including against an API build that predates these fields.
qbirr (Python)
Verify Ethiopian bank transfer receipts in real time.
Install
pip install qbirr
Quick start
from qbirr import Qbirr
qb = Qbirr(api_key="your_key_from_dashboard")
r = qb.verify(
provider="cbe",
ref="FT23001234ABC",
amount=500,
receiver_name="YOUR FULL NAME",
receiver_account="1000017692643",
)
if r.verified:
print(f"✓ Paid by {r.payer}, amount: {r.amount}")
else:
print(f"✗ {r.error}")
Providers
| provider | Notes |
|---|---|
cbe |
Needs receiver_account |
telebirr |
— |
abyssinia |
Needs receiver_account |
dashen |
— |
mpesa |
— |
awash |
ref = SMS URL or its token |
ebirr |
ref = "tenant/token" or full URL |
Errors
from qbirr import Qbirr, QbirrError
try:
r = qb.verify(...)
except QbirrError as e:
print(f"API error {e.status}: {e}")
Verification failures (wrong amount, wrong receiver) are NOT exceptions — they're returned as VerifyResult(verified=False, error="...").
License
MIT
Description
Languages
Python
100%