Everything to check before you start accepting real payments.
Use this checklist when your sandbox integration is complete and you are ready to switch to Live.
Before you start
Make sure your Live account has been activated by SADAD Pay. See Sandbox & Live Accounts.
1. Live account
- Your Live account is activated by SADAD Pay.
- API access is enabled: your Client Key and Client Secret show under Profile → Update Profile → API. See API Keys & Authentication.
- The payment methods and features you need (KNET, cards, Apple Pay, Embedded Payment, Multi-Supplier, etc.) are enabled on your Live account.
2. Switch your configuration
- API base URL changed to
https://api.sadadpay.net/api. - Payment page URL changed to
https://sadadpay.net/pay/{KEY}. - Live Client Key and Client Secret in use, and new Refresh and Access Tokens generated with them.
- Keys and tokens are stored securely on your server, never in front-end or mobile app code.
- Payment Success Return URL and Payment Failed Return URL added in your Live profile.
- Webhook URL added in your Live profile, using HTTPS.
- No sandbox URLs or test values are left in your code or settings.
3. Embedded Payment and Apple Pay (if you use them)
- Your live domain is registered with
POST /api/EmbeddedPayment/allow_domainon the Live API. - The embedded payment script is set to Live mode:
Sadad.Configure(..., false)(trueis for Sandbox). - For Apple Pay, your live domain is verified with Apple.
4. Payment handling
- Before completing an order, you verify the payment with
GET /api/Invoice/getbyidand check that the status is Paid. - You handle both the customer redirect and the webhook, and an order is never fulfilled twice.
- Your webhook endpoint returns HTTP 200 quickly.
- Invoice amounts are sent in KWD.
- Your system renews the Access Token before it expires (every 24 hours).
5. Tested in Sandbox
- A successful KNET payment
- A successful card payment
- A declined card payment, with a clear message shown to the customer
- A customer cancelling on the payment page
- The webhook received and processed
- A refund (if you use refunds)
See Test Cards for the cards and dates that trigger each result.
6. After you go live
- Log the SADAD Pay invoice ID and API responses for every order, to make support easier.
- Keep [email protected] handy for any issue, and include the invoice ID when you contact us.
You're ready!
When everything is checked, you can start accepting real payments.

