This article is for the person who owns the WordPress site. Contractors do not do this part. One Stripe account on your site powers online invoice payments, AI credit packs, storage packs and subscriptions.

Note: Stripe changes its screens often. Follow Stripe’s current instructions for each step. This article names the VisionScaper fields and the exact event names.

1. Create or open your Stripe account and finish its business details so it can accept payments.
2. In Stripe, copy your secret API key. It starts with sk_live_. Use a test key (sk_test_) while you practice.
3. In WordPress, go to Settings → VisionScaper. Paste it into Stripe secret key.
4. In Stripe, add a webhook endpoint. Copy the exact address from the numbered instructions under Selling extra AI credits on the Settings → VisionScaper page. It is built from your own site address.
5. Add these events to the endpoint:
   – checkout.session.completed
   – checkout.session.async_payment_succeeded
   – checkout.session.async_payment_failed (bank payments)
   – account.updated
6. Copy the endpoint’s signing secret. It starts with whsec_. Paste it into Stripe webhook signing secret.
7. In Stripe, turn on Connect (Express accounts) so contractors can connect their own accounts.
8. Click Save Changes.

The settings page does not list these, but other features read them if you add them:

• Contractor subscriptions: customer.subscription.created, customer.subscription.updated, customer.subscription.deleted, invoice.paid, invoice.payment_failed.
• Autopay and card reader: payment_intent.succeeded, payment_intent.payment_failed, payment_intent.canceled.

It checks Stripe’s signature, refuses messages older than 10 minutes, and applies each message once. A repeat is ignored.

• Practice in test mode first, including Instant Payouts.
• Credit purchases are also confirmed when the customer returns, so a missed webhook does not lose a purchase.

• “Not configured” or “Bad signature.” The signing secret is empty or does not match this endpoint.
• Contractors see “Online payments aren’t set up on this website yet.” The secret key is empty.
• Invoices stay unpaid after a payment. Check that the events above are on the endpoint.

• Connect your Stripe account
• Processing fee settings (site owner)
• Sell AI credit packs and extra storage (site owner)