Stripe

Trigger surveys from Stripe payment events

The Stripe integration allows you to automatically send email or SMS surveys to your customers based on Stripe events like checkout completions, refunds, and subscription changes.

Step 1: Connect Your Stripe Account

1. In Zigpoll, go to Settings -> Manage Integrations

2. Find Stripe in the integrations list and enable it

3. Enter your Stripe API Key (secret key or restricted key)

4. Press Save

You can use a full secret key (sk_live_... or sk_test_...) or a restricted key. If using a restricted key, it must have the following permissions enabled:

• Customers - Read

• Webhook Endpoints - Write

Step 2: Create a Survey

1. Go to your account dashboard and click Create Survey

2. Choose a question template or build your own slides

3. In the delivery step, select one of the Stripe templates:

Template	Stripe Event	Description
Checkout Completed	checkout.session.completed	Sent after a Stripe Checkout session is completed
Charge Refunded	charge.refunded	Sent after a refund is processed
New Subscription	customer.subscription.created	Sent when a customer starts a new subscription
Subscription Cancelled	customer.subscription.deleted	Sent when a subscription is cancelled

Each template supports both Email and SMS delivery. Use the dropdown on the template card to choose your preferred channel.

1. Adjust the Trigger Settings to control the delay before sending (e.g., send 1 hour after the event)

2. Click Create Survey

Zigpoll will automatically register a webhook endpoint on your Stripe account. You can verify it in your Stripe Dashboard under Developers -> Webhooks.

Step 3: Customer Targeting (Optional)

You can filter which customers receive the survey based on Stripe event data. Go to the Targeting tab on your survey and configure rules using:

• Amount - Filter by payment amount (e.g., only send for orders over $50)

• Currency - Filter by currency code (e.g., only USD transactions)

• Metadata - Filter by Stripe metadata key=value pairs

• Product IDs - Filter by Stripe product IDs

• Price IDs - Filter by Stripe price IDs

Step 4: Customize Your Email

Go to the Email tab on your survey to customize:

• Subject line

• Header, body, and footer text

• Button text and colors

• Sender name and reply-to address

How It Works

1. When the configured Stripe event fires, Stripe sends a webhook to Zigpoll

2. Zigpoll verifies the webhook signature and extracts the customer's email

3. After the configured delay, Zigpoll sends the survey via email or SMS

4. Responses are tracked in your Zigpoll dashboard with Stripe metadata (customer ID, amount, event type)

Troubleshooting

Survey not being sent?

• Check that your survey is visible (not hidden or archived)

• Check the Activity tab to see if emails were queued and sent

• Verify the webhook endpoint exists in your Stripe Dashboard under Developers -> Webhooks

• For subscription events, the customer email is fetched from the Stripe Customer object. Make sure your customers have an email address on file.

Permission error when creating a survey?

• Your API key needs Webhook Endpoints write permission. If using a restricted key, update its permissions in the Stripe Dashboard.

Webhook showing 403 errors?

• The webhook signing secret may be out of sync. Try deleting the survey and creating a new one to re-register the webhook.