Shopify Cash on Delivery Fee Configuration Guide

Learn how to configure ACOD Cash on Delivery Fee Management to match your Shopify store's specific requirements. This guide covers all available fee settings and best practices for merchants worldwide, including those in regions where COD is popular like India.

Dashboard Configuration

ACOD Cash on Delivery settings are managed through your Shopify app dashboard. Here's a complete example with all available options:

// ACOD Cash on Delivery Configuration
{
  // Basic configuration
  storeName: 'Your Store Name',
  storeCountry: 'India',
  codEnabled: true,
  
  // Fee configuration
  fees: {
    defaultFee: {
      type: 'flat', // 'flat', 'percentage', or 'mixed'
      amount: 50, // ₹50 flat fee
      percentage: 0, // No percentage fee
    },
    minimumOrderValue: 500, // Minimum order value to allow COD
    maximumOrderValue: 25000, // Maximum order value for COD
  },

  // Location-based fees
  locationFees: [
    {
      name: 'Metro Cities',
      locations: ['Mumbai', 'Delhi', 'Bangalore', 'Chennai', 'Kolkata'],
      fee: {
        type: 'flat',
        amount: 30, // Lower fee for metro cities
      },
    },
    {
      name: 'Tier 2 Cities',
      locations: ['Pune', 'Ahmedabad', 'Jaipur', 'Hyderabad'],
      fee: {
        type: 'flat',
        amount: 50, // Standard fee
      },
    },
    {
      name: 'Remote Areas',
      locations: ['Northeast States', 'Jammu & Kashmir', 'Himachal Pradesh'],
      fee: {
        type: 'flat',
        amount: 100, // Higher fee for remote areas
      },
    },
  ],

  // Shipping method integration
  shippingMethods: {
    standard: {
      codEnabled: true,
      codFee: 50,
    },
    express: {
      codEnabled: true,
      codFee: 30,
    },
    economy: {
      codEnabled: false, // COD not available for economy shipping
    },
  },

  // Notification settings
  notifications: {
    customer: {
      showFeeBreakdown: true, // Show fee breakdown at checkout
      customMessage: 'A Cash on Delivery fee will be added to your order',
    },
  },
};

Advanced Fee Rules

Configure conditional fee rules based on various factors:

// Advanced Fee Rule Configuration
[
  {
    name: "Standard COD Fee",
    conditions: "default", // Applies when no other rules match
    fee: {
      type: "flat",
      amount: 50
    },
    active: true
  },
  {
    name: "High Value Orders",
    conditions: {
      cartValue: {
        greaterThan: 10000
      }
    },
    fee: {
      type: "percentage",
      percentage: 1 // 1% for orders over ₹10,000
    },
    active: true
  },
  {
    name: "Free COD for Premium Customers",
    conditions: {
      customerTags: ["premium", "vip"]
    },
    fee: {
      type: "flat",
      amount: 0 // No fee for premium customers
    },
    active: true
  }
]

Postal Code Configuration

Configure fees based on specific postal codes:

// Postal Code Rules
{
  postalCodeRules: [
    {
      name: "Mumbai Suburbs",
      postalCodes: ["400050", "400051", "400052", "400053"],
      fee: {
        type: "flat",
        amount: 30
      }
    },
    {
      name: "Delhi NCR",
      postalCodes: ["110001-110096", "120001-122018"],
      fee: {
        type: "flat",
        amount: 40
      }
    },
    {
      name: "Restricted Areas",
      postalCodes: ["194101-194404"], // Example: Some J&K regions
      codAvailable: false // COD not available in these areas
    }
  ]
}

Order Value Tiers

Configure different fees based on order value tiers:

// Order Value Tier Configuration
{
  orderValueTiers: [
    {
      name: "Small Orders",
      range: {
        min: 0,
        max: 1000
      },
      fee: {
        type: "flat",
        amount: 50
      }
    },
    {
      name: "Medium Orders",
      range: {
        min: 1001,
        max: 5000
      },
      fee: {
        type: "flat",
        amount: 100
      }
    },
    {
      name: "Large Orders",
      range: {
        min: 5001,
        max: 100000
      },
      fee: {
        type: "percentage",
        percentage: 1
      }
    }
  ]
}

Next Steps

After configuring your COD settings:

• Explore advanced fee conditions
• Learn about API integration for custom checkout experiences
• Check out the API endpoints for order management