Adopt existing Stripe customers from a prior system

If your organization used another membership system with Stripe as the payment processor, your members’ saved cards are already stored in Stripe. This guide shows you how to link those existing Stripe records to your MapleGather members so they don’t need to re-enter their card details.

Who can do this: Admins with the billing:configure-processor permission (to list Stripe customers and run auto-match), billing:write (to apply matches), and billing:read-processor (to view the customer list). Typically all three are held by the primary admin.

Before you start

You must have Stripe connected to MapleGather first. See Connect Stripe and configure your payment processor.
Your members must already be imported into MapleGather before you run the match step.
This is a one-time migration step, typically done right after connecting Stripe.

Steps

Review your existing Stripe customers

Open the Stripe customers page. No admin menu entry links to it yet, so go to /admin/billing/migration/stripe-customers on your MapleGather admin address.
MapleGather lists all Stripe Customer records found in your connected Stripe account. You can see each customer’s email address, name, saved card (card brand and last four digits) and Match status (matched or unmatched).
The list has no search or filter. Scan the Match status column to find the customers that are still unmatched.

Match customers to members

Select Match customers to members.
On the Match Stripe customers page, select Run auto-match. The Suggested match column fills in for each customer. MapleGather matches Stripe Customer email addresses to your member email addresses; the page has no controls to change an individual suggestion or to resolve a conflict side by side.
Select Apply matches, then select Apply matches again in the confirmation dialog.
MapleGather links each Stripe Customer to the matching member record. You’ll see a confirmation showing how many members were matched.

If your emails changed during migration: auto-match pairs records by email only, and there is no CSV upload or manual mapping yet. Correct the email address on the member record in MapleGather (or on the customer in your Stripe Dashboard) so the two agree, then run the match again.

Create subscriptions against existing customers

After applying matches, select Continue to activate subscriptions. On the Activate subscriptions page, check the Member ID (pre-filled with a matched member), enter the Membership level, and select Activate subscription. Repeat for each matched member who needs a subscription. This page doesn’t check whether the matched card has expired — see If something goes wrong below.

Verify

You’ll know it worked when the confirmation shows the number of members matched, and the Match status column on the Stripe customers page shows those customers as matched. MapleGather has no control to reverse an applied match yet.

If something goes wrong

Conflict — one member matches multiple Stripe Customers — see Duplicate Stripe customer match conflict.
Most customers stay unmatched — your Stripe Customer emails don’t match your member emails. There is no CSV upload or manual mapping yet; correct the emails so they agree (in MapleGather or in your Stripe Dashboard), then run the match again.
“This member is already matched to another Stripe customer.” — applying the matches was refused because a member in the batch already has a different Stripe customer linked. See Duplicate Stripe customer match conflict.
A matched card is expired — MapleGather doesn’t flag this before a charge. When a charge to that card is declined as expired, the decline notice (on the charge form or on the payment’s detail page) offers Send card-update link, which emails the member a link to add a new card.