Skip to main content

Setting up Shipping & Delivery

Updated over a week ago

On this page:

Connect UPS account

We will need you to log in to or create your UPS Developer Account and retrieve this information. I've provided the instructions on how to retrieve these items here:

1. Click the link provided. Once on the page, click Create an Application. https://developer.ups.com/?loc=en_US


2. Login to your existing UPS account or create a UPS account.
3. Click Add Apps >


4. Describe the following & click Next:

  • I need API credentials because: I want to integrate UPS technology into my business.

  • Choose an account to associate with these credentials: Select which account you would like to connect Corksy to.

5. Fill in your Primary Contact information & click Continue.

6. Add your App Details

  • App Name: Corksy

  • Callback URL: copy & paste your website URL (Should include https:// )

7. Add Products. Add all products listed below and click Save.

  • Authorization (0Auth)

  • Address Validation

  • Locator

  • Rating

  • Time In Transit

  • Tracking

  • Shipping

8. Accept UPS terms & conditions to receive information necessary for the Corksy integration.

9. Now that UPS has provided your Client id & Client secret we will need to add this to your Corksy account.

10. Login to your Corksy account > Settings > Shipping & Delivery > Connect account (UPS) > Integration type: New

11. Enter your UPS Account Number, Client id, Client secret, & Callback URL. Click Save.


​Connect FedEx account

To connect your FedEx account to Corksy we will need your FedEx Developer account number, API Key, and Client Secret.

  1. Log in to or create your FedEx Developer Account through the link provided: https://developer.fedex.com/api/en-us/project.html#/myprojects

  2. Once you are in your FedEx Developer account, click on the My Projects tab.

  3. From the My Projects tab, click + CREATE A PROJECT.

  4. When prompted: "Tell us about your API needs" select: Ships with FedEx and is using a third-party software solution that has requested API keys

  5. Fill out the fields for "Provide information about the third-party solution you are using" :

    • Third-party company: Corksy

    • Third-party product: eCommerce

    • Third-party product website: corksy.io

  6. Select API(s) for your project

    • Ship, Rate, & other APIs

  7. Select the following APIs to enable:

    • Address Validation API

    • FedEx Locations Search API

    • Open Ship API

    • Rates and Transit Time API

    • Service Availability API

    • Ship API

    • Service Availability API

  8. API Key & Client Secret will generate. Copy and Paste Production Key into Corksy along with your account number.

  9. From your Corksy admin portal, go to Settings → Shipping & Delivery

  10. Select Connect on FedEx

  11. Copy and Paste the API Key, Client Secret, and your Account Number.

  12. Click save.

Create Shipping Zones

Manual shipping rates allow you to enter the price your customer is charged at checkout. This option is recommended to ensure the lowest number of abandoned carts due to high shipping rates. Read more about shipping best practices here.

View the step-by-step guide to setting up manual shipping rates here.

  1. From your Corksy admin portal, go to Settings → Shipping & Delivery

  2. Select Manage Rates → Create Shipping Zone

  3. Give the Shipping Zone a name

    • (we recommend adding state abbreviations in parentheses, e.g., Northeast (NY, NJ, CT), to make it easy to identify)

  4. Choose the states you want to include in this shipping zone

  5. Select Save

If you're connecting UPS or FedEx for live rates, you only need to create a single shipping zone that includes all the states you can ship to.

Create Manual Shipping Rates

  1. From your Corksy admin portal, go to SettingsShipping & Delivery

  2. Navigate to the Shipping section and select Manage Rates

  3. Click Add Rate within the desired Shipping Zone

  4. Select Set up your own rates and select the Shipping Speed

    • Express (1 to 2 business days)

    • Custom Rate (set your own)

    • Economy (5 to 8 business days)

    • Standard (3 to 4 business days)

  5. (Optional) Click Add Conditions to set parameters:

    • By Weight: Define weight ranges for the rate (e.g., 10-15 lbs = $30 for Express Shipping)

    • By Order Price: Define order value ranges for the rate (e.g., $100-$150 = $30 for Express Shipping)

  6. Select Save

📦 Setting Up Conditional Weight-Based Shipping Rates

To ensure accurate and customer-friendly shipping rates, set your conditional weight tiers based on your bottle weight. Below is an example using 3 lbs per bottle:

0-3 lbs: 1 bottle

3.1-6 lbs: 2 bottles

6.1-9 lbs: 3 bottles

9.1-12 lbs: 4 bottles

12.1-15 lbs: 5 bottles

15.1-18 lbs: 6 bottles

18.1-21 lbs: 7 bottles

21.1-24 lbs: 8 bottles

24.1-27 lbs: 9 bottles

27.1-30 lbs: 10 bottles

30.1-33 lbs: 11 bottles

33.1-36 lbs: 12 bottles (Full Case)

Recommendation: Set free shipping at the 12-bottle (36 lbs) tier to encourage full case orders.

Pro Tip: Always base these weight tiers on your actual bottle weight to ensure shipping rates are precise and aligned with your packaging.

💰 Conditional Price-Based Shipping Rates

Set up shipping tiers based on order value to encourage higher purchase amounts. Below is an example:

  • $0 - $49.99: Standard shipping rate

  • $50 - $99.99: Discounted shipping rate

  • $100 - $149.99: Reduced shipping rate (or flat rate)

  • $150 - $199.99: Free shipping on orders over $150 (recommended to drive higher cart values)

Recommendation: Offering free shipping at $150 or higher incentivizes larger purchases and increases average order value.

Create Carrier Shipping Rates

  1. From your Corksy admin portal, go to SettingsShipping & Delivery

  2. Navigate to the Shipping section and select Manage Rates

  3. Click Add Rate within the desired Shipping Zone

  4. Select Use carrier or app to calculate rates and select the Carrier

    • FedEx

    • UPS

  5. Choose the Shipping Services you want to display at checkout

    • Note: Only the selected services will appear for customers at checkout, but you can still purchase labels and fulfill orders using any shipping service.

  6. (Optional) Add a Handling Fee

  7. Click Save

We recommend a 10–15% handling fee to account for the additional weight from the shipping package when purchasing the label.

Create Shipping Packages

  1. From your Corksy admin portal, go to SettingsShipping & Delivery

  2. Navigate to the Shipping Package section and select + Shipping Package

  3. Enter your Shipping Package details:

    • Package Name (e.g., "2-Bottle Box")

    • Length

    • Width

    • Height

    • Weight

Important: This is the empty box weight, including inserts, without bottles

Did this answer your question?