# links.et

> Verify Ethiopian payment receipts at the source. POST a receipt URL, reference or screenshot and links.et fetches it from the bank over an Ethiopia-egress link and returns the parsed receipt as JSON. 17 banks and wallets, one response envelope.

Base URL `https://links.et`. Authenticate with an `x-api-key` header;
keys are minted from the dashboard. Every doc below is also served as
markdown at the same path with `.md` appended.

## Integrating

- [Agent file](https://links.et/agents.md): drop-in instructions for a coding agent: endpoints, auth, retry policy and the pitfalls, in one file.
- [Full docs as one file](https://links.et/llms-full.txt): every page below, concatenated.

## Docs

- [Overview](https://links.et/docs.md): Verify Ethiopian receipt URLs from one API endpoint hosted in Ethiopia.
- [Authentication](https://links.et/docs/authentication.md): API keys are minted from the dashboard and passed via the x-api-key header.
- [POST /api/verify](https://links.et/docs/verify.md): Fetch + parse a single receipt URL across all supported providers.
- [POST /api/verify-image](https://links.et/docs/verify-image.md): Lift the reference token off a receipt screenshot, then cross-check it against the upstream verifier.
- [Integration flows](https://links.et/docs/integration-flows.md): Three ways to consume /api/verify (short wait, polling, and SSE) plus idempotency replay. Pick whichever matches how your app handles latency.
- [Coding agents](https://links.et/docs/agents.md): A drop-in agent file, llms.txt, and a markdown twin of every docs page.
- [Providers overview](https://links.et/docs/providers.md): Every supported receipt host, the source tag each one stamps on its receipt, and the shape it returns.
- [Telebirr](https://links.et/docs/providers/telebirr.md): Detail page: URL format, reference shape, return type, and quirks for telebirr receipts.
- [CBE](https://links.et/docs/providers/cbe.md): Detail page: four URL shapes (two short-link variants and two direct endpoints), two response schemas (PDF and JSON), and how the resolver routes between them.
- [Zemen Bank](https://links.et/docs/providers/zemen.md): Detail page: URL token structure (24-char prefix + reference composite), PDF parsing quirks, and full return type.
- [Bank of Abyssinia](https://links.et/docs/providers/boa.md): Detail page: public SPA URL, underlying API endpoint, token format, and return shape.
- [Awash Bank](https://links.et/docs/providers/awash.md): Detail page: public receipt URL, page structure, captured fields, and return shape.
- [Health / Status API](https://links.et/docs/health.md): Two open endpoints for monitors and dashboards: a single-purpose health probe and a structured per-component status snapshot.
- [Errors](https://links.et/docs/errors.md): Error envelope and codes.
- [Rate limits](https://links.et/docs/rate-limits.md): Two different ceilings, the request rate and the plan's verification cap, plus the screenshot read allowance.

## Providers

- [telebirr](https://links.et/verify/telebirr): receipts from `transactioninfo.ethiotelecom.et`. Accepts the receipt link from the SMS; just the transaction number; a screenshot of the green success screen.
- [Commercial Bank of Ethiopia](https://links.et/verify/cbe): receipts from `apps.cbe.com.et`. Accepts reference plus the account suffix; a mobile-banking short link; the newer v2 short link.
- [CBE Birr](https://links.et/verify/cbe-birr): receipts from `cbepay1.cbe.com.et`. Accepts the receipt link from the SMS; the transaction reference.
- [M-PESA Ethiopia](https://links.et/verify/m-pesa): receipts from `m-pesabusiness.safaricom.et`. Accepts the receipt link from the SMS; the confirmation code.
- [Bank of Abyssinia](https://links.et/verify/boa): receipts from `cs.bankofabyssinia.com`. Accepts the slip link; just the reference; a photo of the printed slip.
- [Dashen Bank](https://links.et/verify/dashen): receipts from `receipts.dashenbanksc.com`. Accepts the receipt link; just the reference.
- [Awash Bank](https://links.et/verify/awash): receipts from `awashpay.awashbank.com`. Accepts the receipt link from the SMS; the transaction reference.
- [Zemen Bank](https://links.et/verify/zemen): receipts from `share.zemenbank.com`. Accepts the share link; just the token.
- [COOPay](https://links.et/verify/coopay): receipts from `receipt.ebirr.com`. Accepts the receipt link; just the token.
- [Kaafi](https://links.et/verify/kaafi): receipts from `receipt.ebirr.com`. Accepts the receipt link; just the token.
- [Amhara Bank](https://links.et/verify/amhara): receipts from `transaction.amharabank.com.et`. Accepts the receipt link; an FT reference; a BN reference.
- [Abay Bank](https://links.et/verify/abay): receipts from `abaymobile.com.et`. Accepts the receipt link; the transaction reference.
- [Oromia Bank](https://links.et/verify/oromia): receipts from `obinfo.oromiabank.com`. Accepts the receipt link; the transaction reference.
- [Berhan Bank](https://links.et/verify/berhan): receipts from `transactioninfo.berhanonline.et`. Accepts the receipt link; the transaction reference.
- [Ahadu Bank](https://links.et/verify/ahadu): receipts from `receipt.ahadubank.com`. Accepts the digital receipt link; just the es token.
- [Siinqee Bank](https://links.et/verify/siinqee): receipts from `receipts.siinqeebank.com`. Accepts the receipt link; the transaction reference.
- [ZamZam Bank](https://links.et/verify/zamzam): receipts from `receipt-backend.zamzambank.com.et`. Accepts the receipt link; the transaction reference.

## Guides

- [How to spot a fake payment screenshot in Ethiopia](https://links.et/guides/fake-payment-screenshots-ethiopia): Edited telebirr and CBE screenshots are the most common payment fraud against Ethiopian shops. What the fakes get wrong, and the one check that actually settles it.
- [The same receipt, twice: catching reused payment proof](https://links.et/guides/duplicate-payment-receipts): A reused receipt is genuine, so it passes every check except the one nobody runs. How duplicate payment fraud works in Ethiopia and how to close it.
- [Payment verification for a shop that takes transfers all day](https://links.et/guides/payment-verification-for-ethiopian-shops): A practical routine for confirming bank and wallet transfers at a counter: what to ask for, what to check, and where the time actually goes.
- [Verifying Ethiopian payments from your own software](https://links.et/guides/verify-ethiopian-payments-by-api): What changes when payment verification moves from a person at a counter into your order flow: idempotency, retries, outages, and what to store.
- [telebirr and CBE verification are not the same problem](https://links.et/guides/telebirr-vs-cbe-verification): The two providers most Ethiopian payments run through behave differently when you check them. What each one needs, and why CBE fails more often.
- [Every Ethiopian bank publishes receipts. Here is where.](https://links.et/guides/ethiopian-bank-receipt-links): A reference list of the receipt hosts for Ethiopian banks and wallets, so an unfamiliar-looking link can be checked against the real one.

## Comparisons

- [Checking payments by hand, or with an API](https://links.et/compare/manual-verification): Opening every receipt link yourself is free and works. Where it stops working, and what the alternative actually costs.
- [A payment gateway, or receipt verification](https://links.et/compare/payment-gateway): A gateway collects the money. Verification confirms money that already moved. They solve different problems, and most Ethiopian sellers need the second one.
- [Building receipt verification yourself](https://links.et/compare/building-it-yourself): Fetching and parsing one bank’s receipts is an afternoon. Here is what the other sixteen cost, and when building it anyway is still right.

## Ethiopian bank SWIFT codes

Ethiopia does not use IBAN, and wallets (telebirr, M-PESA, CBE Birr, Kaafi) have no BIC.

- Commercial Bank of Ethiopia: `CBETETAA` — https://links.et/swift-codes/commercial-bank-of-ethiopia
- Awash Bank: `AWINETAA` — https://links.et/swift-codes/awash-bank
- Bank of Abyssinia: `ABYSETAA` — https://links.et/swift-codes/bank-of-abyssinia
- Dashen Bank: `DASHETAA` — https://links.et/swift-codes/dashen-bank
- Zemen Bank: `ZEMEETAA` — https://links.et/swift-codes/zemen-bank
- Cooperative Bank of Oromia: `CBORETAA` — https://links.et/swift-codes/cooperative-bank-of-oromia
- Amhara Bank: `AMHRETAA` — https://links.et/swift-codes/amhara-bank
- Abay Bank: `ABAYETAA` — https://links.et/swift-codes/abay-bank
- Berhan Bank: `BERHETAA` — https://links.et/swift-codes/berhan-bank
- Oromia Bank: `ORIRETAA` — https://links.et/swift-codes/oromia-bank
- Ahadu Bank: `AHUUETAA` — https://links.et/swift-codes/ahadu-bank
- Siinqee Bank: `SINQETAA` — https://links.et/swift-codes/siinqee-bank
- ZamZam Bank: `ZAMZETAA` — https://links.et/swift-codes/zamzam-bank
- Hibret Bank: `UNTDETAA` — https://links.et/swift-codes/hibret-bank
- Wegagen Bank: `WEGAETAA` — https://links.et/swift-codes/wegagen-bank
- Nib International Bank: `NIBIETAA` — https://links.et/swift-codes/nib-international-bank
- Lion International Bank: `LIBSETAA` — https://links.et/swift-codes/lion-international-bank
- Bunna Bank: `BUNAETAA` — https://links.et/swift-codes/bunna-bank
- Enat Bank: `ENATETAA` — https://links.et/swift-codes/enat-bank
- Addis International Bank: `ABSCETAA` — https://links.et/swift-codes/addis-international-bank
- Global Bank Ethiopia: `DEGAETAA` — https://links.et/swift-codes/global-bank-ethiopia
- Hijra Bank: `HIJRETAA` — https://links.et/swift-codes/hijra-bank
- Goh Betoch Bank: `GOBTETAA` — https://links.et/swift-codes/goh-betoch-bank
- Gadaa Bank: `GDAAETAA` — https://links.et/swift-codes/gadaa-bank
- Omo Bank: `OSCOETAA` — https://links.et/swift-codes/omo-bank
- Rammis Bank: `RMSIETAA` — https://links.et/swift-codes/rammis-bank
- Shabelle Bank: `SBEEETAA` — https://links.et/swift-codes/shabelle-bank
- Sidama Bank: `SDMAETAA` — https://links.et/swift-codes/sidama-bank
- Tsedey Bank: `TSDYETAA` — https://links.et/swift-codes/tsedey-bank
- Tsehay Bank: `TSCPETAA` — https://links.et/swift-codes/tsehay-bank
- Development Bank of Ethiopia: `DEETETAA` — https://links.et/swift-codes/development-bank-of-ethiopia
- National Bank of Ethiopia: `NBETETAA` — https://links.et/swift-codes/national-bank-of-ethiopia