Fraud Protection, Blocklists & Phone Verification — RUTHH COD Form & Upsells
Goal and Expected Result
Section titled “Goal and Expected Result”Configure Fraud Protection → User Blocking (/app/fraud) to automatically screen every Cash on Delivery submission against velocity abuse, duplicate orders, excessive quantities, and phone/email/IP blocklists, and understand the current architecture of Integrations → SMS & WhatsApp (/app/integrations/messaging).
Preconditions
Section titled “Preconditions”- You have access to Fraud Protection (
/app/fraud) in Shopify Admin.
Numbered Instructions
Section titled “Numbered Instructions”1. Configure Order Velocity Limits (User Blocking)
Section titled “1. Configure Order Velocity Limits (User Blocking)”- Navigate to Fraud Protection (
/app/fraud). - Enable Order Velocity Limit to restrict how many COD orders a single buyer identity (matched across IP address, normalized phone number, or email) can place within a rolling window.
- Choose the Maximum Orders count (default
3orders) and the Time Window Preset (from1h,6h,12h,24hdefault,48h,72h,7d,14d,30dup to6mo).
2. Enable Duplicate Order Detection & Quantity Caps
Section titled “2. Enable Duplicate Order Detection & Quantity Caps”- Toggle Duplicate Order Detection on and select the lookback window (default
72hours). This blocks repeated submissions containing the same buyer phone/email and identical product variant payload within the window. - Enable Maximum Product Quantity Limit and select a cap between
1and10units (1..10) to prevent abusive bulk COD orders that lock up inventory.
3. Manage Phone, Email & IP Blocklists (and Trusted IPs)
Section titled “3. Manage Phone, Email & IP Blocklists (and Trusted IPs)”- In the Blocklists & Allowlists section of
/app/fraud, enter one entry per line in the multiline text areas:- Blocked Phone Numbers: Normalized phone numbers or prefixes.
- Blocked Emails: Specific email addresses or domains.
- Blocked IP Addresses: Client IPv4 / IPv6 addresses.
- Trusted IP Addresses (Allowlist): Office, call-center, or QA IP addresses that bypass velocity and IP blocklist checks during testing or manual phone-order entry.
4. Customize Buyer-Facing Block Messages
Section titled “4. Customize Buyer-Facing Block Messages”- Customize the four category-specific rejection messages shown when a submission is blocked:
- General Block Message
- Order Velocity Limit Message
- Duplicate / Repeat Order Message
- Security / Blocklist Message
- Click Save in the SaveBar.
5. SMS OTP & WhatsApp Confirmation Workspace (/app/integrations/messaging)
Section titled “5. SMS OTP & WhatsApp Confirmation Workspace (/app/integrations/messaging)”Phone verification and messaging settings live under Integrations → SMS & WhatsApp (/app/integrations/messaging) rather than the Fraud Protection page.
Warnings and Edge Cases
Section titled “Warnings and Edge Cases”Troubleshooting Steps
Section titled “Troubleshooting Steps”- Legitimate repeat customer was blocked: Check whether the customer submitted the exact same variant twice within the 72-hour duplicate window or exceeded the 24-hour velocity limit. You can adjust the window preset in
/app/fraud. - Quantity Offer tier is blocked at submission: Ensure your Maximum Product Quantity Limit (
1..10) in/app/fraudis at least as large as your highest Quantity Offer tier.