This instance couldn't reach its API specification on the last attempt, so this page shows the copy fetched before that. Anything added or changed since then is missing here, and the reference updates itself as soon as the specification is readable again. Last fetched 2026-10-22 22:52 UTC.
A model the API reference uses in a request or a response. The operation pages link every field typed as this model here.
A merchant's conditional processor routing configuration: an ordered, first-match list of rules
that send a transaction to one of the merchant's own processor profiles.
Values
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
Fields
Field
Type
Description
enabledrequired
boolean
Whether this merchant's rule set is active. Defaults to `false`.
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
The confirmation that every processor profile these rules target belongs to the same legal
entity as the merchant.
Required: When Enabled is true.
Conditional: When Attestation is not null.
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
Fields of ProcessorRoutingAttestationDto:
Field
Type
Description
attestedByrequired
string (uuid)
The id of the user who attested. Server-populated; any value supplied on input is ignored.nullable
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
attestedAtUtcrequired
string (date-time)
When the attestation was recorded, in UTC. Server-populated; any value supplied on input is
ignored.nullable
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
noterequired
string
Optional free-text note, for example the entity or ownership evidence the attesting user
relied on.nullablemax length 1024
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
The rules, in evaluation order. The first active rule whose conditions all match wins.
Conditional: When Rules is not null.nullable
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
Fields of each ProcessorRoutingRuleDto:
Field
Type
Description
namerequired
string
Operator-facing label for this rule. Carries no matching semantics.nullablemax length 128
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
isActiverequired
boolean
Whether this rule participates in evaluation. An inactive rule is skipped entirely.
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
cardBrandsrequired
array of stringarray of
Card brands this rule matches, as canonical lowercase tokens ("visa", "mastercard", "amex",
"discover", "jcb", "diners", "unionpay", "interac"). Omit or send an empty list to match every
brand. Recognized spellings are normalized on save, so "Visa" is stored as "visa"; an
unrecognized brand is rejected.
Conditional: When CardBrands is not null.nullable
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
Card-rail tenders this rule matches. Omit or send an empty list to match every tender.
Conditional: When TenderTypes is not null.nullable
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
CreditDebit
Standard credit/debit card. The current card-rail behaviour. isDebitRouting modulates whether the request prefers debit-network routing within this rail.
EbtSnap
EBT SNAP (food benefits). Routes through the EBT SNAP processor lane and requires PIN + card-present per program rules.
EbtCash
EBT Cash (cash benefits). Distinct rail from SNAP; supports cashback where SNAP does not. PIN + card-present required.
Ewic
eWIC (Women, Infants, and Children). Distinct rail from EBT, with item-level eligibility / voucher-select flow handled in the eWIC follow-up epic.
amountMinrequired
number (double)
Inclusive lower bound on the transaction amount. Omit for no lower bound.
Conditional: When AmountMin is not null and AmountMax is not null.nullablemin 0
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
amountMaxrequired
number (double)
Inclusive upper bound on the transaction amount. Omit for no upper bound.nullablemin 0
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
Origination channels this rule matches. Accepts only VirtualTerminal, HostedPaymentPage, Api,
and RecurringBilling. Omit or send an empty list to match every channel.
Conditional: When Channels is not null.nullable
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
Unknown
The source of the transaction is unknown or not specified.
VirtualTerminal
The transaction originated from a virtual terminal interface.
Api
The transaction was initiated through an API call.
HostedPaymentPage
The transaction was processed via a hosted payment page.
RecurringBilling
The transaction is part of a recurring billing cycle.
OfflineBatch
The transaction was processed as part of an offline batch.
Invoicing
The transaction is an automatic charge against an invoice (e.g. a recurring-invoice auto-charge or a smart-retry attempt) submitted by the Invoicing module.
targetProcessorProfileIdrequired
string (uuid)
The processor profile a matching transaction is routed to. Must be one of the merchant's own
profiles, and that profile must be active.
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
fallthroughOnUnavailablerequired
boolean
What happens when this rule matches but its target profile cannot be used. The default,
`false`, is strict: decline rather than route somewhere the operator did not
choose. `true` falls through to the merchant's ordinary processor selection.
Values:Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
This body has no documented fields.
This model has no documented fields.
Reconnecting to the server
Could not reconnect
This session has ended
Attempt 1
Your work on this page is still here. Retrying keeps it; reloading starts the page again.
The server no longer holds this page's state, so it has to be loaded again.