{
"success": true,
"exists": true,
"duplicate": false,
"message": null,
"data": {
"bank": "cbe",
"bank_name": "Commercial Bank of Ethiopia",
"verification_id": "FT26144SG2ST",
"transaction_number": "FT26144SG2ST",
"source_url": null,
"verification_method": "official",
"receipt": {
"status": "completed",
"transaction_type": "transfer",
"amount": 1350,
"currency": "ETB",
"transaction_date": "2025-06-10T14:30:00+03:00",
"payer_name": "Hayat Ahmed",
"payer_account": "1000126543218",
"receiver_name": "Abebe Bekele",
"receiver_account": "1000876543218",
"description": "Payment"
}
}
}{
"message": "The transaction_number field is required."
}{
"message": "Unauthenticated."
}{
"message": "Monthly verification limit reached. Please upgrade your plan."
}{
"success": false,
"exists": false,
"duplicate": false,
"message": "Transaction not found.",
"data": {
"bank": "cbe",
"bank_name": "Commercial Bank of Ethiopia",
"verification_id": null,
"transaction_number": "FT26144SG2ST",
"verification_method": "official",
"receipt": {}
}
}{
"message": "The given data was invalid.",
"errors": {}
}Verify a Payment
The main endpoint - verify by bank+reference, receipt URL, PDF, or text
{
"success": true,
"exists": true,
"duplicate": false,
"message": null,
"data": {
"bank": "cbe",
"bank_name": "Commercial Bank of Ethiopia",
"verification_id": "FT26144SG2ST",
"transaction_number": "FT26144SG2ST",
"source_url": null,
"verification_method": "official",
"receipt": {
"status": "completed",
"transaction_type": "transfer",
"amount": 1350,
"currency": "ETB",
"transaction_date": "2025-06-10T14:30:00+03:00",
"payer_name": "Hayat Ahmed",
"payer_account": "1000126543218",
"receiver_name": "Abebe Bekele",
"receiver_account": "1000876543218",
"description": "Payment"
}
}
}{
"message": "The transaction_number field is required."
}{
"message": "Unauthenticated."
}{
"message": "Monthly verification limit reached. Please upgrade your plan."
}{
"success": false,
"exists": false,
"duplicate": false,
"message": "Transaction not found.",
"data": {
"bank": "cbe",
"bank_name": "Commercial Bank of Ethiopia",
"verification_id": null,
"transaction_number": "FT26144SG2ST",
"verification_method": "official",
"receipt": {}
}
}{
"message": "The given data was invalid.",
"errors": {}
}Authorizations
API key from your dashboard - starts with chk_. Requires a business account.
Body
Bank code. Required unless using receipt_url, receipt_file, or receipt_text.
cbe, telebirr, dashen, awash, boa, zemen, cbebirr, mpesa, sinqee, amhara "cbe"
Reference number from the receipt. Required unless using receipt_url, receipt_file, or receipt_text.
"FT26144SG2ST"
Your receiving account (required for CBE, BOA). For CBE Birr, pass the payer's phone number (251XXXXXXXXX).
"1000876543218"
ID of a saved bank account - use instead of account_number.
Share URL from the banking app. Auto-extracts bank and transaction number.
"https://apps.ethiotelecom.et/receipt/DEL889NG4S"
OCR'd text from a receipt image (max 50,000 chars). Required alongside image files.
Response
Verified - success: true means the payment is confirmed
true = transaction confirmed
true
true = transaction found in bank records
true
true = already verified in this branch
false
null
Show child attributes
Show child attributes
Only present when duplicate=true
9812
Only present when duplicate=true

