Mada
Mada is the national card scheme. Where an organisation accepts card payment, the contact it generates is about transactions that did not go as expected.
Mada is the national card scheme. Where an organisation accepts card payment, the contact it generates is about transactions that did not go as expected.
What Mada holds, and why that matters here
Mada is the domestic debit network used across the Kingdom. For merchants and service providers, the questions it produces are transactional: did the payment succeed, why was it declined, where is my refund.
None of these require a payments specialist to answer, and all of them currently do.
- Transaction status — approved, declined, pending.
- Decline reasons — the category of failure, at the level a merchant may disclose.
- Refunds — whether a refund has been issued and when it should appear.
- Settlement — when a transaction settles to the merchant.
- References — the identifiers that link a transaction to an order.
Questions this connection lets Elbi answer
Did my payment go through?
Transaction status, answered directly.
Why was I declined?
The category of decline, at the level a merchant is permitted to explain.
Where is my refund?
Refund status and expected timing, which is the most escalation-prone payment question.
When will it settle?
Settlement timing for merchants.
Was I charged twice?
Duplicate detection, which resolves a common and alarming query.
What is this transaction?
Matching a transaction to an order.
How the connection works in practice
- You decide what is readableBefore anything is connected, you define the scope: which records, which fields, which operations. The assistant is given a narrow, named view of Mada rather than general access, and that view is agreed in writing during deployment.
- A question arrives in natural languageA customer or an employee asks something ordinary — "where is my order", "am I covered for this", "what did I spend last month". No syntax, no menu, no reference number required if the person is already identified.
- The assistant works out what is being askedThe question is matched to an intent and the details it needs. If something essential is missing, it asks for that one thing rather than presenting a form.
- It reads only what it is allowed to readThe lookup runs inside the permission scope you defined, and inside the permissions of the person asking. Someone who cannot see a record in Mada cannot see it through Elbi either — the assistant does not become a way around your own access rules.
- The answer is written back in plain languageA record is not an answer. The result is turned into a sentence in the language the question was asked in, with the parts that matter surfaced and the internal codes left out.
- Anything it cannot do goes to a personReads are safe to automate. Anything that changes money, entitlement or a legal position can be routed to a human for confirmation — you decide which side of that line each action sits.
Scope, control and what stays yours
| Direction of access | Read by default. Any write-back — creating a ticket, updating a record, logging a lead — is enabled deliberately, per action, and can be held behind human confirmation. |
|---|---|
| Who can see what | The assistant answers within the permissions of the person asking. Identity is established through your own sign-in, not invented by the assistant. |
| Credentials | The connection uses credentials you issue and can revoke, scoped to the narrow view agreed at deployment. Revoking access is something you do on your side, without our involvement. |
| Where data goes | Retrieved records are used to answer the question in front of the assistant and are not retained afterwards beyond your configured conversation retention. |
| Audit | Every lookup can be recorded — what was asked, what was retrieved, which agent, which conversation — so the connection is reviewable rather than opaque. |
| If it is unavailable | If Mada cannot be reached, the assistant says so plainly and offers a person. It does not guess at a value it could not retrieve, and it does not present a cached figure as though it were live. |
What this replaces
Refund status is the highest-value question here. Customers who have been refunded frequently cannot see it yet, contact repeatedly, and escalate — and the answer is a date that already exists.
Decline explanation is the second. There are limits on what a merchant may say about why a card was declined, and an assistant should stay firmly within them — but explaining the category and the next step resolves a large share of abandoned transactions.
Duplicate charge queries are the third. They are alarming to customers, common in practice, and usually resolved by looking at two records.
How different sectors use it
E-commerce
Payment and refund status at volume.
Retail
Transaction queries against in-store payment.
Services
Recurring payment failures and retries.
Any merchant
Refund timing, the most escalation-prone payment question.
Getting the value out of it
A connection is only as useful as the questions it is pointed at. The pattern that works is to start from the contact you already receive rather than from what the system can technically expose. Pull a month of chat transcripts and call notes, count the questions, and connect for the top five. That is almost always where the volume is, and it is usually duller than anyone expects — status, eligibility, balance, hours, documents.
The second thing that decides success is scope discipline. It is tempting to connect broadly and let the assistant work out what is relevant. It works far better to expose a small, well-named set of operations and expand once you have seen a month of real questions against them. A narrow connection is easier to reason about, easier to audit, and far easier to explain to whoever signs off on it.
The third is knowing what not to automate. Reads are safe. Anything that moves money, changes an entitlement or creates a commitment should either stay with a person or pass through one. The assistant is at its best when it removes the lookup and leaves the judgement.
What connecting it actually involves
- Agree the questions firstNot the fields, the questions. A month of real transcripts, counted, gives a ranked list of what people actually ask. That list decides the scope; the scope decides the connection. Starting from what Mada can technically expose produces a broad connection answering questions nobody asked.
- Define the readable viewYour team decides which records and fields the assistant may see, and which it must never see. This is written down, signed off, and is the document you will hand to whoever audits the deployment later.
- Issue scoped credentialsYou create the credentials, on your side, scoped to that view. They are yours: you can rotate or revoke them without involving us, and doing so takes effect immediately.
- Map your instanceCustom fields, renamed objects, local terminology and the particular way your organisation uses the system are mapped during deployment. Nobody has a stock configuration and the work assumes you do not either.
- Rehearse the unhappy pathsMissing record, ambiguous match, system unavailable, customer asking about someone else's account. These are tested deliberately before launch, because they are what determines whether people trust the assistant, and they are what most pilots skip.
- Launch narrow, widen on evidenceGo live on the top few questions, watch a month of real traffic, then widen. Every deployment that widened first and measured later has produced the same result: an assistant nobody trusts and a project that quietly stops.
Governing a connection you will have to defend
A connected assistant is a data-processing decision before it is a technology one. Under the Saudi Personal Data Protection Law, the questions that matter are the ordinary ones: what personal data is being processed, on what lawful basis, for how long it is kept, who can see it, and what happens when someone asks for it to be deleted. A lookup against Mada touches most of those at once.
The practical answer is scope and evidence. Scope means the assistant reads a narrow, named view rather than holding broad access, so the question "what could it see?" has a short and checkable answer. Evidence means every lookup can be recorded — the question, the retrieval, the agent, the conversation — so a review after the fact is reading a log rather than reconstructing a story.
The part most organisations underestimate is consent. If a customer is going to have their record read during a conversation, that has to be something they agreed to, in language they understood, in the language they speak. Retrofitting consent after launch is far more painful than designing the flow around it, and it is the single most common reason a pilot stalls at legal review rather than at the technical stage.
What organisations typically see
How this is done elsewhere, and where it goes wrong
The mainstream pattern across the industry is now well established: a conversational layer in front of systems of record, retrieving rather than remembering, escalating rather than improvising. Where deployments fail, they fail in recognisable ways.
The most common failure is connecting everything at once. A broad connection is harder to reason about, harder to permission correctly, and produces an assistant that occasionally surfaces something it should not — which is the single fastest way to lose internal trust and have the project shut down. Narrow beginnings survive; broad ones get switched off.
The second is treating the assistant as a reporting tool. Systems of record are optimised for transactions, not analysis, and an assistant asked to compute across large volumes will be slow and occasionally wrong. Point it at facts about a specific record and it is excellent; point it at "summarise our quarter" and it is the wrong instrument.
The third is forgetting the unhappy path. Systems go down, records are missing, a customer asks about an order that does not exist. What the assistant does in those moments defines how it is perceived far more than what it does when everything works — which is why saying "I could not reach that system" is a feature, not an admission.
Common questions
At the category level a merchant is permitted to disclose, with the next step. Detailed issuer reasons are not the merchant's to share.
No. It reports refund status. Issuing one is a financial decision with a person.
Where transaction records are connected, yes — a common and alarming query resolved by comparing two records.
No. The connection runs between your assistant and your system, using credentials you issue and control. What the assistant may read is the narrow scope you defined, and you can revoke it at any time without going through us.
Most deployments are. Custom fields, renamed objects and bespoke workflows are normal, and the connection is mapped to your instance during deployment rather than assuming a stock configuration.
It can, where you enable it. The default is read-only because that is the safe starting point. Write actions are turned on individually and can require a person to confirm before they commit.
Connect it to your own systems
A working assistant against your own records, in both languages.