FAQ

Quick answers to common questions about integrating SADAD Pay.

Quick answers to the questions developers and merchants ask most. Each answer links to the full guide.

Getting started

How do I get API access?

Log in to the SADAD Pay portal and go to Profile → Update Profile → API. If you do not see a Client Key and Client Secret there, email [email protected] to enable API access. See API Keys & Authentication.

What is the difference between Sandbox and Live?

Sandbox is for testing: payments use test cards and no real money moves. Live takes real payments. They are separate accounts with separate keys, URLs and settings. See Sandbox & Live Accounts.

ItemSandboxLive
APIhttps://apisandbox.sadadpay.net/apihttps://api.sadadpay.net/api
Payment pagehttps://sandbox.sadadpay.net/pay/{key}https://sadadpay.net/pay/{key}

Which integration should I use?

Most websites should use the Hosted Payment Page: you create an invoice and send the customer to the SADAD Pay payment page. If your store runs on WooCommerce, Magento, Shopify or another platform, use a plugin. See Choose Your Integration.

Which payment methods can customers use?

KNET, Visa and Mastercard, and Apple Pay, depending on what is enabled on your account.

Tokens

My requests return InvalidToken or InvalidAccessToken. Why?

The Access Token is short-lived. Generate a new one with your refresh token before it expires, and send it as Authorization: Bearer {accessToken}. The response of GenerateAccessToken tells you how many seconds it lasts. See API Keys & Authentication.

Can I use my Sandbox keys in Live?

No. Each environment has its own keys. Using Sandbox keys with the Live API, or the other way round, fails.

Can I put my Client Secret in my mobile app or website code?

No. Anyone can read it from your app or page. Keep it on your server and create invoices there. See the Flutter SDK guide for how to do this in a mobile app.

Payments

Is the customer reaching my Success URL proof of payment?

No. Always check the invoice with GET /api/Invoice/getbyid and make sure status is Paid before you deliver. See Verify Payment Status.

Which amount and currency do invoices use?

SADAD Pay charges in KWD. Send amount with up to 3 decimal places, for example 12.500.

The customer paid but my order is not updated. What should I do?

The customer probably closed the browser before returning to your site. Set up Webhooks, and check unpaid orders with getbyid on a schedule. See Payment Status Guidelines.

An invoice shows Unpaid even though its expiry date has passed. Why?

The status changes to Expired when someone opens the payment page after the expiry date. Until then, it can still show Unpaid. Compare expiry_Date yourself if you need to know whether an invoice has expired. See Payment Status Guidelines.

Can the customer try again after a failed payment?

Yes. The same payment link works until the invoice is paid or expires.

Refunds

How do I refund a payment?

From the portal under Invoices → Refund, or with POST /api/Refund/insert. You can refund in full or in part. See Refunds.

Why did my refund create an invoice?

If you choose Pay Amount, or your SADAD Pay balance is too low for Deduct from Balance, SADAD Pay creates a refund invoice for you to pay. The refund completes when you pay it.

Does the invoice status change after a refund?

A full refund changes the status to Refunded. A partial refund keeps the status Paid, and refunded_Amount shows how much was refunded.

Webhooks

Which events send a webhook?

A webhook is sent when an invoice created with the API is paid. See Webhooks for the details and how to check the signature.

My endpoint receives the same webhook twice. Is that a problem?

No, it is expected. SADAD Pay retries when it does not get HTTP 200 quickly. Make your handler safe to run more than once.

Plugins

Do I need to code to use a plugin?

No. Install the plugin, enter your keys, and set the webhook URL if your platform has one. See the Plugins Overview.

Can I refund from my store's admin?

Not with the current plugins. Refund in the SADAD Pay portal, then record the refund in your store.

Support

How do I contact technical support?

Email [email protected]. Include the environment, the invoice number (for example INV-92509) or order number, the request and response without your keys, and the time it happened. See Errors & Response Codes.