Adding & Configuring New Smart Router

How to add new Smart router engine.

Adding New Smart Router

From the Ottu Dashboard, click on the three dots in the top right corner and select Administration Panel. Proceed to the PGSR section. Click on the Add Smart Router button, and a configuration form will automatically display. The form requires the following parameters to be filled:

Smart Router Configurations Form

• Is Active:

  Determines whether the Smart Router is active.

• Name:

  Name of the Smart Router.

• Code Identifier:

  Defines the identifier for the Smart Router. This identifier replaces pg_codes in the Checkout API.

• Strategies:

  Choose one or multiple routing strategies for the transaction. Included:

  • Exclude Unavailable Strategy (Multi Selection):

    • Error Event Threshold: Count of recent error events triggering a payment method's blacklist.

    • Blacklist Expiration Mode: Duration of blacklisting, with options for specific hours or until midnight.

    • Number of Hours for Expiration: Duration in hours for which a payment method remains blacklisted if set to specific hours.

  • Transaction Size Strategy (Multi Selection):

    • Minimum Amount: Specifies the minimum transaction amount acceptable for processing through this PGMID. The amount must be greater than 0, ensuring that the payment method is utilized for transactions within its intended range.

    • Maximum Amount: Sets the maximum transaction amount that can be processed through this PGMID, preventing high-value transactions from being processed through unsuitable payment methods.

  • Round Robin (Single Selection)

    • It is a method that shares transactions equally across available Payment Gateways. It does this by moving in order, from one gateway to the next, ensuring each one gets a turn.

  • Fallback (Single Selection)

    • It is strategy where transactions are automatically sent to a backup Payment Gateway if the first option dosen't work.

What are single and multi-selection?

• Multiple Selection Strategy (Inclusive Strategy)

  It allows for the selection of multiple merchant identifiers (MIDs) within a single transaction. For instance, the "Transaction Size Strategy" might choose multiple MIDs that support a specific transaction value, such as 100 KWD. This approach broadens the pool of available MIDs for subsequent strategies in the processing pipeline.

It's not recommended to place a Multiple Selection Strategy as the last in the routing pipeline, as it may result in multiple MIDs being selected when only one is needed.

• Single Selection Strategy (Exclusive Strategy)

  It restricts the selection to just one merchant identifier (MID) per transaction. For example, the "Round Robin Strategy" selects a single MID from the available options to forward along the routing pipeline. This strategy is definitive, precisely determining the MID for further processing.

Ideally, only one Single Selection Strategy should be used positioned as the last strategy in the routing pipeline to ensure a single MID is selected for processing the payment.

• Plugin:

  Select the supported payment plugin. available options: Payment Request or E-Commerce.

• Logo:

  Upload a logo for use in various customer-facing pages.

• Router Type:

  Defines the Type of the Smart Router. For instance, when set to Apple Pay, the routing will prioritize payment gateways associated with Apple Pay.

• PGMIDs:

  Select one or multiple Merchant Identification Numbers (MIDs) from the populated list to associate with this Smart Router.