Canonical URL: https://chargezen.com/docs/checkoutos/order-edits/settings

# Order Edit Settings

Configure order edit behavior and restrictions

Last updated: 2025-01-16

Fine-tune your self-serve order edit experience with these configuration options. Settings control what customers can change, when, and how.

## Edit Window Settings

### Time-Based Window

Time Window

```json
{
  "edit_window": {
    "type": "time_based",
    "duration": 60,
    "unit": "minutes",
    "start_from": "order_placed",
    "display_countdown": true
  }
}
```

### Status-Based Window

Status Window

```json
{
  "edit_window": {
    "type": "status_based",
    "allow_until": ["unfulfilled"],
    "close_on": ["in_progress", "fulfilled", "shipped"],
    "max_hours": 48
  }
}
```

### Hybrid Window

Hybrid Window

```json
{
  "edit_window": {
    "type": "hybrid",
    "time_limit": {
      "hours": 24
    },
    "status_limit": {
      "close_on": ["in_progress"]
    },
    "rule": "first_reached"
  }
}
```

## Allowed Actions

Action Permissions

```json
{
  "allowed_actions": {
    "add_items": {
      "enabled": true,
      "max_items": 5,
      "max_value": 200,
      "require_payment": true
    },
    "remove_items": {
      "enabled": true,
      "min_items_remaining": 1,
      "refund_method": "original_payment"
    },
    "change_quantity": {
      "enabled": true,
      "max_per_item": 10
    },
    "update_shipping_address": {
      "enabled": true,
      "same_country_only": false,
      "recalculate_shipping": true
    },
    "update_shipping_method": {
      "enabled": true,
      "allow_upgrades": true,
      "allow_downgrades": false
    },
    "apply_discount_code": {
      "enabled": false
    },
    "cancel_order": {
      "enabled": true,
      "full_refund": true
    }
  }
}
```

## Product Restrictions

Exclude certain products from order edits:

Product Restrictions

```json
{
  "product_restrictions": {
    "non_editable_products": {
      "by_tag": ["final-sale", "custom-made", "perishable"],
      "by_type": ["Gift Card", "Subscription"],
      "by_collection": ["clearance"],
      "by_sku_prefix": ["CUSTOM-", "LTD-"]
    },
    "restrict_action": {
      "add": false,
      "remove": true,
      "quantity_change": true
    },
    "message": "This item cannot be modified"
  }
}
```

## Order Restrictions

Order Restrictions

```json
{
  "order_restrictions": {
    "min_order_value": 0,
    "max_order_value": 1000,
    "exclude_orders_with": {
      "tags": ["wholesale", "custom"],
      "discount_codes": ["EMPLOYEE"],
      "shipping_methods": ["local_pickup"]
    },
    "exclude_payment_methods": ["cash_on_delivery"],
    "international_orders": {
      "allow_edits": true,
      "address_changes": false
    }
  }
}
```

## Payment Settings

Payment Configuration

```json
{
  "payment": {
    "additional_charges": {
      "enabled": true,
      "method": "original_payment_method",
      "fallback": "request_new_payment",
      "min_charge": 0.50
    },
    "refunds": {
      "enabled": true,
      "method": "original_payment_method",
      "timing": "immediate",
      "partial_allowed": true
    },
    "price_changes": {
      "use_original_price": true,
      "apply_original_discounts": true,
      "tax_recalculation": true
    }
  }
}
```

##### Payment Method Support

Some payment methods (PayPal, Buy Now Pay Later) may not support additional charges. Configure fallback behavior for these cases.

## UI Settings

Interface Configuration

```json
{
  "ui": {
    "theme": "match_store",
    "branding": {
      "logo": true,
      "colors": "inherit"
    },
    "edit_page": {
      "show_order_summary": true,
      "show_savings": true,
      "show_edit_history": false,
      "confirmation_step": true
    },
    "messages": {
      "success": "Your order has been updated!",
      "add_item_prompt": "Want to add anything else?",
      "window_closing": "Hurry! Edit window closes in {{time}}"
    }
  }
}
```

## Notification Settings

Notifications

```json
{
  "notifications": {
    "customer": {
      "channels": ["email"],
      "events": {
        "edit_confirmed": true,
        "edit_failed": true,
        "window_closing_soon": {
          "enabled": true,
          "minutes_before": 15
        }
      }
    },
    "merchant": {
      "channels": ["email", "slack"],
      "events": {
        "order_modified": true,
        "order_cancelled": true,
        "high_value_edit": {
          "enabled": true,
          "threshold": 100
        }
      },
      "email": "orders@yourstore.com",
      "slack_webhook": "https://hooks.slack.com/..."
    }
  }
}
```

## Fraud Prevention

Fraud Settings

```json
{
  "fraud_prevention": {
    "require_email_verification": {
      "enabled": true,
      "for_actions": ["cancel", "address_change"]
    },
    "rate_limiting": {
      "max_edits_per_order": 3,
      "cooldown_minutes": 5
    },
    "suspicious_activity": {
      "flag_multiple_address_changes": true,
      "flag_high_value_additions": true,
      "threshold": 200
    },
    "audit_logging": {
      "enabled": true,
      "log_ip_address": true,
      "log_user_agent": true
    }
  }
}
```

## Integration Settings

Integrations

```json
{
  "integrations": {
    "fulfillment_service": {
      "notify_on_edit": true,
      "cancel_pick_on_edit": true
    },
    "inventory_management": {
      "realtime_stock_check": true,
      "reserve_added_items": true
    },
    "analytics": {
      "track_edit_events": true,
      "google_analytics": true,
      "segment": false
    }
  }
}
```

## Best Practices

##### Configuration Tips

*   **Start restrictive** — Enable features gradually
*   **Protect high-value orders** — Set thresholds for review
*   **Monitor fraud signals** — Enable all logging initially
*   **Coordinate with fulfillment** — Align edit window with pick times
*   **Test edge cases** — Try partial edits, cancellations, etc.

## Related Topics

[

### Enabling Order Edits

Setup guide

Learn more



](https://chargezen.com/docs/checkoutos/order-edits/enabling)[

### Analytics Dashboard

Track edit metrics

Learn more



](https://chargezen.com/docs/checkoutos/analytics/dashboard)

Was this page helpful?

Need more help? [Contact support](https://chargezen.com/docs/checkoutos/troubleshooting/support)