Config Matrix | Your Store

4 dimensions, fully extensible via JSON config files. No code changes needed to add products, countries, methods, or payment options.

📐 4 Configurable Dimensions:

Product Category (5 types: standard/hazmat/oversized/fragile/temperature) → determines which shipping methods are available
Country (12 countries + 2 sanctioned) → determines currency, duties, payment methods, holidays
Shipping Method (9 methods: USPS/DHL/Air/Sea/Hazmat/LTL/Pickup) → determines price tiers
Payment Method (7 types: T/T/PayPal/Stripe/WesternUnion/Alipay/WeChat/Wise) → determines fees & settlement

Matrix resolution flow:

  1. SKU → Category (auto-detect or SKU list)
  2. Category → Available methods (e.g. hazmat excludes USPS)
  3. Country + Method → Price (default or country override)
  4. Country → Available payment methods
  5. Country → Currency, duties, holidays, notes

📦 Matrix 1: Product Category × Shipping Method

Which shipping methods are available for which product type.

Available

Not available (e.g. hazmat cannot use USPS, oversized cannot use DHL Express)

Product Category	📮 USPS First Class	📮 USPS Priority	✈️ DHL Express	✈️ DHL / FedEx	🛫 Air Freight	🚢 Sea Freight	⚠️ Hazmat Specialized Courier	🚛 LTL Freight	🏪 Local Pickup (Yiwu)
📦 Standard Products Regular industrial parts, no special handling	✓	✓	✓	✓	✓	✓	✗	✗	✗
⚠️ Hazardous Materials Batteries, chemicals, magnets - requires special declaration	✗	✗	✓	✓	✓	✗	✓	✗	✗
📏 Oversized Items Large dimensions or weight, requires freight	✗	✗	✗	✗	✓	✓	✗	✓	✗
🔍 Fragile Items Glass, ceramic, precision instruments	✗	✗	✓	✓	✓	✓	✗	✗	✗
🌡️ Temperature Sensitive Adhesives, sealants, lubricants	✗	✗	✓	✓	✗	✗	✗	✗	✗

💰 Matrix 2: Country × Shipping Method (Price)

How much shipping costs for each country × method combination. default = no country-specific override.

Has country-specific rate

Uses default rate

Limited (note only)

Not available / sanctioned

Country	📮 USPS First Class	📮 USPS Priority	✈️ DHL Express	✈️ DHL / FedEx	🛫 Air Freight	🚢 Sea Freight	⚠️ Hazmat Specialized Courier	🚛 LTL Freight	🏪 Local Pickup (Yiwu)
AU	default $$5.0	default $$10.0	default $$15.0 / $25.0	default $$40.0	default $$60.0 / $100.0	default $$?	N/A	N/A	default $$0.0
BR	default $$5.0	default $$10.0	$25.0 / $45.0 / $75.0	default $$40.0	$150.0	default $$?	N/A	N/A	default $$0.0
CA	default $$5.0	default $$10.0	default $$15.0 / $25.0	default $$40.0	default $$60.0 / $100.0	default $$?	N/A	N/A	default $$0.0
CN	default $$5.0	default $$10.0	default $$15.0 / $25.0	default $$40.0	default $$60.0 / $100.0	default $$?	N/A	N/A	default $$0.0
DE	default $$5.0	default $$10.0	$14.0 / $24.0 / $38.0	default $$40.0	default $$60.0 / $100.0	default $$?	N/A	N/A	default $$0.0
GB	default $$5.0	default $$10.0	$12.0 / $22.0	default $$40.0	default $$60.0 / $100.0	default $$?	N/A	N/A	default $$0.0
IN	default $$5.0	default $$10.0	default $$15.0 / $25.0	default $$40.0	default $$60.0 / $100.0	default $$?	N/A	N/A	default $$0.0
JP	default $$5.0	default $$10.0	default $$15.0 / $25.0	default $$40.0	default $$60.0 / $100.0	default $$?	N/A	N/A	default $$0.0
MX	default $$5.0	default $$10.0	default $$15.0 / $25.0	default $$40.0	default $$60.0 / $100.0	default $$?	N/A	N/A	default $$0.0
RU	default $$5.0	default $$10.0	Limited service - prefer air freight	default $$40.0	$80.0 / $150.0	default $$?	N/A	N/A	default $$0.0
US	default $$5.0	default $$10.0	default $$15.0 / $25.0	default $$40.0	default $$60.0 / $100.0	default $$?	N/A	N/A	default $$0.0

💳 Matrix 3: Country × Payment Method

Which payment methods are accepted in which country. ORANGE = default for that country.

Available

Not available (e.g. PayPal not in Russia, Stripe not in Brazil)

Country	🏦 T/T (Wire Transfer)	🅿️ PayPal	💳 Credit Card (Stripe)	💸 Western Union	🐜 支付宝	💬 微信支付	🌐 Wise
AU stripe	✓	✓	✓	✗	✗	✗	✗
BR tt Stripe not available for BR. T/T or WU preferred.	✓	✓	✗	✓	✗	✗	✗
CA stripe	✓	✓	✓	✗	✗	✗	✗
CN alipay 国内用支付宝/微信。跨境用 T/T。	✓	✗	✗	✗	✓	✓	✗
DE stripe SEPA via Wise cost-effective for large orders.	✓	✓	✓	✗	✗	✗	✓
GB stripe	✓	✓	✓	✗	✗	✗	✓
IN tt For >$5000, T/T preferred due to Stripe limits.	✓	✓	✓	✗	✗	✗	✓
IR Cannot accept payment - sanctions.	✗	✗	✗	✗	✗	✗	✗
JP stripe	✓	✓	✓	✗	✗	✗	✗
KP Cannot accept payment - sanctions.	✗	✗	✗	✗	✗	✗	✗
MX tt Western Union for cash payment if needed.	✓	✓	✓	✓	✗	✗	✗
RU tt PayPal/Stripe NOT available. Western Union popular.	✓	✗	✗	✓	✗	✗	✗
US stripe Credit card via Stripe is most popular.	✓	✓	✓	✗	✗	✗	✓

🌍 Matrix 4: Country Meta (Currency / Duties / Holidays)

Country	Currency	Duties	Holidays
AU	AUD	GST 10% included (DDP)	Dec 25-26, Jan 1
BR	BRL	ICMS 18% included (DDP)	Dec 25, Jan 1, Feb 25
CA	CAD	GST/HST 5-15% included (DDP)	Dec 25, Jan 1
CN	CNY	国内 - 无关税	春节, 十一
DE	EUR	VAT 19% included (DDP)	Dec 25-26, Jan 1
GB	GBP	VAT 20% included (DDP)	Dec 25-26, Jan 1
IN	INR	GST 18% included (DDP)	Oct 2, Dec 25
JP	JPY	消費税 10% included (DDP)	Dec 29 - Jan 3
MX	MXN	IVA 16% included (DDP)	Dec 25, Jan 1
RU	RUB	VAT 20% included (DDP)	Jan 1-8
US	USD	DDP — no extra at delivery	Nov 28, Dec 25, Jan 1

📁 Config Files

config/
├── shipping/
│ ├── product_categories.yaml / .json   # 5 product categories
│ ├── methods.yaml / .json              # 9 shipping methods
│ ├── rates.yaml / .json                   # country × method → price
│ └── notes.yaml / .json                    # country × method → description
└── payment/
├── methods.yaml / .json              # 7 payment methods
└── by_country.yaml / .json          # country → available methods

YAML = human-editable source of truth. JSON = machine-readable runtime. Keep them in sync (or use only JSON).

✅ How to Extend (no code changes):

Add new product? → Edit product_categories.json, add SKU + category. Done.
Add new country? → Edit notes.json + by_country.json + rates.json. Done.
Add new shipping method? → Edit methods.json + rates.json. Done.
Add new payment method? → Edit payment/methods.json + by_country.json. Done.
Change a price? → Edit rates.json. Done.
Sanction a country? → Add to rates.json: "XX": {"all_methods_disabled": true, "note": "..."}. Done.

🗂️ Configuration Matrix Viewer

📦 Matrix 1: Product Category × Shipping Method

💰 Matrix 2: Country × Shipping Method (Price)

💳 Matrix 3: Country × Payment Method

🌍 Matrix 4: Country Meta (Currency / Duties / Holidays)

📁 Config Files