Pricing Configuration

Overview

ShipNow uses a flexible pricing configuration system that supports:

💰 Monthly, yearly subscription, one-time payment
💵 Multiple pricing groups
🎯 Featured plans highlighting

Configuration Structure

Pricing plans are configured in the translation files (e.g., messages/en.json). Here's the complete structure:

messages/en.json

{
  "pricing": {
    "groups": [
      {
        "name": "Monthly",
        "type": "monthly"
      },
      {
        "name": "Yearly (Save 20%)",
        "type": "yearly"
      },
      {
        "name": "One-time",
        "type": "oneTime"
      }
    ],
    "plans": [
      {
        "id": "basic",
        "name": "Basic",
        "description": "Perfect for getting started",
        "featured": false,
        "features": [
          "5 credits per month",
          "Basic support",
          "48-hour response time"
        ],
        "monthlyPricing": {
          "price": 10,
          "unit": "/month"
        },
        "yearlyPricing": {
          "price": 8,
          "unit": "/month"
        }
      }
      // ... more plans
    ]
  }
}

Plan Configuration

Each plan supports the following options:

Core Properties

id: Unique identifier for the plan
name: Display name of the plan
description: Brief description of the plan
featured: Boolean to highlight this plan
features: Array of features included in the plan

Pricing Options

Plans can have one or more pricing types:

monthlyPricing: Monthly billing configuration
{ "price": 10, "unit": "/month" }
yearlyPricing: Yearly billing configuration
{ "price": 8, "unit": "/month" // Price shown per month }
oneTimePricing: One-time payment configuration
{ "price": 100 // One-time fee }

Group Configuration

Groups allow you to organize different pricing options:

{
  "name": "Monthly",  // Display name
  "type": "monthly"   // Pricing type to show
}

Supported group types:

monthly: Monthly billing
yearly: Annual billing
oneTime: One-time payments

Display Rules

Group switcher is hidden if only one group exists
Plans without pricing for the selected group are hidden
Featured plans are highlighted in the UI

Multi-language Support

When adding or updating plans:

Define the base configuration in messages/en.json
Copy and translate to other language files (e.g., messages/zh-CN.json)
Ensure all plan IDs match across languages
Update all language files when changing plan structure

Payment Links

ShipNow supports direct payment links for any pricing type. When configured, clicking the "Buy Now" button will redirect users to the link instead of creating a new checkout session.

Configuration

Add a link property to any pricing configuration:

{
  "oneTimePricing": {
    "price": 199,
    "unit": "",
    "link": "https://buy.stripe.com/test_14k6oIdPf9Km4k84gk?prefilled_promo_code=EARLYBIRD"
  }
}

Use Cases

Display a "Contact Us" button for the "Enterprise" plan, which opens an email when clicked.
Create a limited-time offer payment link for new products to test market response.

Example Configurations

Basic Subscription Plan

{
  "id": "basic",
  "name": "Basic",
  "description": "Perfect for getting started",
  "featured": false,
  "features": ["5 credits per month"],
  "monthlyPricing": {
    "price": 10,
    "unit": "/month"
  },
  "yearlyPricing": {
    "price": 8,
    "unit": "/month"
  }
}

Featured Pro Subscription Plan

{
  "id": "pro",
  "name": "Pro",
  "description": "Best for professionals",
  "featured": true,
  "features": ["50 credits per month"],
  "monthlyPricing": {
    "price": 20,
    "unit": "/month"
  },
  "yearlyPricing": {
    "price": 16,
    "unit": "/month"
  }
}

One-time Purchase Plan

{
  "id": "one-time",
  "name": "One-time",
  "description": "Perfect for one-time payments",
  "featured": false,
  "features": ["100 credits"],
  "oneTimePricing": {
    "price": 100
  }
}

Payment Link Plan

{
  "id": "early-bird",
  "name": "Early Bird Special",
  "description": "Limited time offer",
  "featured": true,
  "features": [
    "Lifetime access",
    "Priority support",
    "Early adopter benefits"
  ],
  "oneTimePricing": {
    "price": 199,
    "unit": "",
    "link": "https://buy.stripe.com/test_14k6oIdPf9Km4k84gk?prefilled_promo_code=EARLYBIRD"
  }
}

Pricing Configuration

On this page