SADAD
Overview
SADAD is Saudi Arabia's centralized bill payment system — utilities, telecom, government fees. Two steps: inquire for the bill, then pay it. The bank resolves the bill category from the biller code, so you never specify it.
| Endpoint | Does |
|---|---|
| BillInquiry | Looks up what is owed on a subscriber account |
| BillPayment | Pays the bill |
Prerequisites
- Authentication: Obtain an access token using the OAuth2 Client Credentials flow (see Getting Started → Authentication). Every endpoint in this product takes
Authorization: Bearer <ACCESS_TOKEN>— there are no exceptions. - Subscription: Subscribe to B2B Unified Product in your chosen environment; it covers all seven B2B Unified products.
All seven B2B Unified products share one scope, b2b_unified. Request it once and the same token works here and on the other six; the Authentication page shows how.
SADAD settles in the call
Unlike single and bulk payments, SADAD is synchronous. The payment completes within the request — the response comes back PAYMENT_COMPLETED rather than PAYMENT_ACCEPTED, and there is no status endpoint to poll afterwards.
Ready to build with SADAD?
Create a sandbox app, grab your credentials, and make your first call in minutes.