Pricing Configuration

This guide explains how to configure shipping pricing for each country your courier operates in. Pricing determines what customers are charged for cross-border delivery based on parcel weight, dimensions, and distance.

Prerequisites

• You are logged in as a courier owner (or a team member with pricing write permission)
• Your courier application has been approved
• At least one country is configured for your courier organization
• You can access the Config Hub from the courier home screen

Steps

Step 1: Navigate to Pricing

Open the Config Hub and select the Country Operations tab. Use the country dropdown at the top to select the country you want to configure pricing for, then tap Pricing.

Info

Each country has its own independent pricing configuration. Switching countries in the dropdown loads that country's saved pricing values.

Step 2: Choose a pricing method

Select one of the three pricing methods using the segmented button at the top of the screen:

Method	Description	Best for
Weight	Charges based on actual weight only	Dense, heavy items like car parts or machinery
Volume	Charges based on volumetric weight (L×W×H ÷ divisor)	Light, bulky items like pillows or furniture
Hybrid	Charges the greater of actual weight or volumetric weight	All product types — industry standard

Tip

Hybrid is the industry-standard method and handles all product types fairly. It ensures you are not undercharging for large, lightweight parcels or small, heavy ones.

Step 3: Choose a cross-border model

Select how shipping cost is calculated from actual weight:

Model	Description
Per-Unit Rate	Base fee plus a per-kg rate applied to chargeable weight
Banded Tiers	Flat fee charged based on the weight range the parcel falls into

Info

Banded Tiers become active when the shipping_tiers list is non-empty. If you switch to Banded Tiers, the base fee and cost-per-kg fields are hidden and replaced by the weight-band editor.

Step 4: Configure pricing fields (Per-Unit Rate model)

If you selected Per-Unit Rate, fill in the following fields:

Field	Description	Default
Base Fee (R)	Fixed charge per shipment before weight is added	0
Cost per kg (R/kg)	Rate charged for each kg of chargeable weight	0
Volumetric Divisor	L×W×H ÷ this number = volumetric weight	5000
Minimum Charge (R)	Lowest amount charged, even for small parcels	0
Per-km Cost (R/km)	Last-mile rate from depot to customer's door	0
Markup (%)	Profit margin added on top of the base + weight cost	0

Note

The Volumetric Divisor field only appears when the pricing method is set to Volume or Hybrid. The standard courier divisor is 5000; air freight typically uses 6000.

Step 5: Configure weight-band tiers (Banded Tiers model)

If you selected Banded Tiers, use the weight-band editor to define pricing ranges:

1. Each tier has a weight range (e.g., 0–10 kg) and a flat fee (e.g., R100)
2. Tap Add Breakpoint to add a new weight threshold
3. Enter the fee (in Rands) for each band
4. Remove a breakpoint by tapping the × button next to it

The following fields remain available alongside banded tiers:

• Volumetric Divisor — shown when pricing method is Volume or Hybrid
• Per-km Cost — last-mile distance charge
• Markup (%) — profit margin on top of the tier fee

Warning

Breakpoints must be unique. You cannot add a duplicate weight threshold. The first band always starts at 0 kg and cannot be removed.

Step 6: Review the estimate preview

The Estimate Preview section at the bottom of the screen shows live calculations for three sample parcels based on your current pricing values. Use this to verify your configuration produces reasonable charges before saving.

Step 7: Save pricing

Tap the Save Pricing button at the bottom of the screen. A confirmation message "Pricing saved" appears.

Tip

Tap View suggested values for a recommended starting configuration, or use Describe your pricing to enter pricing rules in plain text and have them automatically parsed into fields.

Result

After completing these steps:

• Your pricing configuration is stored for the selected country
• Customer checkout calculations use the saved pricing method, fees, and tiers for that country
• The Estimate Preview updates in real time as you adjust values
• Switching to a different country in the dropdown loads that country's independent pricing settings
• Team members with pricing read permission can view (but not edit) the configuration

Troubleshooting

Issue	Cause	Solution
Fields are disabled / cannot edit	You don't have pricing write permission	Contact your courier owner to grant write access to the pricing section.
Volumetric Divisor field not visible	Pricing method is set to "Weight"	Switch to "Volume" or "Hybrid" — the divisor is only relevant when volumetric weight is considered.
"Duplicate breakpoint" error when adding a tier	A breakpoint at that weight already exists	Choose a different weight value for your new breakpoint.
Tier validation errors on save	Breakpoint values are invalid (e.g., negative or out of order)	Review the weight-band editor and ensure all breakpoints are positive, unique, and in ascending order.
Pricing not reflected at checkout	Wrong country selected, or changes not saved	Verify you selected the correct country in the dropdown and tapped "Save Pricing" before leaving the screen.
Base Fee and Cost per kg fields missing	Banded Tiers model is selected	These fields are replaced by the weight-band editor. Switch back to Per-Unit Rate if you need flat per-kg pricing.