Marketplace

The SureStage Marketplace lets you share and discover reusable mock API templates. Browse community-contributed templates, deploy them to your Sandboxes, and publish your own templates for others to use.

What is the Marketplace?

The Marketplace is a library of pre-built API mock templates covering common use cases:

• Payment Gateways - Stripe, PayPal, Square
• Auth Providers - Auth0, Okta, Firebase
• Cloud Services - AWS S3, GCP Storage, Azure Blob
• Third-Party APIs - Twilio, SendGrid, Slack

Each template includes routes, sample data, validation rules, and documentation.

Browsing Templates

Via Web App

Navigate to Marketplace in the left sidebar to browse available templates.

URL: https://app.surestage.com/marketplace

You can:

• Search by keyword
• Filter by category (payments, auth, messaging, etc.)
• Sort by popularity, newest, or highest rated
• View template details including route count, sample responses, and publisher

Via API

curl https://api.surestage.com/v1/marketplace/templates?category=payments \
  -H "Authorization: Bearer $TOKEN"

Response 200 OK

{
  "templates": [
    {
      "id": "template_stripe_v1",
      "name": "Stripe Payment API",
      "description": "Mock Stripe payment endpoints for testing checkout flows",
      "category": "payments",
      "publisher": "SureStage",
      "version": "1.2.0",
      "routeCount": 28,
      "downloads": 1543,
      "rating": 4.8,
      "updatedAt": "2026-02-15T10:00:00Z"
    },
    {
      "id": "template_paypal_v1",
      "name": "PayPal REST API",
      "description": "Mock PayPal payment and order endpoints",
      "category": "payments",
      "publisher": "Community",
      "version": "1.0.1",
      "routeCount": 15,
      "downloads": 872,
      "rating": 4.5,
      "updatedAt": "2026-01-20T14:30:00Z"
    }
  ],
  "total": 2
}

Viewing Template Details

Via Web App

Click a template card to see full details:

URL: https://app.surestage.com/marketplace/templates/template_stripe_v1

Details include:

• Full route list
• Sample request/response pairs
• Environment variable requirements
• Setup instructions
• Publisher information

Via API

curl https://api.surestage.com/v1/marketplace/templates/template_stripe_v1 \
  -H "Authorization: Bearer $TOKEN"

Response 200 OK

{
  "id": "template_stripe_v1",
  "name": "Stripe Payment API",
  "description": "Mock Stripe payment endpoints for testing checkout flows",
  "category": "payments",
  "publisher": {
    "name": "SureStage",
    "verified": true
  },
  "version": "1.2.0",
  "routes": [
    {
      "method": "POST",
      "path": "/v1/payment_intents",
      "description": "Create a payment intent"
    },
    {
      "method": "GET",
      "path": "/v1/payment_intents/:id",
      "description": "Retrieve payment intent"
    }
  ],
  "requiredVariables": [
    {
      "key": "STRIPE_API_KEY",
      "description": "Your test Stripe API key",
      "isSecret": true
    }
  ],
  "readme": "# Stripe Payment API Template\n\nThis template provides...",
  "downloads": 1543,
  "rating": 4.8,
  "createdAt": "2025-11-10T12:00:00Z",
  "updatedAt": "2026-02-15T10:00:00Z"
}

Deploying Templates

Deploy a template to create a new Sandbox with all routes pre-configured.

Via Web App

On the template detail page, click Deploy Template. Fill in required environment variables and click Create Sandbox.

URL: https://app.surestage.com/marketplace/templates/template_stripe_v1/deploy

Via API

curl -X POST https://api.surestage.com/v1/marketplace/templates/template_stripe_v1/deploy \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Stripe Dev Sandbox",
    "variables": {
      "STRIPE_API_KEY": "sk_test_abcdef123456"
    }
  }'

Response 201 Created

{
  "sandboxId": "sandbox_new123",
  "name": "Stripe Dev Sandbox",
  "baseUrl": "https://sandbox_new123.surestage.run",
  "routeCount": 28,
  "status": "active",
  "deployedFrom": "template_stripe_v1"
}

The Sandbox is immediately active with all routes from the template.

Viewing Your Deployments

See which templates you've deployed and manage them.

Via Web App

URL: https://app.surestage.com/marketplace/my-deployments

Via API

curl https://api.surestage.com/v1/marketplace/deployments \
  -H "Authorization: Bearer $TOKEN"

Response 200 OK

{
  "deployments": [
    {
      "sandboxId": "sandbox_new123",
      "templateId": "template_stripe_v1",
      "templateName": "Stripe Payment API",
      "deployedAt": "2026-03-21T10:00:00Z"
    }
  ]
}

Publishing Templates

Share your mock configurations with the community by publishing templates.

Via Web App

1. Navigate to Marketplace > Publish
2. Select a Sandbox to convert into a template
3. Fill in template details (name, description, category)
4. Mark required environment variables
5. Write setup instructions
6. Submit for review

URL: https://app.surestage.com/marketplace/publish

Via API

curl -X POST https://api.surestage.com/v1/marketplace/templates \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Custom Auth Provider",
    "description": "Mock OAuth2 endpoints for testing auth flows",
    "category": "authentication",
    "sourceSandboxId": "sandbox_abc123",
    "version": "1.0.0",
    "requiredVariables": [
      {
        "key": "CLIENT_ID",
        "description": "OAuth client ID",
        "isSecret": false
      }
    ],
    "readme": "# Custom Auth Provider\n\nSetup instructions...",
    "visibility": "public"
  }'

Response 201 Created

{
  "id": "template_custom_auth",
  "name": "Custom Auth Provider",
  "status": "pending_review",
  "submittedAt": "2026-03-21T11:00:00Z"
}

Templates are reviewed by SureStage before appearing in the Marketplace. Review typically takes 1-2 business days.

Template Visibility

Visibility	Description
public	Available to all users
organization	Only visible to your organization
private	Only visible to you

Managing Your Listings

View and update templates you've published.

Via Web App

URL: https://app.surestage.com/marketplace/my-listings

You can:

• Update template descriptions
• Publish new versions
• View download and rating statistics
• Unpublish templates

Via API

List Your Templates

curl https://api.surestage.com/v1/marketplace/my-templates \
  -H "Authorization: Bearer $TOKEN"

Update Template

curl -X PATCH https://api.surestage.com/v1/marketplace/templates/template_custom_auth \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Updated description with more details"
  }'

Publish New Version

curl -X POST https://api.surestage.com/v1/marketplace/templates/template_custom_auth/versions \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "version": "1.1.0",
    "sourceSandboxId": "sandbox_abc123",
    "changelog": "Added rate limiting support"
  }'

Unpublish Template

curl -X DELETE https://api.surestage.com/v1/marketplace/templates/template_custom_auth \
  -H "Authorization: Bearer $TOKEN"

Template Categories

Category	Examples
payments	Stripe, PayPal, Square
authentication	OAuth2, SAML, JWT
messaging	Twilio, SendGrid, Slack
storage	S3, GCP Storage, Azure Blob
databases	MongoDB, PostgreSQL, Redis
analytics	Google Analytics, Mixpanel
ecommerce	Shopify, WooCommerce

Security

• Templates cannot include actual secrets — only placeholders
• All template operations are authenticated and scoped to your Tenant
• Published templates are reviewed for malicious content
• Deployed Sandboxes are isolated from each other

Common Issues

Problem: Cannot find a specific template

Solution: Try different search terms or browse by category. Some templates may be organization-private.

Problem: Deployment fails with missing variable

Solution: Check the template's required variables list and provide all values when deploying.

Problem: Template submission rejected

Solution: Review the rejection reason in your email notification. Common issues include incomplete documentation or unclear setup instructions.

Related

• Git Sync - Version control your templates
• Environment Variables - Configure template variables
• Routes & Responses - Understand route structure