API Reference

Provider Sequence Management

The Provider Sequence Management feature allows you to define the order in which Paystrator routes transactions across multiple connected providers. This ensures high reliability, failover handling, and flexible routing per product or destination (e.g., bank, eWallet, or virtual account).


How It Works

Each Paystrator product (e.g., Send Money, Receive Money – Virtual Account, eWallet, QR Code) can have its own routing sequence. When a transaction is initiated:

  1. Paystrator attempts the first provider in the list.
  2. If it fails (e.g., provider timeout, maintenance, or rejection), the system automatically tries the next provider.
  3. The sequence continues until the transaction succeeds or all providers are exhausted.

You can configure these sequences** per destination** (e.g., specific VA Bank or eWallet), giving you fine-grained control over routing.


Viewing Provider Sequence

To access this page:

DashboardProvidersSequence Management

You’ll see tabs for each product:

  • Send Money
  • Receive Money
    • QR Code
    • Virtual Account
    • eWallet

For each tab, Paystrator shows a list of configured sequences.

Fields Displayed

FieldDescription
DestinationBank, VA Bank, eWallet, or QR Code type
Provider SequenceOrdered list of active providers
Last Updated OnTimestamp of the last modification
Updated ByUser who last changed the configuration

Default Sequence

When you add providers, Paystrator automatically creates a Default Sequence for each product. Here are some rules you might want to know about sequences in Paystrator.

  • New providers are auto-appended to the end of the default sequence.
  • Default sequences apply to all destinations unless a Custom Sequence is defined.
  • Providers in Maintenance mode still appear but are skipped during routing.
  • For QR Code, the default sequence always uses QRIS as the only option.

Adding a Custom Sequence

You can define custom sequences for specific destinations such as a particular VA Bank or eWallet.

  1. Click Add Custom Sequence.
  2. Choose your destination (e.g., BNI, DANA, OVO).
  3. Drag and drop providers into your preferred order.
  4. Toggle providers on/off to include or exclude them.
  5. Click Save when finished.

Custom Sequence Example

DestinationSequence
Default (VA)Provider 1 → Provider 2 → Bank A → Bank B → Provider 3
Custom (BCA Open VA)Bank A → Provider 2 → Provider 3

Explanation:

When a transaction targets BCA VA, Paystrator will use the custom sequence; otherwise, the default sequence applies.

Rotating Sequence (Advanced)

Rotating sequences allow you to load balance traffic across multiple custom configurations.

Rotating Sequence Example

Below is a rotating sequence example, let's say for sending money to a bank.

SequenceSequence
Seq 1Provider 1 → Provider 2 → Bank A
Seq 2Provider 2 → Provider 1 → Bank A

Explanation:

Routing alternates between them per transaction: Seq 1 → Seq 2 → Seq 1 → Seq 2

You can also assign weights to favor one sequence more often (e.g., Seq 1 used twice as often as Seq 2 by adding Seq 3 that contain the same sequence as Seq 1).

⚙️

Maximum 10 custom sequences per destination are supported.


Notes & Best Practices

  • Always verify that each provider in your sequence is active and properly credentialed.
  • Use custom sequences for critical destinations (e.g., top VA banks) to ensure redundancy.
  • Review logs regularly to confirm updates or detect configuration drift.
  • Sandbox and Production sequences are managed separately, updates in one do not affect the other.