Specific rules
Specific rules allow you to define personalized payment routes with multiple variables.
A specific rule behaves as follows:
- If an order meets at least one of the conditions selected by a rule, then it follows a specific flow designed exclusively for transactions that meet all the established parameters.
- In case the order does not meet any of the established conditions, then the transaction will automatically be directed according to the default processing logic.
Available conditions#
The following tables defines the available conditions for specific rules:
| Condition | Field type | Description |
|---|---|---|
| Bank | Selection | List of banks worldwide. Source is the issuer bank of the card |
| Bin | Text | Allows entering card bins separated by a comma. |
| Franchise | Selection | List of franchises. Visa, Mastercard, among others. |
| Country | Selection | List of countries in which the transaction is generated. Source is the country of the card |
| Currency | Selection | List of currencies with which the transaction is generated. Source is /purchase API |
| Card type | Selection | Type of card with which the order was transacted. [Credit card, Debit card] |
| Installment financing | Selection | MSI and MCI are taken into account. |
| Number of installments | Text | Allows entering number of installments separated by a comma. |
| Amount | Selection/Number | Select the logical operator and define the amount that the transaction must meet. |
| Metadata | Selection/Text | Allows defining specific transaction attributes. |
| Email addresses | Selection/Number | Define a name for the email list, select the logical operator and define the value that the transaction must meet. (It is possible to upload a CSV with a list of email addresses. |
| Stores | Selection/Number | Define a name for the store list, select the logical operator and define the value that the transaction must meet. (It is possible to upload a CSV with a list of stores). |
Create a specific rule#
To create a rule:
- Go to Payment Strategies
- Click Create specific rule.
Interactive exampleUses sample data and does not make API requests.
Payment strategies
Acme LATAM · ProductionSpecific rules
Define a condition and the processor path used for matching payments.
ConfigurationSpecific rules
Active01AdyenPrimary route
02WorldpayFallback route
RoutingAdyen → Worldpay
- In Enter name, enter a name for the variable and then click Go to next step.
- In Add conditions, click Add condition.
- Add the conditions:
- Bank
- Bin
- Franchise
- Country
- Currency
- Card type
- Installment financing
- Amount
- Payment source
- Payment number
- Metadata
- Click Save.
- Click Go to next step.
- In Define the transaction processing order, choose:
- Decline transaction so that all transactions with that routing are declined.
- If you choose this option, click Save to create the rejection rule.
- Create routing to designate a specific routing.
- In the modal Order how to process the transaction:
- Choose a payment processor from the list of active processors.
- You can choose anti-fraud engines, payment processors, and alternative payment methods.
- If a processor is not listed, go to Connections to add it.
- If you want to establish a cascading strategy, select the payment processors and anti-fraud engines.
- Select a second payment processor from the list of active processors for orders rejected by the first processor.
- Choose a payment processor from the list of active processors.
- In Post-authorization fraud analysis, choose an anti-fraud engine if desired.
- Click Save to create the specific rule.
Configure specific rules#
You can configure each specific rule depending on metadata or customer information.
Specific rule with metadata condition
Metadata is data that provides additional contextual information about a transaction, beyond standard details like amount, currency, or payment method.
With the Metadata condition, a strategy allows processing transactions based on specific metadata attributes associated with the transaction.
To add metadata to a specific rule:
- Choose a specific rule.
- Click Edit.
- In Add conditions, click Add condition.
- Click Metadata.
- Click Add metadata.
- Add the metadata:
- In Variable choose a name for the variable. It should not contain spaces.
- In Format type select a format type.
- Text for text operators.
- Number for numeric operators.
- In Properties select an operator.
- In Enter a value enter the metadata values.
- Click Save.
Supported metadata
| Format type | Operator |
|---|---|
| Text | (=) Equal to |
| Text | (!=) Different from |
| Text | ([]) In list |
| Number | (<) Less than |
| Number | (≤) Less than or equal to |
| Number | (>) Greater than |
| Number | (≥) Greater than or equal to |
| Number | (!=) Different from |
| Number | ([]) Between |