New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now
Docschargebee docs
HomeBillingPaymentsRevRecGrowthReveal
Support

Product Updates


  • Release Notes

Payment Methods


  • Payment Methods Overview
  • Cards
  • Direct Debit
  • Bank Based Payments
  • Wallets
  • Vouchers
  • Articles and FAQ

Payment Gateways and Configuration


  • Payment Gateways Overview
  • Chargebee Test Gateway
  • Stripe
  • PayPal Payment Services
  • Chargebee Pay
  • Adyen
  • Authorize.net
  • Bambora (formerly Beanstream)
  • Bank of America
  • BluePay
  • BlueSnap
  • Braintree
  • Checkout.com
  • CyberSource
  • dLocal
  • EBANX
  • Ecentric
  • Elavon
  • E-xact Direct Integration
  • eWay Rapid
  • Global Payments
  • GoCardless
  • J.P. Morgan Mobility Payment Solutions
  • Metrics Global
  • Mollie
  • Moneris
  • Network Merchants Incorporated (NMI)
  • Nuvei
  • Orbital (Chase Paymentech)
  • Pay.com
  • Paymill
  • Paystack
  • Pin Payments
  • QuickBooks Payments
  • Razorpay
  • Sage Pay
  • Solidgate
  • Tempus
  • Twikey
  • Windcave
  • Worldline Online Payments(formerly Ingenico)
  • Worldpay
  • Articles and FAQ

Level 2/3 Data Support


  • Level 2/3 Data Support

Payment Optimization Engine


  • Overview
  • Defaults
  • Advanced Setup
  • Payment Method Display Rules
  • Verification Rules
  • Routing Rules

Dunning


  • Dunning
  • Articles and FAQ

Offline Checkout


  • Offline Checkout
  • Articles and FAQ

Transaction Sync & Invoice Mapping


  • Transaction Sync and Invoice Mapping

Fraud Management


  • Fraud Management

Error Handling


  • Errors with Root Cause and Troubleshooting

Payment Lifecycle Logs


  • Payment Intents
  • Transactions
  • Gateway Activity Logs
  • Gateway Webhook Logs
  • Articles and FAQ

Others


  • Reach (Merchant of Record)
  • Bulk Deletion of Payment Methods
  • Custom Payment Methods
  • Payment Initiator Parameter
  • PSD2 and Strong Customer Authentication
  • RBI e-Mandate
  • RBI Tokenization Regulations
  • Chargeback Management
  • Transaction Descriptors
  • Payment Preferences
  • Visa Trial Rules
  • Mastercard Trial Rules
  • Co-badged Card Compliance
  • Articles and FAQ
  1. Payments
  2. Payment Optimization Engine
  3. Advanced Setup
  1. Payments
  2. Payment Optimization Engine
  3. Advanced Setup

Advanced Setup

This feature is currently a Private Beta release. Contact Chargebee Support to enable Advanced Setup of the Payment Optimization Engine for your live and test sites.

Advanced Setup in the Payment Optimization Engine allows businesses to customize their payment experiences beyond the baseline configuration through rule-based settings.

This helps businesses personalize payment experiences for different customer segments, optimize payment-processing strategies, and apply business-specific controls at checkout.

While Defaults define the baseline configuration and global behavior of your payment flow, Advanced Setup enables you to control how payments are offered, evaluated, and routed based on specific conditions during the checkout acquiring process.

When to use Advanced Setup

After configuring Defaults, you can use Advanced Setup when you want to:

  • Offer differentiated payment methods to your customers based on specific business, customer, or checkout conditions.
  • Enforce business, risk, and compliance policies before processing payments.
  • Route transactions conditionally to specific gateways to optimize payment processing.

Components of Advanced Setup

Advanced Setup consists of the following configuration layers:

Payment Method display

Controls which payment methods are shown at checkout, their display order, and the conditions that govern their availability.

This helps you personalize the checkout experience and optimize conversion rates by presenting the most relevant payment methods based on customer attributes. Learn more about Payment Method Display.

Verification Rules

Evaluates payment attributes before processing and allows you to block or allow transactions based on defined business, risk, and compliance policies.

This helps reduce transaction failures, manage fraud risk, and control processing costs. Learn more about Verification Rules.

Routing Rules

Determines which payment gateway processes a transaction based on defined conditions.

This enables you to optimize approval rates, manage processing costs, and implement a multi-PSP acquiring strategy. Learn more about Routing Rules.

How Advanced Setup works

In Advanced Setup, you can create rules with multiple conditions based on the availability of the parameters at different parts of the configuration.

These rules are evaluated during the checkout process to decide:

  • Which payment methods are shown to the customer
  • Whether a payment should be allowed or declined
  • Which payment gateway should process the transaction

Before you begin

  • Ensure that Defaults are configured, as Advanced Setup builds on the baseline configuration
  • Review the available variables in each configuration layer to define appropriate conditions
  • Test your rules to ensure they behave as expected before deploying to production.

Configuring Advanced Rules

You can create rules with multiple conditions based on the availability of parameters at different points in the configuration.

Composite rules with multiple conditions

When multiple conditions are configured within a single rule, they function as an AND operator, meaning all conditions must be met for the rule to apply.

Example

If the Card Type is set to Prepaid and the Card Brand is AMEX, the rule will only be enforced if both conditions match during evaluation.

Multi-selection for filters

You can select multiple options for all supported filters. These selections function as an OR operator, meaning the rule will apply if any of the selected conditions are met.

Example

If the Billing country is set to Germany and France, the rule will trigger if the billing country is either Germany, France, or both, resulting in the configured action.

Managing Rule Priority

When multiple rules overlap, the rule with the highest priority is executed first. To change rule priority, drag and reorder rules using the hamburger icon on the left, then publish the changes.

image

Edit, Enable, Disable, or Delete rules

Click the ellipsis icon against a rule to perform these operations.

image

Was this article helpful?