{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Routing & PSP Eligibility","siteUrl":"https://docs.omno.com"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"routing--psp-eligibility","__idx":0},"children":["Routing & PSP Eligibility"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["OMNO selects a PSP for each transaction using routing, constrained by eligibility rules. You can influence or pin selection with the following parameters."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"routerid-vs-directrouteid","__idx":1},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["routerId"]}," vs ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["directRouteId"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Used by"},"children":["Used by"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Effect"},"children":["Effect"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["routerId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cashier, PayIn, Payout"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Process with a specific router."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["directRouteId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/direct-link/overview"},"children":["Direct Link"]}," PayIn/Payout"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Process with a specific Direct Link route (no OMNO UI)."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Provide at most one. If neither is set, default routing applies."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"signals-that-affect-psp-selection","__idx":2},"children":["Signals that affect PSP selection"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Effect"},"children":["Effect"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kycVerified"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Whether the customer is KYC verified in your system. Some PSPs require KYC; this narrows eligible providers."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["previousTransactionCount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Number of previous transactions the customer made in your system. Used by first-time-deposit (FTD) and similar rules to select a provider."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These are sent on the create requests (cashier session, ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/direct-link/payin-apm"},"children":["pay-in"]},", ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/direct-link/payout"},"children":["pay-out"]},"). See the request schemas under ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.omno.com/apis"},"children":["APIs"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"psp-eligibility-by-customer-group-and-kyc-level","__idx":3},"children":["PSP eligibility by customer group and KYC level"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Beyond routing, OMNO ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["filters"]}," which PSPs a customer is eligible for. PSPs can be restricted to customer groups and KYC groups/levels, so a customer only sees, or is routed to, PSPs whose rules match that customer's group and KYC level. Eligibility filtering and routing rules work together."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Related fields (on the customer / cashier session request):"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Effect"},"children":["Effect"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer.customerGroups"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Groups the customer belongs to; matched against PSP group rules."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer.kyc.kycLevels"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["KYC levels for the customer; matched against PSP KYC rules."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer.kyc.allowBypass"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["[TBD: meaning of allowBypass]"]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["[TBD: how groups/levels are configured in the dashboard]"]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["[TBD: behavior when no PSP is eligible — likely NO_PROVIDER_AVAILABLE; confirm]"]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["[TBD: whether eligibility filtering applies to Direct Link and Payment Page too, or Cashier only]"]}]}]}]},"headings":[{"value":"Routing & PSP Eligibility","id":"routing--psp-eligibility","depth":1},{"value":"routerId vs directRouteId","id":"routerid-vs-directrouteid","depth":2},{"value":"Signals that affect PSP selection","id":"signals-that-affect-psp-selection","depth":2},{"value":"PSP eligibility by customer group and KYC level","id":"psp-eligibility-by-customer-group-and-kyc-level","depth":2}],"frontmatter":{"seo":{"title":"Routing & PSP Eligibility"}},"lastModified":"2026-10-12T06:54:23.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/reference/routing-and-psp-eligibility","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}