[
{
"title":"Testing",
"link":"https://docs.solidgate.com/payments/testing/",
"text":"Simulate payments to test your integration before launching in production.",
"imgSrc":"https://solidgate.com/wp-content/uploads/2022/06/icon-customizable.svg"
}
,
{
"title":"Create your payment form",
"link":"https://docs.solidgate.com/payments/integrate/payment-form/create-your-payment-form/",
"text":"Understand how to integrate the payment form into your product.",
"imgSrc":"https://solidgate.com/wp-content/uploads/2022/06/icon-payments.svg"
}
,
{
"title":"Billing",
"link":"https://docs.solidgate.com/billing/",
"text":"Smart billing solutions designed for diverse business models.",
"imgSrc":"https://solidgate.com/wp-content/uploads/2022/06/icon-global.svg"
}
]
Optimize transaction routing, success rates, and risk metrics while reducing costs
Routing configurations enable the management of payment flows, ensure compliance, and optimize processing performance, all while maintaining flexibility and control over their payment infrastructure.
With a no-code, customizable platform, you can scale quickly to new geographies, improve payment conversion rates, and diversify risk.
Routing flow
Routing configuration is set up for a channel with payment method level, allowing operators to manage and optimize payment traffic across multiple payment methods, such as Cards and Digital wallets, Apple Pay and Google Pay.
Each channel corresponds to a product, website, or store. To process payments at the same time, one account can have several channels.
Routing components
Routing configurations consist of a rule preset, rules with conditions, splits, and segments, each essential for directing and optimizing payment traffic.
Preset sets initial conditions, like blocking payments or enforcing
Guide
3D Secure (3DS) enhances online payment security by adding an extra authentication step for credit and debit card transactions.
3DS.
Rules define how payments are routed based on parameters and logic operators.
Splits distribute payment traffic across connector accounts.
Segments configure the processing sequence for payments, including fallbacks.
Preset
Rule presets are evaluated before routing rules are applied, ensuring that specific criteria are met before proceeding with the transaction.
Presets are evaluated from top to bottom, with the first matching condition taking precedence over subsequent ones. Each configuration type has its own rule presets. Key condition:
Block payments Blocks certain payments.
If triggered, the transaction is declined with a Payment processing unavailable message and the decline code 0.04.
Force 3DS Determines whether payment processing rules fall under Force3DS. This preset applies to all payments that antifraud system has identified as Force 3DS, or provided
force3ds
true
through the
Solidgate
API
Reference.
SCA regulation A European rule to reduce fraud in online and contactless payments.
Low-value SCA exemption Allows low-value transactions to skip SCA under PSD2.
TRA SCA exemption transaction handling Permits low-risk transactions to bypass SCA, reducing friction.
Non-3DS for MIT/MOTO 3DS can often be bypassed or handled differently than standard online payments.
Other PAN only Specifies that only payments involving other PANs are allowed.
All other payments Applies to all payments not otherwise categorized by the specific routing presets.
For Digital wallets payment method Force 3DS with the Other PAN only are included to the Google Pay PAN only preset, ensuring that transactions are routed and processed only for Google Pay PANs with 3DS enforcement.
For every rule preset, except Block payments, there is a Default branch that must be filled out. Rules cannot be filled in the Default branch, as that is its default purpose. Everything else is at your discretion.
Rules
Routing rules are the core logic that defines how payments are routed through different payment processors (PSPs). These rules consist of parameters and values that can be combined using logical operators.
Rules condition:
Can be as simple or complex as necessary, with condition nesting supported up to 3 levels.
Work top-down by priority, meaning that if a payment matches the first rule, it follows that path, and further rules are not checked.
Similarly, conditions within a rule operate in the same way.
Expand all
Amount represents the total amount of the order.
Bank refers to the name of the bank associated with the transaction.
BIN defines a list of BINs used for routing based on specific patterns.
BIN country defines the country associated with the BIN.
Card brand used for the transaction, such as Visa, Mastercard, or other supported brands.
Card type specifies the type of card being used.
Currency specifies the
Guide
Understand which currencies you can use for making payments.
currency
of the order.
Customer account ID specifies a unique identifier assigned to the customer's account for tracking.
Customer email specifies the email address associated with the customer for communication and transaction purposes.
Data origin specifies the origin of the data used in the transaction.
External MPI allows for the configuration of conditions based on the presence of external
Guide
Boost payment security with 3D Secure support.
MPI
data.
Force 3DS specifies whether 3D Secure authentication is forced during the transaction.
Fraud risk detected specifies whether a fraud risk has been detected in the transaction.
Initiator origin specifies the origin of the transaction initiator.
IP address specifies the IP address of the device used to initiate the transaction.
Payment method type defines the type of payment method being used.
Traffic source helps identify where the traffic is coming from.
Website specifies the website where the transaction is originating from.
For the metadata rule, you can enter any metadata parameter that corresponds to its respective data type and value.
Equal must exactly match the specified value.
Card brand = Visa
Greater than must be greater than the specified value.
Amount > 100
Greater than or equal must be greater than or equal to the specified value.
Amount ≥ 100
Less than must be less than the specified value.
Amount < 100
Less than or equal must be less than or equal to the specified value.
Amount ≤ 100
Not equal must not match the specified value.
BIN country ≠ US
Not one of must not match any value from a provided list.
Card type not in [Credit, Debit]
One of must match any value from a provided list.
Website = one of [site1.com, site2.com]
Depending on the type of parameter, the available logic operators may vary.
Splits
Splits define how payment traffic is distributed across different Connector accounts.
Each split is assigned a percentage of traffic, and each group block of rules requires a separate split.
Sum of all segments in a group must equal 100%.
Maximum of 20 groups can be defined for a single rule.
Segments
Configuring a segment involves setting up the sequence of steps for a split group.
The list of available options depends on the Connector itself, making it flexible and adaptable to the specific configuration of the Connector account. Additionally, display whether the Connector account supports the acceptance of External MPI Data.
A maximum of 5 steps can be defined in a group.
They can be the same, but the features and descriptors must differ.
Fallbacks are not available on the Force 3DS branch.
For each segment, it’s essential to ensure that the features/descriptors vary, even if the same Connector account is used multiple times.
Steps allow fallback routing, directing traffic to MIDs when the initial route fails. Each step level is evaluated in sequence, providing up to 5 levels of fallback routing. Use steps for retry strategies after declines or failures to ensure continuous payment processing.
Create routing
Routing configurations manage payment traffic based on merchant routing rules. A version refers to the state of a routing configuration, with
Draft
indicating it is under development or testing, while
Live
means it has been published and is actively in use.
Managing versions is crucial for ensuring smooth updates, preventing disruptions, and maintaining control over the routing setup as configurations evolve through different stages. Key routing status for:
Configuration
Inactive
a configuration that is not currently in use.
Active
a configuration that has been published and is active.
Version
Draft
a configuration under development or testing.
Live
a configuration that has been published and is active.
When creating routing configurations, operators can view, edit, and manage them for each channel and payment method.
Configurations are versioned, and each version can either be
Draft
or
Live
. When initially created, the configuration is set to
Inactive
.
Once tested and ready, the configuration change status can be changed to
Active
, and it can be published to production, with the configuration version changed to
Live
.
To create the route configuration
Go to Orchestration > Routing configuration.
Click on Create routing configuration.
Choose
Payment method
Channel
Fill
Title
Description
Click on Create.
Preset
To set the preset
Go to Orchestration > Routing configuration.
Find the needed ID routing configuration and click on it.
Click on Force 3DS preset and enable the needed preset conditions.
Click on ×.
No configuration exists for other presets.
Rules
To set the rules
Go to Orchestration > Routing configuration.
Find the needed ID routing configuration and click on it.
Find the needed preset and click on +.
Click on New condition.
Add Rule, Metadata rule or Rule group.
Click on Save.
To set the rule
Click on Add rule and set:
Parameter
Logic operators
Value
Click on Save.
To set the metadata rule
Click on Add metadata rule and set:
Data type
Parameter name
Logic operators
Value
Click on Save.
To set the rule group
Click on Add rule group:
Choose Rule or Metadata rule, or Rule group and set it.
Set logic operators.
Click on Save.
Splits
To set the splits
Go to Orchestration > Routing configuration.
Find the needed ID routing configuration and click on it.
Find the needed rule and click on + Add splits.
Set % percentage for each group.
Segments
To configure the segments
Go to Orchestration > Routing configuration.
Find the needed ID routing configuration and click on it.
Find the needed split group and click on Configure segment.