Creating Your First Shop

What is a Shop?

A Shop in Payzo represents a payment integration for your business or application. Each shop has its own:

• Unique API credentials (API Key, API Secret, Webhook Secret)
• Customizable checkout page
• Payment history and analytics
• Webhook configuration

You can create multiple shops for different projects or applications.

Creating a Shop

Step 1: Navigate to Shops Page

1. Log in to your Dashboard
2. Click on "Shops" in the sidebar
3. Click the "Create Shop" button

Step 2: Choose Shop Type

You have two options:

Manual Integration (Recommended for most use cases)

• Full API control
• Integrate with any platform or custom application
• Supports all features (webhooks, Discord, etc.)

SellHub Integration

• Automatic integration with SellHub platform
• Requires SellHub API Key
• Simplified setup for SellHub users

Step 3: Enter Shop Details

Fill in the following information:

Shop Name: My Awesome Store
Shop Type: Manual Integration

For SellHub shops, you'll also need:

SellHub API Key: your-sellhub-api-key
SellHub Store ID: your-store-id
SellHub Store Name: Your Store Name (optional)
SellHub Subdomain: your-subdomain (optional)

Step 4: Get Your API Credentials

After creating your shop, you'll receive:

API Key

Used to authenticate API requests.

c2c_live_1234567890abcdefghijklmnopqrstuvwxyz

Important: Store this securely. You'll use this in the Authorization header.

Webhook Secret

Used to verify webhook signatures.

whsec_abcdef123456789

Important: You'll need this to verify webhook authenticity.

Shop Settings

Checkout URL Format

Your checkout URLs will follow this format:

https://payzo.cc/checkout/{shop-slug}/{payment-id}

Example: https://payzo.cc/checkout/my-awesome-store/pay_abc123

Shop Slug

Your shop slug is automatically generated from your shop name:

• "My Awesome Store" → my-awesome-store
• Must be unique across all Payzo shops

Next Steps

Now that you have your shop and API credentials:

1. Test the API - Create your first test payment
2. Configure Webhooks - Get real-time notifications
3. Customize Checkout - Brand your checkout page
4. Set Up Discord - Optional Discord notifications

Security Best Practices

🔒 Never expose your API credentials publicly:

• Don't commit them to version control
• Don't share them in public forums
• Use environment variables
• Rotate keys if compromised

# Good: Use environment variables
export PAYZO_API_KEY="your-api-key"
export PAYZO_WEBHOOK_SECRET="your-webhook-secret"

// Good: Load from environment
const apiKey = process.env.PAYZO_API_KEY;

// Bad: Hardcoded credentials
const apiKey = "c2c_live_1234567890abcdef"; // **Bad:**Never do this!