Money
Tracking payments: sent, overdue and expired links
The payment ladder, the state of each link, and why a payment needs the gateway's confirmation even if the customer says “I transferred it.”
6 minOpen lesson
- Home
- Learning Centre
- Money
- Activating a payment gateway with its fields named the way it names them
Activating a payment gateway with its fields named the way it names them
Every gateway names its keys in its own way. Where to find each key, and the difference between a test key and a live key.
Money · 7 min read
The dashboard is in development.
This lesson shows how the dashboard will work once it reaches subscribers. Until then we handle the setup for you, and you get escalation and payment alerts on your WhatsApp plus a monthly report.
Every Saudi payment gateway has its own names for its keys, and asks for a different number of them. The Gateways screen labels the fields with the exact names from the gateway's documentation, so copy and paste works the first time.
Here you'll learn where to find each gateway's keys, the difference between a test key and a live key, and why the system can't set an amount on its own.
Always start with test
Enable the gateway with the test key, issue a link, and open it yourself. Then switch to the live key.
Keys
Exactly what each gateway asks for
| Gateway | Fields | Note |
|---|---|---|
| Moyasar | Secret key | One field you paste as is |
| Paylink | apiId and secretKey | You paste both as they are, and the system handles the rest |
| Tap | Secret key | STC Pay also goes through it as a payment method |
The other Saudi gateways appear on the screen with how each one works, so you know what to expect, and we connect them when you ask for them.
Activation
Five steps to your first working link
- 1Open the gateway's dashboard and copy the test keys.
You'll usually find them under “Developers” or “API keys”. Note: some gateways show the secret key only once.
- 2Paste them into the gateway's row and enable the key.
The fields are labeled with their original names, so there's no guessing.
- 3Approve a test contract.
Don't issue the link manually. Let it go out after approval, the way it will with your customers, because that's what you're testing.
- 4Open the link on your phone.
And check that the amount, description and your business name appear the way you want your customer to see them.
- 5Switch to the live key.
The system will ask for an explicit confirmation before saving it, because links after that charge customers' cards.
Protecting the amount
The system can't write an amount into a link
This is the most important point here. There's no command in the system like “create a payment link for this amount” that AI can carry out. The amount comes from the payment schedule of the contract you approved, and the link message is written and sent by the system without AI.
The reason is that if AI could set the amount, one crafty message from a customer would be enough to issue a link for SAR 1 on a SAR 20,000 contract.
And a payment is never recorded based on a message.
A customer saying “I've transferred it” isn't enough, and neither is a photo of the receipt. The payment is recorded when the gateway itself confirms it, and then the system checks with the gateway a second time before recording it.
What happens next is covered in tracking payments.
Frequently asked
What's the difference between a test key and a live key?
A test key produces payment links that look real but don't charge a single riyal, and that's what you test with. A live key charges the customer's card, so the system asks for an explicit confirmation before saving it.
Can the system decide the amount itself?
No. The amount is taken from the payment schedule of the contract you approved, and the link message is written by the system from a fixed template, so nothing said in the conversation can change the amount.
Next lesson
Money
Daily work
Approving a quote or contract: a step that stays with you
The system prepares the document and waits for your approval before sending it. Why approval is always manual, and how to approve from WhatsApp with a single message.
7 minOpen lesson