How to Configure the COD Shipping Rate Matching Keyword

Shopify does not provide a native setting to add an extra surcharge solely to Cash on Delivery payments without affecting prepaid credit card checkouts. To overcome this limitation safely and natively, Rivio COD & Partial Payments connects directly to your Shopify shipping rates using an intelligent Keyword Matcher.

When a customer selects Cash on Delivery in the Rivio storefront popup, Rivio filters and locks checkout to shipping options that contain your configured keyword (such as COD, Cash, or Handling Fee).

In this guide, you will learn how to set up and customize the shipping rate matching keyword to ensure accurate fee collection on every delivery.

Before You Begin

Confirm the following before configuring your keyword:

• You have created at least one manual shipping rate in Shopify Settings → Shipping and delivery.
• The rate name includes your designated keyword (for example: *Standard Cash on Delivery Shipping* or *Express Delivery (COD)*).
• You have installed Rivio COD & Partial Payments on your store.

Step-by-Step Instructions

1. From your Shopify admin, open Apps → Rivio COD & Partial Payments.
2. Click COD Fees in the left navigation sidebar.
3. Locate the Shipping Rate Matching Strategy card.
4. In the Rate Name Keyword input field, enter the exact identifier word you used in your Shopify shipping profiles (default: cash).

1. Configure Case Sensitivity:

• By default, Rivio matches keywords case-insensitively, meaning Cash, CASH, and cash are all recognized interchangeably.

1. Choose the Keyword Search Mode:

• Contains Keyword: Matches any shipping rate that includes the word anywhere in its title (e.g., *"Standard Delivery - Cash on Delivery"* matches Cash).
• Exact Name Match: Matches only if the shipping rate title is an exact 1:1 match.

1. Click Save Changes in the top-right corner.

1. Open your storefront in an incognito window, select Cash on Delivery, and verify that only rates matching the keyword are offered during checkout.

Recommended Rate Name Configurations

Example Scenario

Eliminating Free Shipping Abuse on COD Orders

A home goods merchant offers "Free Shipping on orders over $50" for prepaid orders, but couriers charge an extra $4 cash collection fee for COD. The merchant creates two rates in Shopify:

1. Free Standard Delivery ($0.00)
2. Cash on Delivery Shipping ($4.00)

By setting the keyword in Rivio to Cash on Delivery, prepaid customers get $0 shipping, while COD customers automatically get assigned the $4 fee rate.

Important Notes & Limitations

Troubleshooting

Checkout displays "No shipping rates available for this address"

• Possible Cause: None of your shipping zones contain a rate matching the keyword.
• How to Fix:

1. Open Shopify Settings → Shipping and delivery.
2. Inspect every active zone to confirm that at least one rate contains the exact keyword configured in Rivio.

The extra fee rate is visible to credit card and prepaid customers

• Possible Cause: You have not restricted the rate using Rivio's checkout function, or the customer bypassed the popup.
• How to Fix:

1. Ensure the Require COD Shipping Rate rule is toggled Active in Rivio COD → COD Fees.

Related Guides

• How to Charge a COD Fee Using Shopify Shipping Rates
• How to Require a Dedicated COD Shipping Rate at Checkout
• Why Did the COD Fee Not Apply at Checkout?

Need Help?

Need assistance configuring keyword matching across international shipping zones?

• Email: Contact our shipping configuration experts at support@rivioapps.com
• Help Center: Browse all documentation in the Rivio COD Knowledge Base