Skip to main content
This page is the hosted/public Shoppex quickstart. It uses the public invoice flow under /v1/invoices. If you want the Developer API instead, use Developer API Quick Start.

​
Create Your Shop

1

Sign Up

Create your free Shoppex account at dashboard.shoppex.io.You’ll receive a unique shop URL like yourshop.shoppex.io.
2

Configure Payment Gateway

Connect at least one payment provider in Settings → Payments:
  • Stripe - Credit cards, Apple Pay, Google Pay
  • PayPal - PayPal balance and cards
  • Crypto - Bitcoin, Litecoin, USDT
We recommend starting with Stripe for the best customer experience.
3

Create Your First Product

Go to Products → Create Product and fill in:
  • Product name and description
  • Price and currency
  • Delivery method (download, license key, or custom)
4

Test Your Checkout

Enable Test Mode in Settings and create a test invoice to verify everything works.Use these Stripe test card numbers (any future expiry, any 3-digit CVC):
CardNumber
Visa4242 4242 4242 4242
Mastercard5555 5555 5555 4444
Declined4000 0000 0000 0002
These numbers are Stripe-specific. PayPal and crypto gateways have their own test modes — check each provider’s sandbox docs.

​
Public API Example

Want to create a public checkout invoice programmatically? Here’s a quick example: 
const response = await fetch('https://api.shoppex.io/v1/invoices', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    customer_email: '[email protected]',
    products: [
      { product_id: 'prod_123', quantity: 1 }
    ],
    currency: 'USD'
  })
});

const { data } = await response.json();
console.log(data.url);
That’s it — your shop is live and accepting payments. Here’s where most people go next:

​
Next Steps

Invoices Guide

Understand invoice lifecycle, statuses, and when to use which

Webhooks

Automate fulfillment by listening for order:paid events

Developer API Quickstart

Go deeper with /dev/v1/* for custom checkout flows and backend integrations

Subscriptions

Set up recurring billing with automatic renewals