Payment Customization
Overview
Payment Customization allows you to control which payment methods appear at checkout and how they’re presented. A single Shopify Function evaluates your rules against the cart, customer, and product data, then transforms payment methods accordingly.
This is configured through the app backend (not via the Shopify Admin discount details page), giving you a dedicated management interface for payment rules.
Plan requirement: All plans (max 5 rules on Starter, 10 on Pro, 30 on Enterprise)
Use Cases
| Use Case | Description |
|---|---|
| Hide payment methods | Hide “Cash on Delivery” for orders over $500. |
| Rename payment methods | Append “(Recommended)” to preferred payment methods for VIP customers. |
| Reorder payment methods | Move “Pay Later” to the top for returning customers. |
| Set payment terms | Offer Net 30 payment terms for B2B customers tagged wholesale. |
| Require order review | Flag high-value orders for manual review before processing. |
Actions
Payment customization supports five actions that can be applied to matched payment methods:
| Action | Description |
|---|---|
| Hide | Removes the payment method from checkout. Optionally scoped to specific placements (ACCELERATED_CHECKOUT, PAYMENT_METHOD). |
| Rename | Changes the payment method name. Supports three modes: replace, append, or prepend. |
| Move | Reorders the payment method to a specific position (index) in the list. |
| Payment Terms | Sets payment terms on the order (net, fixed-date, or event-based). |
| Order Review | Requires manual order review before processing, with a configurable reason. |
Payment Terms Configuration
Payment terms allow you to offer deferred payment options to customers. Three term types are supported:
Net Terms
Due in a fixed number of days from order creation.
- Supported durations: 7, 15, 30, 45, 60, or 90 days
- Optional deposit: A percentage (1—99%) of the order total can be required upfront
Example: Net 30 with 20% deposit: the customer pays 20% at checkout and the remaining 80% within 30 days.
Fixed Terms
Due on a specific calendar date.
- Due date: Any future date
- Optional deposit: A percentage of the order total required upfront
Event-Based Terms
Due when a specific fulfillment event occurs.
- Supported triggers:
FULFILLMENT_CREATED,INVOICE_SENT,ORDER_FULFILLED - Optional deposit: A percentage of the order total required upfront
Payment Method Matching
Each rule specifies which payment methods it targets:
| Scope | Description |
|---|---|
| All | Applies to every payment method at checkout. |
| By Name | Matches payment methods by name using: exact, contains, startsWith, or endsWith matching. |
Example: Match all payment methods whose name contains “Cash on Delivery” and hide them for orders over $500.
Condition Support
Payment customization supports the same condition types used by discount functions:
Cart-Level Conditions
customerTag, customerIsAuthenticated, customerOrderCount, customerTotalSpent, cartSubtotal, cartTotalQuantity, cartLineCount, market, cartAttribute
Product-Level Conditions
productTag, productType, productVendor, lineQuantity
Conditions can be combined with AND/OR logic, just like discount rule groups.
Example Configurations
Hide Cash on Delivery for High-Value Orders
Hide the “Cash on Delivery” payment method when the cart subtotal exceeds $500:
| Setting | Value |
|---|---|
| Condition | Cart subtotal greater than $500 |
| Action | Hide |
| Target | Payment methods containing “Cash on Delivery” |
| Placement | Payment method selection only |
Offer Net 30 for Wholesale Customers
Set Net 30 payment terms with a 20% deposit for customers tagged wholesale:
| Setting | Value |
|---|---|
| Condition | Customer tag has any of wholesale |
| Action | Payment Terms (Net, 30 days, 20% deposit) |
| Target | All payment methods |
Flag Large Orders for Review
Require manual order review for orders over $2,000:
| Setting | Value |
|---|---|
| Condition | Cart subtotal greater than $2,000 |
| Action | Order Review with reason “High-value order requires manual approval” |
| Target | All payment methods |
Managing Payment Customizations
Payment customizations are managed from the app’s Payment Customizations page:
| Feature | Description |
|---|---|
| List view | See all payment customizations with their status, rule count, and toggle controls. |
| Create/Edit | Build rules with conditions, actions, and payment method matching. |
| Enable/Disable | Toggle individual customizations on or off without deleting them. |
| Delete | Remove customizations you no longer need. |
Next Steps
- Cart & Checkout Validation: block or warn buyers at checkout based on cart conditions.
- Delivery Customization: control delivery options at checkout.
- Checkout Upsells: offer pre-purchase products inside checkout (Pro+).
- Cart-Level Conditions: reference for available condition types.