Stripe Payment Setup

Connect Stripe to accept credit cards, Apple Pay, Google Pay, and more.

Why Stripe?

• ✅ Trusted by millions of businesses
• ✅ PCI-DSS Level 1 compliant (most secure)
• ✅ Supports 135+ currencies
• ✅ Built-in fraud protection
• ✅ Fast payouts (2-3 business days)

Prerequisites

Before connecting Stripe:

1. Create a Stripe account at stripe.com
2. Complete business verification
3. Add bank account for payouts

Connect Stripe to Your Store

Step 1: Navigate to Payment Settings

1. Go to Stores → Select your store
2. Click "Settings" → "Payments"
3. Click "Connect Stripe"

Step 2: Authorize Connection

1. Sign in to your Stripe account
2. Review permissions requested
3. Click "Connect"
4. You'll be redirected back to your dashboard

Step 3: Configure Payment Methods

Enable payment methods for your customers:

• ✅ Credit/Debit Cards (Visa, Mastercard, Amex)
• ✅ Apple Pay
• ✅ Google Pay
• ✅ Link (Stripe's 1-click checkout)

Testing Your Setup

Use Stripe test mode to verify everything works:

Test Card Numbers:

Success: 4242 4242 4242 4242
Decline: 4000 0000 0000 0002
3D Secure: 4000 0025 0000 3155

Test Details:

• Expiry: Any future date
• CVC: Any 3 digits
• ZIP: Any valid ZIP code

Going Live

When ready to accept real payments:

1. Go to Stripe Dashboard
2. Toggle "Test Mode" to OFF
3. Complete identity verification (if not done)
4. Add bank account for payouts

Payment Flow

Here's what happens when a customer checks out:

1. Customer enters payment info
2. Stripe securely processes payment
3. You receive confirmation webhook
4. Order sent to fulfillment automatically
5. Funds deposited to your bank (2-3 days)

Fees & Pricing

Stripe charges:

• 2.9% + $0.30 per successful transaction
• No monthly fees
• No setup fees
• No hidden costs

Example:

Sale Amount: $50.00
Stripe Fee: -$1.75 (2.9% + $0.30)
Net Payment: $48.25

Handling Refunds

Process refunds directly from your dashboard:

1. Go to Orders → Find order
2. Click "Refund"
3. Enter refund amount (full or partial)
4. Click "Process Refund"

Funds returned to customer in 5-10 business days.

Webhooks

Stripe sends real-time updates via webhooks:

Automatic Events:

• payment_intent.succeeded - Payment completed
• payment_intent.failed - Payment failed
• charge.refunded - Refund processed
• charge.disputed - Chargeback filed

All handled automatically by our platform!

Troubleshooting

Common Issues:

"Stripe connection failed"

• Solution: Clear browser cache and try again
• Or use incognito mode

"Payment declined"

• Customer should contact their bank
• May be fraud protection trigger
• Try different card

"Webhook not received"

• Check webhook URL in Stripe dashboard
• Should be: https://ds.vai.me/webhooks/stripe

Security

Your customers' payment data:

• ✅ Never touches your servers
• ✅ Encrypted with TLS 1.2+
• ✅ PCI-DSS compliant automatically
• ✅ Stripe's fraud detection included

Support

Need help with Stripe?

• Stripe Support: support.stripe.com
• Our Support: [email protected]

Setup Time: 5-10 minutes