Payments in chat: fix common problems

Updated on

Each error in ChatDesq has a How to fix link to its section here.

Connecting a gateway

The gateway didn't accept these keys

The Key ID or secret is wrong, or the keys were regenerated. Copy them again from the gateway (Razorpay: Account & Settings → API Keys; Cashfree: Developers → API Keys) and paste them with no spaces. Razorpay shows a new secret only once, so regenerate if you didn't save it.

Live or Test doesn't match the key

Razorpay test keys start with rzp_test_ and live keys with rzp_live_. Pick the mode that matches the key you pasted. For Cashfree, use Sandbox keys with Sandbox and Production keys with Production.

The gateway refused the request

ChatDesq shows the gateway's own words. The usual reasons: your live account isn't activated yet (finish KYC, or use Test keys meanwhile), or Razorpay's limit on test-mode payment links was reached.

The gateway isn't answering

Razorpay or Cashfree didn't respond in time. Nothing was sent and no link was made. Try again in a minute.

“Needs attention” on a gateway

The gateway stopped accepting the saved keys, usually because they were regenerated or revoked. Open Integrations → Payments, click Replace keys and paste the current ones. Open links keep their last known status and update again once the keys work.

Webhook: waiting for the first event

For Razorpay, add the webhook in Razorpay (Account & Settings → Webhooks) with the URL, secret and four events shown on the Payments page; see Connect Razorpay. The chip turns green after the next paid, expired or cancelled link. Until then, payments still update within a few minutes. For Cashfree there's nothing to set up; the chip turns green after the first payment event.

Sending a payment request

Payments aren't connected

No gateway is connected yet. An owner or admin can connect Razorpay or Cashfree in Integrations → Payments.

The chat window is closed and the template isn't ready

The customer hasn't written to you in 24 hours, so WhatsApp needs an approved template, and the payment template is still pending, rejected or missing on this number. You can:

  • Ask the customer to send any message first. That opens the chat window and the request goes as a free chat message.
  • Check the Health box in Integrations → Payments. If a template was rejected or not submitted, click Submit again.

No payment link is made when this happens, so nothing is left open by mistake.

Wallet balance too low

The chat window is closed, so the request needs a template message, and your wallet can't pay for it. Top up in Settings → Billing, or ask the customer to message you first so it goes as a free chat message.

Amount above your limit

Requests above the maximum amount in Integrations → Payments → Settings are refused, to catch typing mistakes. Check the amount, or ask an owner to raise the limit.

Too many payment requests this hour

Each workspace can send a limited number of payment requests per hour, to stop misuse. Wait a little and try again. If your business really needs more, message us.

The payment link exists but the WhatsApp message didn't go out. The card shows why: for example the customer blocked the number, the number is restricted by Meta, or the chat window closed and no template could be used. Click Retry send, or Copy link and share it another way. The link isn't cancelled automatically.

Payments aren't enabled for this workspace

Payments were switched off for your workspace. Message us on WhatsApp and we'll check it with you.

After sending

The customer says they paid but the card says waiting

Click Refresh status on the card. It asks the gateway right now. If the gateway still says unpaid, the payment didn't go through (for example a declined UPI payment); the link stays open so the customer can try again.

The card says “Check amount”

The amount paid differs from the amount requested. No “Payment received” message was sent. Check the payment in your gateway dashboard and contact the customer.

Stuck? Message us on WhatsApp from the Help menu in your dashboard, every day 10:00 to 19:00 IST, or book a free setup call.

Frequently asked questions

Where do I see why a template was rejected?

In Integrations → Payments, the Health box shows each number’s template status with Meta’s reason, and a Submit again button.

Can a payment be marked paid after the link expired?

Yes. If the customer paid just before the link expired, the gateway’s answer wins and the request shows as Paid.

Related articles

Still stuck? Email support or book a demo.

Get your costStart for free