Stripe

Connect Stripe and your customers get a WhatsApp message when their payment succeeds, or a message with next steps when it fails. Stripe signs every event, so only real payments from your Stripe account can send a message.

Before you start

A Stripe account. Test mode is fine for trying it out.
An approved WhatsApp template for each message you want to send. See Create a WhatsApp template. Most templates are approved within 24 hours.
Your WhatsApp number connected. See Connect WhatsApp (WABA).

Where to find your Stripe key

The app asks for one thing: the Webhook Signing Secret. Stripe creates it when you add our webhook URL to Stripe, so you copy the URL from our app first (steps 2 and 3 below). The secret starts with whsec_.

Connect Stripe

Open Stripe in the app
In the left sidebar, click Integrations. Under Payments, find Stripe (or type it in Search integrations) and click Connect.
Copy the webhook URL
Scroll down to Paste this URL in Stripe and click the copy button next to the URL.
Add the endpoint in Stripe
In your Stripe Dashboard, open Developers, then Webhooks, and add an endpoint (Stripe may call it a destination):
- Endpoint URL: paste the URL you copied.
- Events: pick payment_intent.succeeded and payment_intent.payment_failed.
Save it. On the endpoint's page, find Signing secret and click Reveal. Copy the value that starts with whsec_.
Paste the signing secret
Back in our app, paste it into Webhook Signing Secret under Add your Stripe keys.
Step 1: the signing secret from your Stripe endpoint
Choose a message for each event
Under Choose a message for each event there are two events: Payment Succeeded and Payment Failed. Click one to open it, pick a Template, check Send it to (Customer Phone), and under Fill the variables choose what goes into each blank, for example Customer Name and Payment Intent ID. The Preview shows the message.
Step 2: one template for each event
Click Connect Stripe
Click Connect Stripe in the bar at the bottom. You will see Stripe is connected, and the top of the page says Active.
Check that it works
Make a test payment in Stripe's test mode. Then open the Activity tab on the Stripe page. You should see Sent, Message sent.

Getting the customer's phone number

A Stripe payment does not always carry a phone number. We look for it in this order:

The payment's metadata, under the name phone.
The shipping details, if you collect a shipping address with a phone number.
The billing details.

If Activity says No phone number in the field you picked, ask your developer to add the customer's WhatsApp number (with the country code, for example 919876501234) to the payment's metadata as phone when the payment is created. The customer's name can be added the same way as name.

What you can put in the message

In Fill the variables	What it holds
Customer Name	From the metadata `name`, the shipping details or the billing details
Customer Email	The receipt email
Payment Intent ID	Stripe's payment ID, for example `pi_...`
Amount (cents)	The amount in the smallest unit: $50.00 arrives as `5000`, Rs 1,499 as `149900`
Currency	For example `usd` or `inr`
Payment Status	For example `succeeded`

The amount is in the smallest unit

Stripe sends 5000 for $50.00. If you put Amount (cents) in the message, it shows 5000. Leave the amount out, or word the message around it.

Change, pause or disconnect

Change a message: open the event, make your change, then click Save changes at the bottom.
Pause: switch Active off on the right. Stripe events are ignored until you switch it back on.
Disconnect: click the ⋮ button at the top right, then Disconnect, and confirm.

If a message did not go out

Open the Activity tab.

What you see	What to do
Rejected, The webhook secret did not match	Copy the signing secret from Stripe again, with no space at the end. If you rolled the secret in Stripe, paste the new one here too.
Not sent, No phone number in the field you picked	See Getting the customer's phone number.
Skipped, No message is set for the ... event	Pick a template for that event, or remove the event from the Stripe endpoint.

More fixes are in Troubleshooting.