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 SADAD in your chosen environment.
A token carries only the scopes you asked for, so one issued for a different product is rejected here. Request this product's scope, or ask for several scopes in a single token as described on the Authentication page.
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.