Shipping Settings

Open Sky Commerce supports live shipping rate quotes from three major providers — EasyPost, Shippo, and ShipStation — as well as a flat-rate fallback for when no provider is configured or live rates are unavailable. Configuration is done entirely through the admin panel; no shipping-related environment variables are needed.

Getting to Shipping Settings

Navigate to Admin → Settings → Shipping Settings. Select your provider from the dropdown, enter credentials, and save. Credentials are encrypted using APP_ENCRYPTION_KEY before being stored in the ShippingSettings database table.

Prerequisites

For live rate quotes, your business address must be complete. Go to Admin → Business Info and fill in your street address, city, state, ZIP code, and country. This is used as the shipment origin when requesting rates from the provider.

Supported Providers

EasyPost

easypost.com — Multi-carrier shipping platform supporting USPS, UPS, FedEx, DHL, and many others in a single integration.

Required fields

• API Key — found in your EasyPost dashboard under API Keys. Use a test key for sandbox, a production key for live.

Shippo

goshippo.com — Multi-carrier platform with discounted rates for USPS, UPS, FedEx, and international carriers.

Required fields

• API Token — found in your Shippo dashboard under API. Use a test token (shippo_test_...) for sandbox.

ShipStation

shipstation.com — Shipping management platform with rate shopping across multiple carriers. Carrier access must be configured in your ShipStation account before rates will appear.

Required fields

• API Key — found in ShipStation under Account Settings → API Settings.
• API Secret — generated alongside the API key.
• Carrier Codes — comma-separated list of carrier codes to request rates from (e.g. stamps_com,fedex,ups_walleted). If left empty, rates from all connected carriers are returned, which may be slow. Find your carrier codes in ShipStation under Account → Carriers.

None (Flat Rate)

If you do not want to configure a provider, select None. Customers will see the global fallback shipping rate at checkout.

Fallback Rate Chain

Checkout determines the shipping cost using the following priority order:

1. Live API rate — queried from your configured provider using the customer's destination address and the product's weight/dimensions.
2. Product-level fallback rate — a fixed rate set on the individual product, used when a live rate is unavailable for that item.
3. Global fallback rate — set in Shipping Settings, used when neither a live rate nor a product-level fallback is available.
4. Free shipping — if no rate is found at any level, shipping is $0.

The global fallback rate is also what customers see when your provider is set to None. Set it to a reasonable flat rate for your typical order.

Testing Shipping

All three providers offer test/sandbox modes:

• EasyPost — Use a test API key (EZTKtest_...). Test keys return simulated rates.
• Shippo — Use a test token (shippo_test_...). Test tokens return simulated rates.
• ShipStation — Use sandbox API credentials from your ShipStation account. Note that sandbox rate availability depends on your carrier connections in ShipStation.

Physical vs Digital Products

Shipping rates are only requested for Physical and Subscription Physical product types. Digital products and service products do not trigger shipping rate lookups at checkout.

Related

• Product Types — Physical, Digital, and Subscription product types
• Admin Overview — Business Info and other admin settings