Go-Live Checklist

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_domain on the Live API.
  • The embedded payment script is set to Live mode: Sadad.Configure(..., false) (true is 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/getbyid and 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.