Fix · Payments

Customer's card is declined (not my website's error)

Kuwait and Gulf

What you may see

Some cards fail, others pass
The bank asks for an extra confirmation code that never arrives

Most likely cause

Banks decline for many reasons on their side (limits, online use switched off, the extra confirmation step), and the gateway only passes the answer on.

Check first (about two minutes)

Read the exact decline text the gateway returns (not the bank).

The fix prompt

What you type here never leaves your browser. The search runs on this page, and nothing is sent to a server or to an AI.

The exact error or what you see

What you did before it happened

Kept only in this browser, on this device. Keys and passwords are removed before anything is saved.

Prompt language

You are a very careful senior engineer who knows online payments (including payment gateways used in Kuwait) and explains them to people who are not developers. I am not a developer, so explain every step in plain words and tell me exactly which button, menu or command you mean. If you are not sure about something, say so; do not guess.

I am in Kuwait. If the service has a Kuwait or Gulf rule or option that matters here (for example KNET, Arabic right-to-left text or local time), take it into account.

THE PROBLEM
Customer's card is declined (not my website's error)

THE EXACT ERROR OR WHAT I SEE
[paste the exact error here]

WHAT I DID BEFORE IT HAPPENED
[write in a few words what you did before it happened]

MOST LIKELY CAUSE
Banks decline for many reasons on their side (limits, online use switched off, the extra confirmation step), and the gateway only passes the answer on.

DO THESE STEPS, IN THIS ORDER
1. Show the customer the gateway's reason in plain words and what they can do (try another card or method, call their bank, check online-use limits).
2. Offer a second payment method when possible (for example another card type or cash on delivery if the business allows it).
3. Keep the cart so the customer can retry without starting again.
Stop and tell me if what you see does not match a step. Do not skip ahead.

CHECK THAT IT WORKED
- A declined payment shows a clear message and keeps the cart, and a retry works.
Tell me exactly what I should see on the screen when it works.

DO NOT CHANGE
- Do not store card numbers.
- Anything I did not ask about: the design, the text, other pages, other settings or the data.
- Do not delete files, data or branches, do not reset or force-push, and do not rewrite history, unless you first show me exactly what would be lost and I say yes.
- Do not paste, print or ask me to paste a password or secret key into this chat. If one is needed, tell me which settings page of the right service to store it in.

WHEN YOU FINISH
Explain in simple words what you changed (file by file or setting by setting), why you changed it, and how I can undo it.

Paste it into Claude, ChatGPT, Gemini or Cursor, then follow what it says.

After you tried it, did it work?

Steps

Show the customer the gateway's reason in plain words and what they can do (try another card or method, call their bank, check online-use limits).
Offer a second payment method when possible (for example another card type or cash on delivery if the business allows it).
Keep the cart so the customer can retry without starting again.

Do not do this

Do not blame the website for every decline.
Do not store card numbers.

Try another entry