DEV Community

AppshopX
AppshopX

Posted on

Shopify Shipping Architecture: Carrier Service API vs Delivery Customization

When implementing advanced shipping functionality in Shopify, developers often encounter two different concepts:

Carrier Service API
Delivery Customization

Although both affect shipping at checkout, they solve different problems.

Carrier Service API

The Carrier Service API is primarily concerned with providing or calculating shipping rates.

A simplified flow looks like:
Delivery Customization

Delivery Customization operates at a different stage.

Instead of calculating a new rate, it helps control the shipping methods Shopify has already collected.

Typical use cases include:

Filtering shipping methods
Renaming shipping methods
Reordering shipping methods
Controlling which options are visible at checkout

For example, Shopify might return:

Standard Shipping $8
Express $15
Economy $20
Free Shipping $0

A customization layer can control which of these options the shopper ultimately sees.

Shopify Shipping Flow

The process can be understood as four stages:

  1. Determine ↓
  2. Collect ↓
  3. Customize ↓
  4. Render
  5. Determine

Shopify evaluates the cart, destination, customer profile and applicable shipping zone.

  1. Collect

Shipping rates are collected from sources such as manual rates, Shopify carrier rates or connected carrier services.

  1. Customize

Available rates can be filtered, renamed or reordered.

  1. Render

Shopify displays the final shipping options at checkout.

Which approach should you choose?

The simplest decision rule is:

Requirement Better approach
Calculate dynamic shipping rates Carrier Service API
Connect carrier-based rates Carrier Service API
Hide shipping methods Delivery Customization
Rename shipping methods Delivery Customization
Reorder shipping methods Delivery Customization
Control checkout shipping presentation Delivery Customization
Can they work together?

Yes.

These technologies don't necessarily have to be viewed as competitors.

A carrier service can provide the shipping rates, while delivery customization can subsequently control how those rates are presented to the customer.

Final takeaway

Think of the difference this way:

Carrier Service API → Create/Calculate

Delivery Customization → Control/Customize

Understanding this distinction can help Shopify developers choose the right architecture when implementing advanced shipping requirements.

shopify #webdev #ecommerce #api #shipping #shopifydevelopment #javascript #programming

Top comments (0)