Overview
Extole Offers connects your Stripe account to your Extole programs. Stripe sends events such as a successful payment, a subscription change, or a paid invoice to Extole. Extole identifies the person, evaluates your campaign, and — when a reward is earned — calls the Stripe API to issue it as a native Stripe object on that customer’s account. No separate payout system is required. You can issue a credit on the customer’s Stripe balance, a promotion code redeemable against a Stripe coupon, or both.Prerequisites
Available Products
Customer Balance
Issues a reward as a credit on the customer’s Stripe balance. You configure a face value and currency. The credit amount is negative on the Stripe balance transaction, which reduces what the customer owes on their next invoice.Promotion Code
Issues a reward as a Stripe promotion code, redeemable against a coupon you created in Stripe. You configure a face value (for display), select the coupon from the connected Stripe account, and can optionally restrict redemption to the customer’s first transaction.How Identity Works
When a Stripe event arrives, Extole takes the Stripe customer ID from the event and stores it aspartner_user_id. Email, when present, is a secondary identifier.
Rewards are issued to that Stripe customer. If the person being rewarded did not arrive on a Stripe event — for example, an advocate whose friend converted in another system — the integration looks up a Stripe customer by the person’s email and stores the matching customer ID.
The lookup succeeds when Stripe has one customer for that email. If Stripe has none, or more than one, Extole cannot issue the reward until the person has a Stripe customer ID.
Integration
Step 1: Add Extole Offers
- In My Extole, go to Partners.
- Add Extole Offers (Stripe).
- If it is not listed, contact support@extole.com to have it added to your account.
Step 2: Store Your Stripe Key
- In Stripe, create a secret key or a restricted key. For your first setup, create the key in test mode.
- In My Extole, go to Security Center > Keys and click + New Key.
- Set Type to Webhook and Algorithm to Password, and paste the Stripe key as the value.
- Open Extole Offers (Stripe), go to the Configuration tab, and set Stripe Secret Key to that Client Key.

Step 3: Send Stripe Events to Extole
- In the Security Center, create an access token. Copy it and save in a safe place; as you will not be able to view it again.

-
In the Stripe Dashboard, go to Developers > Webhooks and add an endpoint:
-
Select these events:
payment_intent.succeededcustomer.subscription.createdcustomer.subscription.updatedinvoice.paid
Step 4: Configure Rewards
- Create any Promotion Code coupons in Stripe before you continue. They will not appear in Extole until they exist in the connected Stripe account.
- In the integration’s Rewards tab, add Customer Balance, Promotion Code, or both.
- For Customer Balance, set the face value and currency.
- For Promotion Code, select a Stripe coupon, set the face value, and optionally restrict redemption to the customer’s first transaction.
- In the Flow Builder, open the reward on the event that should issue it and select the Stripe reward supplier.
Test in Stripe Test Mode
- Point the webhook and the Client Key at Stripe test mode.
- Send a test event from the Stripe Dashboard, or complete a test payment.
- In My Extole, confirm the event appears on the person’s profile.
- Confirm the reward in Stripe: a customer balance transaction, or a promotion code on the customer.
- Switch the Client Key and the webhook to live keys only after that check passes.
Partner to Extole Event Mapping
The following fields are extracted from each arriving Stripe event onto the corresponding Extole event:
Field presence depends on the Stripe object type.
Reward Fulfillment
When a reward is earned, Extole calls Stripe:
Both calls include
metadata[extole_reward_id] (the Extole reward ID) on the created Stripe object. Extole lists coupons with GET /v1/coupons when you configure a Promotion Code reward.
