Invoicing & Payment Links

Get paid without a website: send invoices from the portal or the API, and share reusable payment links.

You do not need a website or any code to get paid with SADAD Pay. Create an invoice in the portal and send it to your customer by SMS, email or WhatsApp, or share a payment link that anyone can pay. If you do have a system, you can do the same things through the API.

Which one should I use?

You want to...Use
Bill a specific customer for a specific amountInvoice
Bill many customers at once, such as monthly feesBatch invoices
Put one link on Instagram, WhatsApp or a QR code for anyone to payPayment link
Create invoices automatically from your system or websiteInvoice API or the Hosted Payment Page

Every payment, from any of these, appears in the portal under Invoices, with the same statuses and the same settlement to your bank account.

Invoices in the portal

There are two ways to create an invoice in the portal:

  • Quick Invoice: the essentials only (customer, amount, how to send it). Best for a fast one-off bill.
  • Add Invoice: everything in Quick Invoice, plus line items, a discount, an automatic reminder, terms and conditions, and an attachment.
1254

Invoices list in the portal, with buttons for Quick Invoice, Add Invoice and Batch Invoices

Create and send an invoice

  1. In the portal, go to Invoices → Quick Invoice (or Add Invoice).
  2. Enter the Customer Name, and the Mobile or Email you will send the invoice to.
  3. Enter the Invoice Value and choose the Display Currency.
  4. Choose how to send it in Send Invoice Option: SMS or Email.
  5. Optional: add a Reference ID (your own order number), the invoice Language, a Payment Purpose, or an attachment.
  6. Under Payment Methods, untick any method you do not want to offer on this invoice.
  7. Click Submit. SADAD Pay creates the invoice and sends the payment link to your customer.
1568

Creating a Quick Invoice in the portal

Share the invoice another way

Open the invoice from Invoices to share it again or through another channel. The buttons at the top let you:

  • Copy link to paste the payment link anywhere
  • Send it by Email, Messenger, SMS or WhatsApp
  • Download as PDF

The invoice page also shows a QR code that your customer can scan to pay.

1568

Share buttons on the invoice page

📘

How long can the customer pay?

An invoice can be paid for 30 days after it is created. After that it expires. You can change an unpaid invoice at any time from its page, and click Cancel in the invoice list to stop it being paid.

Add Invoice options

OptionWhat it does
Invoice itemsList each product or service with its quantity and unit price. The invoice value is the total of the items.
Discount Type / Discount AmountA fixed amount or a percentage off the invoice value.
Reminder AfterSend the customer a reminder if the invoice is still unpaid after the period you choose.
Terms and ConditionsText the customer must accept before paying.
Attach FileA document for the customer, such as a quotation or contract.

Batch invoices from Excel

Create and send many invoices in one go, for example monthly school fees or membership renewals.

  1. Go to Invoices → Batch Invoices and click Download sample excel file.
  2. Fill in one row per invoice, using the columns below. Keep the header row exactly as it is.
  3. Click Batch File, choose your file, then click Import invoices.

🚧

Invoices are sent straight away

Every invoice in the file is created and sent to its customer as soon as you import it. Check the file carefully before you import.

ColumnRequiredDescriptionExample
customer_NameYesCustomer's nameAhmed Ali
amountYesInvoice amount, in currency_Code25.000
currency_CodeYesKWD, USD, SAR, AED or QARKWD
sendTypeYesSMS or EmailSMS
customer_MobileFor SMSMobile number to send the invoice to99999999
customer_EmailFor EmailEmail address to send the invoice to[email protected]
langNoen or aren
ref_NumberNoYour own reference numberFEES-NOV-001
payment_MethodsNoThe payment methods to offer, as IDs separated by commas5,4,35

📘

Finding your payment method IDs

Go to Profile → Payment Methods. The ID of each method is in the first column. The IDs can be different on each account, and between Sandbox and Live.

941

Invoices → Batch Invoices: download the sample Excel file, fill it in and import it

406

Profile → Update Profile → Payment Methods: the ID column gives the payment method IDs for the Excel file

Payment links

A payment link is a single, reusable link for a product, service or donation. You share it once, and any number of customers can pay through it. Each payment creates its own invoice.

Payment TypeThe customer...Good for
Fixed AmountPays the amount you setEvent tickets, course fees, a set service price
Variable AmountEnters the amount, within the range you setDonations, deposits, paying an open balance

Create a payment link

  1. Go to Payments → Add Payment.
  2. Enter a Url Title. Your customers see this as the name of the payment.
  3. Choose the Payment Type. For a fixed amount, enter the Amount. For a variable amount, enter the Min Amount and Max Amount. Then choose the Display Currency.
  4. Optional: add Notes, Terms and Conditions, and choose the Language and Payment Methods.
  5. Make sure Active is on, then click Submit.
1568

Creating a fixed-amount payment link

Your link appears in Payments → Payment List, in the format:

https://sadadpay.net/CustomerPayment/{key}

In Sandbox, the domain is sandbox.sadadpay.net. To stop accepting payments, turn Active off in the Payment List.

What your customer sees

The customer opens the link, enters their name (and the amount, for a variable link), and taps Pay Now. SADAD Pay creates an invoice for them and opens the usual payment page, where they choose KNET, card or Apple Pay.

1568

The payment link page your customer sees

📘

Where do payment link payments appear?

Each payment creates an invoice of type PaymentLink. You will find it under Invoices, together with your other invoices.

Manage invoices with the API

Everything above can also be done from your own system. You need an Access Token: see API Keys & Authentication. All examples use the Sandbox URL.

TaskEndpoint
Create one or more invoicesPOST /api/Invoice/insert · see Hosted Payment Page
Get one invoiceGET /api/Invoice/getbyid?id={id}
Search invoices, page by pageGET /api/Invoice/getallbypage
Change an unpaid invoicePUT /api/Invoice/update
Cancel an unpaid invoiceDELETE /api/Invoice/delete?id={id}
Create an invoice from a payment linkPOST /api/Invoice/createpaymentlinkinvoice

Send the invoice to the customer

When you create an invoice with POST /api/Invoice/insert, add sendType (SMS or Email) with customer_Mobile or customer_Email, the same as Send Invoice Option in the portal. If you show the payment link to the customer yourself, leave sendType out. The full field list is on the Hosted Payment Page guide.

Search invoices

GET /api/Invoice/getallbypage · API Reference

All filters are optional. Combine as many as you need.

ParameterDescriptionExample
page, pageSizeWhich page to return, and how many invoices per page1, 50
statusUnpaid, Paid, Canceled, Deposited or RefundedPaid
Ref_NumberYour reference numberORD-1001
codeThe invoice codeINV-71461
invoiceTypeFor example Invoice or PaymentLinkPaymentLink
createDate_From, createDate_ToCreated between these dates (MM/dd/yyyy)11/01/2026
Payment_Date_From, Payment_Date_ToPaid between these dates (MM/dd/yyyy)11/30/2026
customer_Name, customer_Mobile, customer_EmailCustomer detailsAhmed Ali
amount_From, amount_ToAmount range10
curl -G "https://apisandbox.sadadpay.net/api/Invoice/getallbypage" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  --data-urlencode "page=1" \
  --data-urlencode "pageSize=50" \
  --data-urlencode "status=Paid" \
  --data-urlencode "Payment_Date_From=11/01/2026" \
  --data-urlencode "Payment_Date_To=11/30/2026"
{
  "isValid": true,
  "errorKey": null,
  "response": {
    "totalRecords": 7,
    "items": [
      {
        "id": 71461,
        "code": "INV-71461",
        "status": "Paid",
        "type": "Invoice",
        "amount": 1.5,
        "total": 1.5,
        "fees": 0.045,
        "subtotal": 1.455,
        "customer_Name": "Ahmed Ali",
        "customer_Email": "[email protected]",
        "currency_Code": "KWD",
        "ref_Number": "ORD-1001",
        "createDate": "11/09/2026 12:41:15",
        "payment_Date": "11/09/2026 12:43:36"
      }
    ]
  }
}

In the list response, fees is the SADAD Pay fee and subtotal is the amount you receive after fees. Use totalRecords to work out how many pages there are.

Update an unpaid invoice

PUT /api/Invoice/update · API Reference

Send the invoice id with the fields you want to change. Fields you leave out keep their current value. To be safe, get the invoice first, change what you need, and send it back.

curl -X PUT "https://apisandbox.sadadpay.net/api/Invoice/update" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 71598,
    "amount": 15.000,
    "currency_Code": "KWD",
    "customer_Name": "Ahmed Ali"
  }'
{
  "isValid": true,
  "errorKey": null,
  "response": null
}
{
  "isValid": false,
  "errorKey": "InvoiceCannotBeUpdated",
  "response": null
}

Cancel an unpaid invoice

DELETE /api/Invoice/delete?id={id} · API Reference

The invoice is cancelled: its payment link stops working, and it shows as Cancelled in the portal. It is kept for your records. When you get it with getbyid, it has "deleted": true. A paid invoice cannot be cancelled. Use a refund instead.

curl -X DELETE "https://apisandbox.sadadpay.net/api/Invoice/delete?id=71598" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
  "isValid": true,
  "errorKey": null,
  "response": null
}
{
  "isValid": false,
  "errorKey": "InvoiceCannotBeDeleted",
  "response": null
}

Create an invoice from a payment link

POST /api/Invoice/createpaymentlinkinvoice · API Reference

Creates the same invoice as when a customer taps Pay Now on your payment link. Use it when you collect the customer's details in your own app or chatbot.

FieldTypeRequiredDescriptionExample
paymentLink_KeyintegerYesThe number at the end of your payment link URL24206710181
customer_NamestringYesThe customer's name"Ahmed Ali"
amountnumberYesFor a fixed link, the link's amount. For a variable link, an amount within its range.5.000
currency_CodestringYesThe link's currency"KWD"
customer_MobilestringNoThe customer's mobile number"99999999"
customer_EmailstringNoThe customer's email address"[email protected]"
commentstringNoA note on the invoice"Workshop seat"
curl -X POST "https://apisandbox.sadadpay.net/api/Invoice/createpaymentlinkinvoice" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "paymentLink_Key": 24206710181,
    "customer_Name": "Ahmed Ali",
    "customer_Email": "[email protected]",
    "amount": 5.000,
    "currency_Code": "KWD"
  }'
{
  "isValid": true,
  "errorKey": null,
  "response": {
    "invoice_Key": 2658568171599
  }
}

Send your customer to https://sandbox.sadadpay.net/pay/{invoice_Key} (https://sadadpay.net/pay/{invoice_Key} in Live). The key ends with the invoice ID: 2658568171599 is invoice 71599.

Confirm the payment

However the invoice was created, check that it is paid before you deliver:

  • In the portal: the invoice status in Invoices changes to Paid, and you get a notification.
  • In your system: call GET /api/Invoice/getbyid?id={id} and check status. For invoices you create through the API, you can also receive a webhook. Invoices created in the portal do not send webhooks.
StatusMeaning
UnpaidWaiting for payment
PaidPaid successfully
DepositedPaid, and transferred to your bank account
RefundedThe full amount was refunded. After a partial refund the status stays Paid.
CanceledCancelled before it was paid
ExpiredThe expiry date passed and the payment page was opened. Until then, an expired invoice can still show Unpaid.

Common errors

errorKeyEndpointCauseHow to fix
InvoiceCannotBeUpdatedupdateThe invoice is already paidOnly unpaid invoices can be changed
InvoiceCannotBeDeleteddeleteThe invoice is already paidUse a refund instead
InvalidAmountcreatepaymentlinkinvoiceThe amount does not match the fixed link, or is outside the variable link's rangeSend the link's amount, or an amount within its range
CustomerNameRequiredcreatepaymentlinkinvoicecustomer_Name is missingSend the customer's name
CustomerMobileRequiredcreatepaymentlinkinvoiceThe paymentLink_Key does not existCheck the key at the end of your payment link URL, and that you are using the right environment
UnauthorizedAccess (HTTP 401)AllThe Access Token is missing, wrong or expiredGenerate a new Access Token

Next steps