Skip to content
MapleGatherMapleGather Help

Stripe connection failed or verification required

This article helps you resolve problems connecting Stripe to MapleGather or completing Stripe’s verification requirements.

What’s happening

Section titled “What’s happening”

One of several things can prevent a successful Stripe connection:

  • You left Stripe’s Connect page before completing the authorization.
  • Stripe requires additional identity or business verification (KYC) before your account can accept live payments.
  • A transient outage prevented MapleGather from contacting Stripe’s API.
  • Your admin account doesn’t have the billing:configure-processor permission.

How to fix it

Section titled “How to fix it”

Find your error message and follow the matching steps.

“Setup was not completed — connect Stripe to start accepting payments”

  1. Go to Payment processor (at /admin/billing/payment-processor).
  2. Select Connect Stripe again.
  3. Complete the full Stripe Connect authorization flow without closing the browser tab.

“Your Stripe connection needs attention”

  1. On the Payment processor page, select Reconnect in that message.
  2. Complete Stripe’s onboarding (business name, address, bank account, and any identity documents required).
  3. Return to MapleGather. The banner clears when verification is approved. If approval takes longer, Stripe sends you an email — return to confirm the status afterwards.

Note: You can run test payments while verification is pending. Test mode doesn’t require full KYC.

“Couldn’t reach Stripe — try again”

  1. Wait one to two minutes, then select Connect Stripe again.
  2. If the error continues, check Stripe’s status page for any active incidents.
  3. This message means MapleGather asked Stripe to start the connection but didn’t get a Stripe page back to send you to. If Stripe is operational and it keeps happening, the connection can’t be started from this page right now; nothing was connected and your Stripe account is unchanged.

“You don’t have permission to configure the payment processor”

Contact your org’s primary admin and request the billing:configure-processor permission. Primary admins assign permissions from Settings > Roles & permissions.

Test payment declined

Run test payment is a one-click test charge with no card to enter, so there is no test card to change. The failure message names the reason; fix it and run the test again. A test-mode failure doesn’t affect your live Stripe integration.

If that didn’t work

Section titled “If that didn’t work”

If the Payment processor page shows a message not listed above, that message names what Stripe or MapleGather refused — follow it. Verification and account details are finished in Stripe: your Stripe Dashboard shows what Stripe still needs before it accepts live payments.

Section titled “Related”