Syriatel Cash payment bots: common questions from store owners
Store owners ask the same things before going live: no memo field on Syriatel Cash, confirmation by transaction ID plus amount, screenshots handled by asking for pasted text, reused IDs rejected, and wrong amounts sent to a person. Hosted gateway $2/month per number; payment bot from $120 one-time.
Most of the shops that write to me already sell inside Telegram or WhatsApp. The customer transfers Syriatel Cash, and someone on staff matches a screenshot with the wallet app. They need straight answers about confirmation, edge cases, and what the hosted gateway will and will not do.
The full build is in How to build a Telegram bot that accepts Syriatel Cash. The Arabic customer-facing walkthrough is بوت تيليغرام يستقبل دفعات سيريتل كاش. The questions below are the ones I hear before a shop goes live.
I run that hosted gateway for Syriatel Cash, and for Sham Cash if you need both. It talks to a number you already own. The Syriatel Cash API is $2 per number per month, a payment bot starts from $120 one-time, setup is same day, and you do not receive gateway source code.
Does the customer type a note or order number into the transfer?
No. Syriatel Cash transfers have no memo or reference field. Do not ask the customer to type an order code into the wallet. After the payment succeeds, the app or the SMS shows a transaction ID (رقم العملية). That is what they paste into the bot. Sham Cash has no memo field either, so the same rule applies if you accept both.
How does the bot know which order was paid?
It matches on the transaction ID and the amount together. You create the order first, with a known total. The customer pays, pastes the ID, and the bot asks the gateway to look that ID up. If the amount agrees, the order is marked paid and the ID is stored with a unique constraint so it cannot close a second order.
The gateway also returns the sender number on every transfer. I save it on the order. I do not use it as the match key. A parent may pay from their phone while the child is in the chat, and a sender number will not line up with a Telegram account anyway.
``javascript function confirmPayment({ order, lookup }) { if (lookup.status !== "found") return { ok: false, reason: "not_found_yet" }; if (Number(lookup.amount) !== Number(order.amount)) { return { ok: false, reason: "amount_mismatch", senderNumber: lookup.senderNumber }; } return { ok: true, transactionId: lookup.transactionId, senderNumber: lookup.senderNumber }; } ``
The unique constraint on transactionId belongs in the database, not only in this function. A wrong amount should still bind the ID to that order so it cannot pay a different one. The site-side version of the same rule is in Syriatel Cash API: Accept Payments on Your Site.
What if two customers pay the same amount a minute apart?
That is fine, as long as each person pastes their own transaction ID. The bot must not pick an unpaid order by amount alone. Amount-only matching is how two 25,000 SYP orders get swapped or confirmed twice from one transfer.
If a customer pastes an ID that already paid a previous order, reject it and ask for the new ID. Search the dashboard by that ID before you confirm anything by hand.
The customer sent a screenshot instead of the ID. Now what?
This is the default habit in Syrian shops, so the first version of the bot should expect it. If an image arrives while the order is waiting for payment, reply and ask them to copy the transaction ID as text. I do not start production confirmation by reading digits off a photo. OCR fails on compressed images and on receipts that show more than one number.
If they type the ID inside a sentence, pull out the single clear digit sequence. If two sequences appear, ask which one it is.
Can the bot confirm a payment if the customer never comes back to the chat?
A typed ID is enough when they do come back. If you also want confirmation when they pay and disappear, add a webhook from the gateway to your server and notify the chat yourself. How to accept that event once, and only once, is in Reliable payment webhooks. Many shops go live with the pasted ID and add the webhook later.
Should I match on the sender's phone number?
No. The sender number is useful in the admin notification and in a later dispute, not as a condition for marking the order paid. People pay from a relative's wallet. The reliable pair is still transaction ID plus amount.
What should the bot do with a wrong amount?
Flag the order for review, bind the transaction ID to it, and tell both the customer and the shop owner. Do not mark it paid, and do not leave the ID free for a second order of the same size. A person decides whether to collect the difference, refund through the wallet's own process, or adjust the order.
Do I need a website, or can the bot be the whole shop?
The bot can be the shop. Plenty of catalogs already live in Telegram. You still need a server the bot and the gateway can reach, and a small admin view for cases the bot will not settle. A website is optional for the payment check.
Can the same bot accept Sham Cash?
Yes. Each wallet is a separate subscription: $2 per Syriatel Cash number per month, $5 per Sham Cash account per month. An order should wait on one wallet at a time. Do not ask for a memo on either one.
Will the bot replace my cashier at night?
It will confirm a clean payment at 1 a.m. without anyone opening the official app. It will not invent a decision when the amount is wrong, the ID is reused, or the customer paid after you closed the order. Those cases need a person and an admin alert. Receiving limits stay between you and Syriatel and can change, so check the current limit on your number before a busy day.
How long does setup take, and do I get the gateway source code?
Setup is same day, once your wallet number and the bot token are ready. You can ask for a test against the gateway before the live number. The gateway is hosted. You do not receive its source code. If you are writing the bot yourself, you call the gateway; if you want the bot built as well, that work starts from $120 one-time.
If you want a Syriatel Cash payment bot, or the hosted gateway under a bot you already have, write through the form on fayezalshami.com or email fayezalshami.dev@gmail.com. Say which wallet you use, whether the shop is already in Telegram or WhatsApp, and whether confirmation today is a screenshot or a typed transaction ID.