Skip to content

Security

How the routing enginedecides.

Payments follow your providers in your order until you switch on Smart routing; then Payshen sends each one to the provider most likely to approve it at a fair fee. It learns only from real outcomes, never retries a payment that may already be charged, and writes every decision down so anyone can check it.

The method

Eight things to know.

  1. 01

    What it aims for

    With Smart routing on, each payment goes to the provider that leaves you the most money: likely to approve, at a fair fee.

    Learn more about What it aims for

    Under Optimize for, you choose Lowest fees, Most approvals, Fastest or Let Payshen decide. Every choice is measured in money: among the providers that can take the payment, each is ranked by the chance it approves times what you keep after its fee. Approval comes first in money terms, so a provider that is a little cheaper never wins over one that approves clearly more. Lowest fees ranks on exactly that and prefers the cheaper provider when two are level, Most approvals counts fees at half weight, Fastest also counts how long a provider usually takes to answer, and Let Payshen decide learns which way of ranking has earned you the most and leans towards it. A fee nobody has stated is costed at the average of the known ones, not as free.

  2. 02

    Your rules always win

    Smart routing is off until you switch it on for a rule. With no rules at all, payments try your providers in the order you added them.

    Learn more about Your rules always win

    With Smart routing off, a rule sends payments exactly the way you chose: Always this provider, Try in order, or Backup only on technical errors. The engine's estimate is recorded beside the decision, never used to change it. With it on, Payshen ranks only the providers you list on the rule, or every provider when you list none, and of those only the ones that can take the payment: wrong currency, country, method or an amount outside a provider's limits rule a provider out before anything is ranked. If none of the providers you listed can take it, the payment is refused, never sent to one you left out. The share of its payments Smart routing does not decide tries your providers in the order you listed them. A payment that matches no rule uses Try in order across all your providers, oldest connection first, so routing works from the first payment.

  3. 03

    Another provider only when it is safe

    A payment moves to another provider only when the first one certainly did not take the money.

    Learn more about Another provider only when it is safe

    If a provider times out or its answer is unclear, the payment may already have been charged, so no other provider is tried: the payment is marked unknown until the provider confirms what happened. Backup only on technical errors moves on only when a provider reported a technical error before the bank answered, so nothing was executed; an ordinary decline is not retried. Try in order and Smart routing may also move on after a soft decline, up to three attempts. A hard decline, a fraud block or a compliance refusal is an answer, and is never sent to another provider. Always this provider tries nothing else. When a customer comes back within a day to pay an order a provider declined (same reference, amount and currency), that provider is tried last; a decline about the card itself changes nothing.

  4. 04

    What it learns from

    Only real outcomes of first attempts: approved or declined by the provider.

    Learn more about What it learns from

    Live routing learns from live payments only; test payments teach Test mode on their own, so you can watch it learn before you go live, and never reach live routing. It does not count declines that are about the customer (insufficient funds, an expired card, a failed authentication) against a provider. Hosted and 3-D Secure payments count once their final outcome is known, once each. Older evidence fades with time, so a provider that improved is noticed. Beside its longer record each provider has a short one, its last 50 or so results: when the two clearly disagree, as when a provider suddenly declines far more, the recent results decide until the record catches up.

  5. 05

    How sure it is

    Every estimate carries its uncertainty. No guaranteed approvals, no promised savings, no figures without their evidence.

    Learn more about How sure it is

    Each provider's approval is an estimate with a range around it, kept separately for similar payments (country, method, currency, card brand and amount). A new provider borrows from what is known of it elsewhere but cannot win by luck, and new providers take turns on a small trial share, so a good one is found even after an unlucky start. Estimates are shown with how many payments they rest on. A suggestion shows money only when the low end of its 95% range is above zero, and rounds it down; otherwise it says "worth testing". Savings are reported only after they are measured, next to what was predicted, including when the result fell short.

  6. 06

    Previewed, published, tested

    A change is previewed on your own payments, published as a new version, and can be tried on a small share first.

    Learn more about Previewed, published, tested

    Rule changes go into a draft that routes nothing. You can replay it over your last 30 days of real payments (nothing is charged, written or learned) and check where a single payment would go, then publish it as a new version; every earlier version stays a rollback away. Test another route sends a share of one rule's payments, 5% to 50%, another way. A test starts only when you confirm it, and one on live payments asks you to confirm that it routes real customers' payments. The result is read with a test that stays valid however often it is looked at, and nothing is decided before each side has 100 payments with an answer. Payshen makes the test route the rule on its own only when it clearly earns more per payment, in a new published version (you can also make it the rule yourself); a safety limit stops the test as soon as it approves clearly fewer. Every automatic decision is recorded with the evidence behind it.

  7. 07

    Every decision can be checked

    Each routing decision is written down with what it used, and can be replayed to the byte.

    Learn more about Every decision can be checked

    A decision records its inputs, a seed for every random draw, its outputs and hashes, and the engine version. The record cannot be edited afterwards. Every night a sample is recomputed and must match exactly; inspectors can export the records and do the same.

  8. 08

    Rules and regulation

    It routes payments between businesses and makes no decisions about people.

    Learn more about Rules and regulation

    The engine chooses among payment providers for a merchant's payments. It does not decide whether a person may pay, and Payshen never holds or moves the money. On that basis we assess it as outside the high-risk uses of the EU AI Act and outside automated decisions about individuals under GDPR Article 22. That assessment is with our counsel; this page will say so when it is confirmed.