Product Links

A simple online shop on a link: list your products, and let customers pick items and pay.

A product link is a ready-made shop page. You add your products once, group them into a link, and share it on Instagram, WhatsApp or anywhere else. Customers choose items and quantities, see the total, and pay. No website needed.

Use a product link when...Use a payment link when...
You sell several products with set prices, and the customer chooses what and how manyYou collect one amount (fixed or entered by the customer) for one thing

How it works

  1. Categories group your products, such as "Apparel" or "Accessories".
  2. Products have a name and description in English and Arabic, a price, and optionally a stock quantity and an image.
  3. A product link is a shop page with the products you choose.
  4. When a customer pays, SADAD Pay creates an invoice for the items in their cart. It appears under Invoices with your other payments.

Set up in the portal

1. Add a category

Go to Products → Add Category, enter the English and Arabic names, and save.

2. Add your products

Go to Products → Add Product and fill in:

FieldDescription
CategoryThe category the product belongs to
English / Arabic nameShown to the customer in each language
English / Arabic descriptionOptional details, such as size or colour
PricePrice of one unit, in KWD
StockableTurn on to track stock. Enter the Quantity you have. Customers cannot buy more than this.
Show stockShow customers how many are left
ImageA photo of the product
ActiveTurn off to hide the product without deleting it
1254

Products → Add Product: category, Arabic and English names, unit price and stock

3. Create the product link

  1. Go to Product Links → Add Product Link.
  2. Enter the English and Arabic name of the shop.
  3. Choose the products to include.
  4. Optional: add Terms and Conditions and choose the Payment Methods to offer.
  5. Save. Your link appears in Product Links, with an English and an Arabic URL.
https://sadadpay.net/productLnk/en/{key}
https://sadadpay.net/productLnk/ar/{key}

In Sandbox, the domain is sandbox.sadadpay.net.

1254

Product Links → Add Product Link: click products on the left to add them to the link

What your customer sees

The customer chooses quantities with + and −, enters their name and mobile number, and taps Pay Now. SADAD Pay creates the invoice and opens the usual payment page, where they pay with KNET, card or Apple Pay. The page also shows a QR code for the link.

1568

A product link with two items in the cart

📘

Customer details

Customer Name and Mobile are required on product links. Email and notes are optional.

Manage products with the API

You can keep your catalogue in sync from your own system. All endpoints need an Access Token: see API Keys & Authentication.

TaskEndpoint
List / get / add / change / delete categoriesGET /api/ProductCategory/getall, GET …/getbyid, POST …/insert, PUT …/update, DELETE …/delete
List / get / add / change / delete productsGET /api/Product/getall, GET …/getbyid, POST …/insert, PUT …/update, DELETE …/delete
List / get / add / change / delete product linksGET /api/ProductLink/getall, GET …/getbykey, POST …/insert, PUT …/update, DELETE …/delete?key={key}
Create an invoice from a product linkPOST /api/Invoice/createproductlinkinvoice

Add a product

POST /api/Product/insert

FieldTypeRequiredDescriptionExample
category_IdintegerYesThe category ID, from ProductCategory/insert or getall48
name_EnstringYesEnglish name"Blue T-shirt"
name_ArstringYesArabic name"قميص أزرق"
pricenumberYesPrice of one unit, in KWD. Greater than 0.4.500
desc_En, desc_ArstringNoDescriptions"Cotton, size M"
stockablebooleanNoTrack stock for this producttrue
quantityintegerNoUnits in stock, when stockable is true50
stockable_ShowbooleanNoShow the stock left to customerstrue
imagestringNoThe product image
inActivebooleanNotrue to hide the productfalse
curl -X POST "https://apisandbox.sadadpay.net/api/Product/insert" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "category_Id": 48,
    "name_En": "Blue T-shirt",
    "name_Ar": "قميص أزرق",
    "desc_En": "Cotton T-shirt, size M",
    "price": 4.500,
    "stockable": true,
    "quantity": 50,
    "stockable_Show": true,
    "inActive": false
  }'
{
  "isValid": true,
  "errorKey": null,
  "response": {
    "id": 83
  }
}

Create a product link

POST /api/ProductLink/insert

curl -X POST "https://apisandbox.sadadpay.net/api/ProductLink/insert" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name_En": "Summer Collection",
    "name_Ar": "تشكيلة الصيف",
    "inActive": false,
    "terms_Condition_Enabled": false,
    "products": [ { "product_Id": 83 }, { "product_Id": 84 } ]
  }'
{
  "isValid": true,
  "errorKey": null,
  "response": {
    "id": "4278114163"
  }
}

The id in the response is the link's key. Your shop is at https://sandbox.sadadpay.net/productLnk/en/4278114163.

Create an invoice from a product link

POST /api/Invoice/createproductlinkinvoice · API Reference

Creates the same invoice as when a customer taps Pay Now. Use it to build your own shop or chat ordering on top of your SADAD Pay catalogue.

FieldTypeRequiredDescriptionExample
productLink_KeyintegerYesThe product link key4278114163
customer_NamestringYesThe customer's name"Ahmed Ali"
customer_MobilestringYesThe customer's mobile number"99999999"
productsarrayYesThe items, each with product_Id, quantity and amount (the product's unit price)See example
totalAmountnumberYesThe total of all items (quantity × amount)11.000
currency_CodestringYesKWD"KWD"
customer_EmailstringNoThe customer's email"[email protected]"
langstringNoen or ar"en"
commentstringNoA note on the order"Gift wrap please"
curl -X POST "https://apisandbox.sadadpay.net/api/Invoice/createproductlinkinvoice" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "productLink_Key": 4278114163,
    "customer_Name": "Ahmed Ali",
    "customer_Mobile": "99999999",
    "customer_Email": "[email protected]",
    "lang": "en",
    "totalAmount": 11.000,
    "currency_Code": "KWD",
    "products": [
      { "product_Id": 83, "quantity": 2, "amount": 4.500 },
      { "product_Id": 84, "quantity": 1, "amount": 2.000 }
    ]
  }'
{
  "isValid": true,
  "errorKey": null,
  "response": {
    "invoice_Key": 2573753792954
  }
}

Send your customer to https://sandbox.sadadpay.net/pay/{invoice_Key} (Live: https://sadadpay.net/pay/{invoice_Key}). Then confirm the payment as described in Verify Payment Status.

Common errors

errorKeyEndpointCauseHow to fix
NameEnRequired / NameArRequiredProduct/insertThe English or Arabic name is missingSend both name_En and name_Ar
PriceRequiredProduct/insertprice is missing or 0Send a price greater than 0
CustomerMobileRequiredcreateproductlinkinvoicecustomer_Mobile is missingSend the customer's mobile number
InvalidProductAmountcreateproductlinkinvoiceAn item's amount is not the product's priceSend each product's current price
InvoiceAmountMustEqualsToTotalItemsAmountcreateproductlinkinvoicetotalAmount is not the sum of the itemsSend totalAmount = sum of quantity × amount
YouExceededAvailableQuantitycreateproductlinkinvoiceThe quantity is more than the stock leftLower the quantity, or add stock to the product
InvalidAccessToken / InvalidToken (HTTP 401)AllThe Access Token is missing, wrong or expiredGenerate a new Access Token

Next steps