Overview
There are three ways to accept payments with Shoppex:Storefront
Customers browse your shop and checkout directly
Payment Links
Share a link that takes customers straight to checkout
API
Create invoices programmatically from your app
The Payment Flow
Every payment in Shoppex follows this flow:You don’t need to integrate with Stripe or PayPal directly. Shoppex handles all gateway communication for you.
Method 1: Storefront (No Code)
Your storefront atyourshop.shoppex.io is ready out of the box:
- Customer browses products
- Adds to cart
- Completes checkout
- Receives product automatically
Method 2: Payment Links
Create a link that goes directly to checkout - perfect for sharing on social media, emails, or anywhere.Create via Dashboard
- Go to Products → Your Product
- Click Copy Payment Link
- Share the URL:
https://yourshop.shoppex.io/product/your-product
Create via API
Method 3: API Integration
For full control, create payments directly via API. This is ideal when you have your own checkout UI or need to integrate payments into your app.Create a Payment
Handle the Webhook
After payment, Shoppex sends a webhook to your server:Invoice vs Payment Link
| Feature | Invoice (API) | Payment Link |
|---|---|---|
| Use case | Custom checkout flows | Quick sharing |
| Customer email | Required | Optional |
| Multiple products | Yes | Single product |
| Custom fields | Yes | Product default |
| Expiration | Configurable | No expiration |
| Tracking | Full invoice data | Basic analytics |
- Use Payment Links for simple, shareable checkouts
- Use Invoices when you need control over the checkout or customer data
Payment Gateways
Configure your payment providers in Settings → Payments.Stripe (Recommended)
Supports: Credit cards, Apple Pay, Google Pay, SEPA, Klarna, and more.Get API Keys
Log in to Stripe Dashboard → Developers → API Keys
PayPal
Create REST App
Go to PayPal Developer → Create App
Cryptocurrency
Two options available:| Option | Setup | Fees |
|---|---|---|
| Self-hosted (BTC/LTC) | Run your own node | Network fees only |
| NowPayments / Cryptomus | API key only | Provider fees |
Testing Payments
Enable Test Mode in Settings before going live.Test Card Numbers
| Card | Number | Result |
|---|---|---|
| Visa | 4242 4242 4242 4242 | Success |
| Mastercard | 5555 5555 5555 4444 | Success |
| Declined | 4000 0000 0000 0002 | Declined |
| 3D Secure | 4000 0025 0000 3155 | Requires auth |
Test Checklist
Common Scenarios
Sell a digital product
Sell a digital product
- Create product with File delivery type
- Upload your file
- Share your storefront or payment link
- Customer pays → receives download automatically
Sell software licenses
Sell software licenses
- Create product with Serials delivery type
- Add license keys (one per line)
- Customer pays → receives unique license key
Custom checkout in your app
Custom checkout in your app
- Create invoice via API with customer email
- Redirect customer to
checkout_url - Listen for
order:paidwebhook - Fulfill order in your system
Recurring subscription
Recurring subscription
- Create product with Subscription type
- Set billing interval (monthly, yearly, etc.)
- Customer pays → subscription created
- Renewals happen automatically