Stripe Configuration Reference

Quick reference for Stripe payment gateway settings.

Step-by-Step Tutorials

For complete setup instructions, see:

• Stripe Test Mode Setup — Development and testing
• Stripe Live Mode Setup — Production payments

Settings Overview

Located at PaywallWP → Settings → Payments → Stripe

Setting	Description
Mode	Disabled, Test Mode, or Live Mode
Publishable Key	Your pk_test_ or pk_live_ key
Secret Key	Your sk_test_ or sk_live_ key
Webhook Secret	Your whsec_ webhook signing secret

API Keys

Get your keys from Stripe Dashboard → Developers → API Keys

Environment	Publishable Key	Secret Key
Test	pk_test_...	sk_test_...
Live	pk_live_...	sk_live_...

Webhook URL

https://yoursite.com/wp-json/paywallwp/v1/stripe-webhook

Create webhooks at Stripe Dashboard → Developers → Webhooks

Required Events

Event	Purpose
checkout.session.completed	Initial payment
customer.subscription.created	New subscription
customer.subscription.updated	Subscription changes
customer.subscription.deleted	Cancellation
invoice.paid	Renewal payment
invoice.payment_failed	Failed payment
charge.refunded	Refund

Test Cards

Card	Result
4242 4242 4242 4242	Success
4000 0000 0000 0002	Declined
4000 0025 0000 3155	3D Secure required

Use any future expiry, any 3-digit CVC, any ZIP code.

Useful Links

Resource	URL
Test API Keys	https://dashboard.stripe.com/test/apikeys
Live API Keys	https://dashboard.stripe.com/apikeys
Test Webhooks	https://dashboard.stripe.com/test/webhooks
Live Webhooks	https://dashboard.stripe.com/webhooks
Test Payments	https://dashboard.stripe.com/test/payments
Test Cards Reference	https://docs.stripe.com/testing#cards

Troubleshooting

Issue	Solution
Invalid API Key	Check key format matches mode (test/live)
Webhook errors	Verify URL, HTTPS, and signing secret
Payment works, subscription doesn't	Webhook issue — check delivery logs

For detailed troubleshooting, see the Troubleshooting Guide.