8. Payment Request Form

To initiate a transaction using SADAD Web Checkout 2.1, the merchant must submit an HTML form from their server to the SADAD checkout endpoint.

This form contains the order details and a server-generated signature to ensure request authenticity.

Important Integration Rules

caution

The payment form must be generated and submitted server-side
The signature must be generated using your Secret Key
Do not expose Secret Keys or signature logic on the frontend
Always use the POST method

Checkout Endpoint

Use the following endpoint for both Test and Live transactions:

https://sadadqa.com/webpurchase

The environment (Sandbox or Live) is determined by the Secret Key used to generate the signature.

Mandatory Form Parameters

The following parameters are required for all Web Checkout requests:

Parameter	Description
`merchant_id`	SADAD Merchant ID (MID)
`ORDER_ID`	Unique order reference generated by the merchant
`TXN_AMOUNT`	Transaction amount
`CALLBACK_URL`	Merchant callback URL
`WEBSITE`	Merchant website identifier
`email`	Customer email address
`MOBILE_NO`	Customer mobile number
`txnDate`	Transaction date and time
`signature`	SHA256 signature generated server-side

Optional Parameters

These parameters are optional but recommended where applicable:

Parameter	Description
`productdetail`	Product or service details
`customer_name`	Customer full name
`language`	Checkout language preference

Optional parameters must not be included in the signature unless explicitly documented.

Sample HTML Payment Form

<form action="https://sadadqa.com/webpurchase" method="post" target="_blank">
  <input type="hidden" name="merchant_id" value="7015085" />
  <input type="hidden" name="ORDER_ID" value="ORD-20251216-001" />
  <input type="hidden" name="TXN_AMOUNT" value="150.00" />
  <input type="hidden" name="CALLBACK_URL" value="https://yoursite.com/callback" />
  <input type="hidden" name="WEBSITE" value="yoursite.com" />
  <input type="hidden" name="email" value="[email protected]" />
  <input type="hidden" name="MOBILE_NO" value="97412345678" />
  <input type="hidden" name="txnDate" value="2025-12-16 12:30:00" />
  <input type="hidden" name="signature" value="GENERATED_SIGNATURE" />
  <button type="submit">Pay Now</button>
</form>

Product Details Structure (Optional)

productdetail[0][order_id]
productdetail[0][amount]
productdetail[0][quantity]

<input type="hidden" name="productdetail[0][order_id]" value="ITEM-001" />
<input type="hidden" name="productdetail[0][amount]" value="150.00" />
<input type="hidden" name="productdetail[0][quantity]" value="1" />

Product details are not included in the signature calculation.

Validation & Formatting Rules

note

ORDER_ID must be unique per transaction
TXN_AMOUNT must be numeric
CALLBACK_URL must be publicly accessible
Date/time formats must remain consistent

What Happens After Form Submission?

Customer is redirected to SADAD checkout
Customer completes payment
SADAD redirects to CALLBACK_URL
SADAD sends webhook notification

Need Help?

Contact [email protected] with:

Merchant ID
Order ID
Environment

Important Integration Rules​

Checkout Endpoint​

Mandatory Form Parameters​

Optional Parameters​

Sample HTML Payment Form​

Product Details Structure (Optional)​

Validation & Formatting Rules​

What Happens After Form Submission?​

Need Help?​