Verify by Receipt URL

curl --request POST \
  --url https://api.check.et/api/v1/verify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "bank": "cbe",
  "transaction_number": "FT26144SG2ST",
  "account_number": "1000876543218"
}
'

{
  "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": {}
}

POST

verify

curl --request POST \
  --url https://api.check.et/api/v1/verify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "bank": "cbe",
  "transaction_number": "FT26144SG2ST",
  "account_number": "1000876543218"
}
'

{
  "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": {}
}

Pass receipt_url in the request body. Select the “Telebirr receipt URL” or similar example in the playground above to try it.

When a customer shares a payment link from their banking app (Telebirr, Dashen, Awash, etc.), paste it directly into receipt_url. Check.et extracts the bank and transaction number automatically - no manual parsing needed.

How it works

Customer taps Share in their banking app
You receive the URL
Pass it to /verify as receipt_url
Check.et resolves the bank, fetches the transaction, and returns structured JSON

Which banks support receipt URLs?

Bank	URL Format
Telebirr	`apps.ethiotelecom.et/receipt/...`
Dashen	Dashen Bank app share links
Awash	AwashPay share links
CBE	CBE app share links
Zemen	Zemen app share links
M-Pesa	M-Pesa app share links

Pre-validate without consuming quota

Use POST /verify/parse-url to extract the bank and transaction details before triggering a full verification.

Authorizations

Authorization

string

header

required

API key from your dashboard - starts with chk_. Requires a business account.

Body

bank

enum<string>

Bank code. Required unless using receipt_url, receipt_file, or receipt_text.

Available options:

cbe,

telebirr,

dashen,

awash,

boa,

zemen,

cbebirr,

mpesa,

sinqee,

amhara

Example:

"cbe"

transaction_number

string

Reference number from the receipt. Required unless using receipt_url, receipt_file, or receipt_text.

Example:

"FT26144SG2ST"

account_number

string

Your receiving account (required for CBE, BOA). For CBE Birr, pass the payer's phone number (251XXXXXXXXX).

Example:

"1000876543218"

bank_account_id

integer

ID of a saved bank account - use instead of account_number.

receipt_url

string

Share URL from the banking app. Auto-extracts bank and transaction number.

Example:

"https://apps.ethiotelecom.et/receipt/DEL889NG4S"

receipt_text

string

OCR'd text from a receipt image (max 50,000 chars). Required alongside image files.

Response

Verified - success: true means the payment is confirmed

success

boolean

true = transaction confirmed

Example:

true

exists

boolean

true = transaction found in bank records

Example:

true

duplicate

boolean

true = already verified in this branch

Example:

false

message

string | null

Example:

null

data

object

Show child attributes

existing_verification_id

integer

Only present when duplicate=true

Example:

9812

verified_at

string<date-time>

Only present when duplicate=true

Overview

Verifications

Banks

Bank Accounts

Verify by Receipt URL

How it works

Which banks support receipt URLs?

Pre-validate without consuming quota

Authorizations

Body

Response

​How it works

​Which banks support receipt URLs?

​Pre-validate without consuming quota

Authorizations

Body

Response

How it works

Which banks support receipt URLs?

Pre-validate without consuming quota