@agent-cards/sdk 0.23.21 → 0.23.23

package/dist/client.js

@@ -1,12 +1,10 @@
 import { BUILTIN_REGISTRY, cardUrlPatterns as deriveCardUrlPatterns, LOOPBACK_URL_PATTERNS, findRecognizer, isRecognizerRequest, recognizerRequestMethod, recognizerRequiresPreparation, urlsOnProcessorHosts, } from './registry.js';
 import { armServedProfiles, classifyProfileRequest, declareSandboxMerchant, merchantProfileEnvironment, merchantProfileFor, merchantProfileUrlPatterns, } from './merchant-hosted.js';
 import { merchantAmountExchanges, merchantAmountFromResponses, merchantProfilePricedBySource, merchantTotalWire, MerchantTotalWait, } from './merchant-total.js';
-import { ACI_CAPABILITY, ACI_PSP, aciCardLegAnswer } from './aci.js';
-import { PRZELEWY24_CAPABILITY, PRZELEWY24_PSP } from './przelewy24.js';
-import { EPROTECT_CAPABILITY, EPROTECT_PSP, eprotectCheckoutRefusal, eprotectScriptAnswer, isEprotectRegistration } from './eprotect.js';
-import { COMGATE_CAPABILITY, COMGATE_PSP } from './comgate.js';
+import { ACI_PSP, aciCardLegAnswer } from './aci.js';
+import { EPROTECT_PSP, eprotectCheckoutRefusal, eprotectScriptAnswer, isEprotectRegistration } from './eprotect.js';
 import { isHostedGetEntry } from './hosted-entry.js';
-import { TRANSBANK_CAPABILITY, TRANSBANK_PSP } from './transbank.js';
+import { SBPS_PSP, isSbpsTokenGet, sbpsScriptAnswer } from './sbps.js';
 import { isMercadoTokenRequest, parseMercadoCheckoutContext, validateMercadoProcessorContext } from './mercado-checkout.generated.js';
 import { matchesPreparation, preparationMode, validPreparationEnvironment } from './prepared-processor.js';
 import { fiservKeyPinById, isFiservSubstitution, requiresFiservPreparation } from './fiserv.js';
@@ -15,34 +13,36 @@ import { hasOwnedShopMarker, parseOwnedShopOrder, parseOwnedShopReceipt } from '
 import { requestWithoutCard } from './card-fields.generated.js';
 import { merchantSessionCapture } from './merchant-session-probe.js';
 import { creditguardPageProcessUrl, creditguardPpDomainHost, creditguardPreparationEnvironment, creditguardProcessTxId, sanitizeCreditguardResponse, } from './creditguard.generated.js';
-import { CONVERGE_CAPABILITY } from './elavon-converge.js';
-import { SHIJI_STS_CAPABILITY, SHIJI_STS_PSP, isShijiStsServedCompanion, isShijiStsServedSubstitution } from './shiji-sts.js';
-import { AMADEUS_CHECKOUT_CAPABILITY, AMADEUS_CHECKOUT_PSP } from './amadeus-checkout.generated.js';
-import { PADDLE_VGS_CAPABILITY, PADDLE_VGS_PSP, paddleVgsCardFactsOf } from './paddle-vgs.generated.js';
-import { PADDLE_TOKENEX_CAPABILITY, PADDLE_TOKENEX_PSP, isPaddleTokenexServedFacts, isPaddleTokenexServedSubstitution } from './paddle-tokenex.js';
-import { TWOC2P_CAPABILITY, TWOC2P_PSP } from './twoc2p.js';
-import { WIX_PAYMENTS_CAPABILITY, WIX_PAYMENTS_PSP } from './wix-payments.generated.js';
-import { HIPAY_CAPABILITY, HIPAY_PSP } from './hipay.generated.js';
+import { SHIJI_STS_PSP, isShijiStsServedCompanion, isShijiStsServedSubstitution } from './shiji-sts.js';
+import { AMADEUS_CHECKOUT_PSP } from './amadeus-checkout.generated.js';
+import { PADDLE_VGS_PSP, paddleVgsCardFactsOf } from './paddle-vgs.generated.js';
+import { PAYGENT_PSP, paygentAnswerOutcome } from './paygent.generated.js';
+import { PADDLE_TOKENEX_PSP, isPaddleTokenexServedFacts, isPaddleTokenexServedSubstitution } from './paddle-tokenex.js';
+import { WIX_PAYMENTS_PSP } from './wix-payments.generated.js';
+import { HIPAY_PSP } from './hipay.generated.js';
+import { TOAST_PSP, isToastCiphertext } from './toast.generated.js';
 import { classifyStripeCheckoutRequest, encodeStripeCheckoutContext, hasStripeCheckoutMarker, parseStripeCheckoutContext, parseStripeCheckoutResponse, STRIPE_CHECKOUT_CONTEXT_HEADER, } from './stripe-checkout.generated.js';
 import { VoiceModule } from './voice.js';
 import { BuyModule } from './buy.js';
 import { Languages } from './languages.js';
 import { RequestRegistry } from './requests.js';
 import { AgentcardError } from './voice-types.js';
-import { GMO_CAPABILITY, GMO_PSP, gmoTokenAnswer } from './gmo.js';
+import { HYPHEN, SLASH, maskUuids } from './url-mask-parts.js';
+import { URL_MASKS } from './url-masks.generated.js';
+import { DECLARED_CAPABILITIES } from './capabilities.generated.js';
+import { AGENT_AMOUNT } from './agent-amount.generated.js';
+import { GMO_PSP, gmoTokenAnswer } from './gmo.js';
 import { admitCybersourceFlexPreparation, isCybersourceFlexTokenShape, sameCybersourceFlexPreparation } from './cybersource-flex.generated.js';
-import { CYBERSOURCE_FLEX_CAPABILITY, CYBERSOURCE_FLEX_PSP, validCybersourceFlexSidecar, } from './cybersource-flex.js';
-import { JUSPAY_CAPABILITY, JUSPAY_PSP, juspayPageAnswer } from './juspay-gate.js';
+import { CYBERSOURCE_FLEX_PSP, validCybersourceFlexSidecar, } from './cybersource-flex.js';
+import { JUSPAY_PSP, juspayPageAnswer } from './juspay-gate.js';
 import { CARD_ENDPOINT_MODE, CARD_ENDPOINT_PSP, CardEndpointRefusedError, cardEndpointById, cardEndpointLive, cardEndpointSessionRefusal, } from './card-endpoint.js';
 import { merchantCardEndpointFactsRefusal as sharedFactsRefusal, readMerchantCardEndpointFacts as sharedReadFacts, } from './merchant-card-endpoints.generated.js';
-import { DATATRANS_CAPABILITY } from './datatrans.js';
-import { TOKENEX_IFRAME_CAPABILITY, TOKENEX_IFRAME_PSP, tokenexIframePageAnswer, tokenexIframePlaceholderFits } from './tokenex-iframe.js';
-import { PELECARD_CAPABILITY, PELECARD_PSP } from './pelecard.js';
-import { PRIMER_CAPABILITY, PRIMER_PSP, primerTokenAnswer } from './primer.js';
-import { PAYRAILS_CAPABILITY, isPayrailsPaymentUrl, payrailsAnswer } from './payrails.js';
-import { WSPAY_CAPABILITY, WSPAY_PSP } from './wspay.js';
+import { TOKENEX_IFRAME_PSP, tokenexIframePageAnswer, tokenexIframePlaceholderFits } from './tokenex-iframe.js';
+import { PRIMER_PSP, primerTokenAnswer } from './primer.js';
+import { isPayrailsPaymentUrl, payrailsAnswer } from './payrails.js';
 import { EbanxFollowUpError } from './ebanx.js';
-import { SECURE_ACCEPTANCE_CAPABILITY, SECURE_ACCEPTANCE_FAST_POLL_MS, SECURE_ACCEPTANCE_PSP, SECURE_ACCEPTANCE_REPLY_WINDOW_MS, secureAcceptanceCheckoutProfile, secureAcceptanceCheckoutRefusal, secureAcceptanceFrameAnswer, } from './cybersource-secure-acceptance.js';
+import { PAYREXX_PSP, PayrexxFollowUpError } from './payrexx.js';
+import { SECURE_ACCEPTANCE_FAST_POLL_MS, SECURE_ACCEPTANCE_PSP, SECURE_ACCEPTANCE_REPLY_WINDOW_MS, secureAcceptanceCheckoutProfile, secureAcceptanceCheckoutRefusal, secureAcceptanceFrameAnswer, } from './cybersource-secure-acceptance.js';
 /**
  * The modes this SDK can finish. Asked for on syncRegistry (the API serves
  * only recognizers in these modes, so a request this build cannot complete
@@ -202,6 +202,12 @@ export const SUPPORTED_REGISTRY_FEATURES = ['card_fields', 'checkout_sessions'];
  * never lets the agent's browser post to (pre-claim.ts, redsys.ts). Served on the same terms as NMI's: only
  * to a build that lists it, for a company Agentcard turned Redsys on for.
  *
+ * `paytrail_hosted_payment_page`: Paytrail's card method, whose card-free signed Visa and Mastercard
+ * entry this build pauses for the cardholder's device, and whose loading page post, card page posts and
+ * card-number lookup on Payment Highway's host this build never lets the agent's browser send
+ * (pre-claim.ts, paytrail.ts). Served on the same terms as NMI's and Redsys's: only to a build that lists
+ * it, for a company Agentcard turned Paytrail on for.
+ *
  * `paddle_vgs_cards`: the card request Paddle's checkout frame sends to its VGS card
  * vault (vault.paddle.com/cards) on a checkout that names VGS, only through a prepared
  * checkout: the frame aborts the request 10 seconds after Pay and sends it once more,
@@ -265,6 +271,22 @@ export const SUPPORTED_REGISTRY_FEATURES = ['card_fields', 'checkout_sessions'];
  * company until a reviewed change binds GoPay's payee and amount to the approval: the post names
  * neither. The API takes it only at a shop Agentcard reviewed.
  *
+ * `paygent_token`: the token request Paygent's own PaygentToken.js sends from a merchant's
+ * page (token.paygent.co.jp/n/token/request), only through a prepared checkout: the script
+ * abandons the request 35 seconds after the press that sends it, so the cardholder approves
+ * before the press. The cardholder's device sends the card itself and the page gets back
+ * Paygent's single-use token alone; the SDK refuses a second token request on the same approval.
+ * Served on the same terms: only to a build that lists it, for a company Agentcard turned
+ * Paygent on for.
+ *
+ * `payrexx_card_frame`: the card request Payrexx Pay's card frame sends to its own URL
+ * (checkout.payrexx.com/?pspId=44&lang=<xx>) on a Payrexx merchant's page. This build pauses only
+ * the frame's own one-time card request and answers it with Payrexx's answer as the API recorded
+ * it: the token the merchant's page then charges, or the start of 3-D Secure, whose two later sends
+ * of the card this build hands to the cardholder's device under the same approval (payrexx.ts,
+ * pre-claim.ts payrexxPreClaim). The cardholder's device sends the card through the checkout relay.
+ * Served only to a build that lists it, for a company Agentcard turned Payrexx on for.
+ *
  * `hipay_vault_token`: the token create HiPay's hosted fields send to HiPay's Secure Vault
  * (secure2-vault.hipay-tpp.com, stage-secure2-vault for a test row), only through a prepared
  * checkout: the merchant's page gives the frame 20 seconds after Pay. The cardholder's device
@@ -302,8 +324,8 @@ export const SUPPORTED_REGISTRY_FEATURES = ['card_fields', 'checkout_sessions'];
  * This build pauses only the form's own multipart body at that exact URL; the cardholder's
  * device sends the card through the checkout relay, and the frame gets the token answer
  * payment-core's judge rebuilt, with the CORS answer for the frame's own origin, null. The
- * request names no amount, so the agent's pair, above zero, is the one the cardholder approves
- * (PAY_NL_PSP below). Served on the same terms: only to a build that lists it, for a company
+ * request names no amount, so the agent's pair, above zero, is the one the cardholder approves.
+ * Served on the same terms: only to a build that lists it, for a company
  * Agentcard turned Pay. on for.
  *
  * `paypal_card_fields`: PayPal Card Fields' confirm, the POST its v5 frame sends to
@@ -364,11 +386,76 @@ export const SUPPORTED_REGISTRY_FEATURES = ['card_fields', 'checkout_sessions'];
  * device sends the card itself, and the API holds the payment to a merchant Agentcard reviewed, at the
  * amount SumUp holds for the checkout. Served on the same terms: only to a build that lists it, for a
  * company Agentcard turned SumUp on for.
+ *
+ * `clover_card_token`: the card token request Clover's card frame (the hidden frame of
+ * checkout.clover.com that Clover's iframe mounts on a merchant's page) sends to
+ * token.clover.com/v1/tokens (token-sandbox.dev.clover.com for a test row), with the number
+ * encrypted under Clover's key. This build pauses only the frame's own body at that exact URL; the
+ * cardholder's device builds the request again with the real card under the key payment-core pins
+ * and sends it to Clover itself, and the frame gets the token answer payment-core's judge rebuilt.
+ * The request names no amount, so the agent's pair, above zero, is the one the cardholder approves.
+ * Served on the same terms: only to a build that lists it, for a company
+ * Agentcard turned Clover on for.
+ *
+ * `eximbay_hosted_payment_page`: Eximbay's payment window, whose card-free signed entry
+ * (a form post to /Gateway/BasicProcessor.krp on secureapi.eximbay.com, or its test host) this
+ * build pauses for the cardholder's device, in the page or in a window it opened once attachToCdp
+ * has armed that window (eximbay.ts names the entry that can leave first), and whose
+ * step, amount query, card lookup and card post this build never lets the agent's browser send
+ * (pre-claim.ts, eximbay.ts). Served on the same terms as NMI's and Redsys's: only to a build
+ * that lists it, for a company Agentcard turned Eximbay on for.
+ *
+ * `toast_pinned_key`: the card request Toast's payments frame sends to
+ * payments.toasttab.com/v1/payment-methods on a Toast online-ordering checkout, with
+ * the card sealed in card.cardData under one key every Toast restaurant shares. The
+ * cardholder's device seals the real card under that key, which payment-core pins, and
+ * this build writes it over the agent's placeholder and nothing else before it
+ * continues the request. Served on the same terms: only to a build that lists it, for
+ * a company Agentcard turned Toast on for.
+ *
+ * `xendit_card_token`: the card token request Xendit's hosted invoice checkout
+ * (checkout.xendit.co/web/<invoice id>, where Xendit's payment and donation links land) sends
+ * when the payer presses Pay Now: Xendit.js posts the card as JSON to
+ * https://api.xendit.co/v2/credit_card_tokens from the page itself, under the business's
+ * publishable key. This build pauses only the card form's single-use token body at that exact URL
+ * (payment-core xendit.js); a token that keeps the card on file, Xendit.js's code-only storeCVN post
+ * and any other body there fail in the browser before anything is created. The cardholder's device
+ * sends the request itself with the real card, and the page gets the token answer payment-core's
+ * judge rebuilt, after which the page runs 3-D Secure and charges the token without the card. The
+ * token names the invoice's amount and currency, so no agent pair is needed: the API reads the
+ * token's and holds an agent's pair to it. Served on the same terms: only to a build that lists it,
+ * for a company Agentcard turned Xendit on for.
+ *
+ * `omise_card_token`: the card token request every Omise card form sends, Omise.js's pay.html frame
+ * or a merchant's own page calling Omise.js or Omise's Node library: a JSON POST to
+ * https://vault.omise.co/tokens under the merchant's public key. This build pauses only the card
+ * form's token body at that exact URL (payment-core omise.js); a wallet's tokenization and any other
+ * body there fail in the browser before anything is created. The cardholder's device sends the
+ * request itself with the real card, and the page gets the token answer payment-core's judge
+ * rebuilt. The request names no amount, so the agent's pair, above zero, is the one the cardholder
+ * approves, and the API pays only a merchant payment-core pins for the checkout
+ * page the create names. Served on the same terms: only to a build that lists it, for a company
+ * Agentcard turned Omise on for.
+ *
+ * `sbps_token_jsonp`: SB Payment Service's card token request, the JSONP <script>
+ * GET its token script sends to /token/generateToken on token.sps-system.com. This
+ * build pauses it only as the browser writes it, aborts any other request on that
+ * path, and answers the paused script with the token as the API recorded it, in the
+ * request's own callback. The device rebuilds the card's ciphertext and sends it
+ * through the checkout relay. Served on the same terms: only to a build that lists
+ * it, for a company Agentcard turned SB Payment Service on for.
+ *
+ * `midtrans_card_token`: the card token Midtrans' Snap popup posts as one JSON request to
+ * api.midtrans.com/v2/token (api.sandbox.midtrans.com in test), under the business's
+ * publishable client key. The cardholder's device sends it and the page gets back Midtrans'
+ * token, which the merchant's own server charges afterwards, card free, running 3-D Secure
+ * there. The token names no amount, so authorize() needs the agent's pair.
+ * Served on the same terms, and the API holds the lane to Agentcard's own company
+ * until a reviewed change binds the client key to the merchant.
+ *
+ * The list itself is capabilities.json, sorted, one per line (scripts/generate-capabilities.mjs).
  */
-export const SUPPORTED_CAPABILITIES = ['fiserv_card_capture', GMO_CAPABILITY, CYBERSOURCE_FLEX_CAPABILITY, JUSPAY_CAPABILITY, DATATRANS_CAPABILITY, 'authorize_net_dpm_form', PELECARD_CAPABILITY, ACI_CAPABILITY, 'creditguard_pps_process', PRIMER_CAPABILITY, PAYRAILS_CAPABILITY, CONVERGE_CAPABILITY, EPROTECT_CAPABILITY, WSPAY_CAPABILITY, SHIJI_STS_CAPABILITY, AMADEUS_CHECKOUT_CAPABILITY, 'worldline_mycheckout_form', 'verifone_card_capture', 'ekashu_hosted_payment_page', SECURE_ACCEPTANCE_CAPABILITY, 'gravy_session_fields_put', 'moneris_hosted_tokenization', PADDLE_VGS_CAPABILITY, PADDLE_TOKENEX_CAPABILITY,
-    'redsys_hosted_payment_page', 'lyra_krypton_payment', 'payfast_card_pay', WIX_PAYMENTS_CAPABILITY, 'paymongo_checkout_pay', 'pay_nl_card_token', HIPAY_CAPABILITY, TWOC2P_CAPABILITY, 'quickpay_hosted_payment_page', 'revolut_card_field', 'paypal_card_fields', 'gopay_card_form', COMGATE_CAPABILITY, PRZELEWY24_CAPABILITY, 'makecommerce_card_frame', 'poynt_collect_nonce',
-    TOKENEX_IFRAME_CAPABILITY, TRANSBANK_CAPABILITY,
-    'sumup_checkout_process'];
+export const SUPPORTED_CAPABILITIES = DECLARED_CAPABILITIES;
 /**
  * Processors whose paused request names no amount at all, so the pair the
  * agent passes is the amount the cardholder approves: authorize() refuses one
@@ -388,88 +475,101 @@ export const SUPPORTED_CAPABILITIES = ['fiserv_card_capture', GMO_CAPABILITY, CY
  * carries, is the total the cardholder approves, and the card that pays can spend
  * no more than that (the API's card rule). Moneris Hosted Tokenization's
  * request.php carries the card and no price: the merchant's server charges the
- * token later, so the agent's pair, above zero (MONERIS_PSP below), is the one
+ * token later, so the agent's pair, above zero (`moneris` in the table), is the one
  * figure the approval shows. Paddle VGS's card request carries none either: Paddle
  * charges the stored card at /pay for what the checkout says, so the agent's pair,
  * which the prepared checkout carries, is the total the cardholder approves. Payfast's
  * card pay carries none either: the merchant's entry bound the total to the payment,
- * so the agent sends the total Payfast's page shows, above zero (PAYFAST_PSP below),
+ * so the agent sends the total Payfast's page shows, above zero (`payfast` in the table),
  * and the API holds it to the payment Payfast itself reports. Wix's tokenize request
  * carries none either: the merchant's page charges Wix's token for its own order, so the
- * agent's pair, which the prepared checkout carries, is the total the cardholder approves.
+ * agent's pair, which the prepared checkout carries, is the total the cardholder approves. Toast's
+ * card request carries none either: the page's card-free confirm of its payment intent
+ * charges whatever the intent says, so the agent's pair, above zero (as Moneris's), is
+ * the one figure the approval shows.
  * PayMongo's card attach carries none either: the merchant bound the total, always in
  * Philippine pesos, to the checkout session when it created it, so the agent sends that
- * total, above zero (PAYMONGO_PSP below), and the API holds it to the session PayMongo's
+ * total, above zero (`paymongo` in the table), and the API holds it to the session PayMongo's
  * own page shows. GoPay's card post carries none either: the shop's server set the amount
  * when it created the payment at GoPay, and GoPay's gateway shows it only inside its own
- * session, so the agent sends the total the gateway shows, above zero (GOPAY_PSP below).
+ * session, so the agent sends the total the gateway shows, above zero (`gopay` in the table).
+ * Paygent's token request carries none either: the merchant's server charges the token later, so
+ * the agent's pair, which the prepared checkout carries, is the total the cardholder approves.
+ * Payrexx's card request names the page's total, but it only mints a token: the merchant's page
+ * charges its own total later, at its validateForm, so the agent sends the total that page shows,
+ * above zero (`payrexx` in the table), and the API holds it to the frame's figure exactly.
  * 2C2P's Payment carries none either: the merchant bound the total to the
  * payment token when it created it, so the agent sends the total 2C2P's page shows, above
- * zero (TWOC2P_PSP), and the API holds it to the amount 2C2P's own PaymentOption answer names.
+ * zero (`twoc2p` in the table), and the API holds it to the amount 2C2P's own PaymentOption answer names.
  * Przelewy24's pay wall link carries none either: the merchant's server registered the amount
  * with Przelewy24 under the link's token, so the agent sends the amount the pay wall shows, above
- * zero (PRZELEWY24_PSP below), and the cardholder's device holds the pay wall to it.
+ * zero (`przelewy24` in the table), and the cardholder's device holds the pay wall to it.
  * HiPay's token create carries none either: the merchant's server charges
  * HiPay's token for its own order, so the agent's pair, which the prepared checkout carries,
  * is the total the cardholder approves, above zero as Moneris's is. Revolut's card payment
  * names the order's amount in minor units but not its currency, which only the order holds,
  * so the number alone is no price the cardholder can approve: the agent sends the pair, above
- * zero (REVOLUT_PSP below), and the API holds its amount to the body's and its currency to
+ * zero (`revolut` in the table), and the API holds its amount to the body's and its currency to
  * one that Revolut and the API both count in hundredths.
  * Pay.'s card token request carries none either: the shop's server charges the token later for
- * its own order total, so the agent's pair, above zero (PAY_NL_PSP below), is the one figure the
+ * its own order total, so the agent's pair, above zero (`pay_nl` in the table), is the one figure the
  * approval shows.
  * PayPal Card Fields' confirm carries none either: the merchant's server fixed the
- * amount when it created the order, so the agent's pair, above zero (PAYPAL_PSP
- * below), is the one figure the approval shows.
+ * amount when it created the order, so the agent's pair, above zero (`paypal` in
+ * the table), is the one figure the approval shows.
  * ComGate's gateway link carries none either: the merchant's server set
  * the amount when it created the payment at ComGate, so the agent's pair, above zero
- * (COMGATE_PSP below), is the figure the cardholder approves, and the cardholder's device
+ * (`comgate` in the table), is the figure the cardholder approves, and the cardholder's device
  * holds ComGate's own figure to it before any card leaves.
  * MakeCommerce's card post carries none either: MakeCommerce's transaction holds the total, in
- * euros, so the agent sends the total the shop's order page shows, above zero (MAKECOMMERCE_PSP
- * below), and the API refuses any other currency.
+ * euros, so the agent sends the total the shop's order page shows, above zero (`makecommerce` in
+ * the table), and the API refuses any other currency.
  * GoDaddy Payments' generate-nonce carries none either: GoDaddy's server charges
- * the nonce later, so its pair must be above zero too (POYNT_PSP below).
+ * the nonce later, so its pair must be above zero too (`poynt` in the table).
  * The TokenEx iframe's card post carries none either: it mints a token into the merchant's TokenEx
  * vault, which the merchant's server charges later for its own order, so the agent sends the total
- * the merchant's page shows, above zero (TOKENEX_IFRAME_PSP), and the API refuses a create without it.
+ * the merchant's page shows, above zero (`tokenex_iframe` in the table), and the API refuses a create without it.
  * Webpay's entry carries none either: the merchant's server bound the total, in Chilean pesos,
- * to the transaction when it created it, so the agent's pair, above zero (TRANSBANK_PSP below),
+ * to the transaction when it created it, so the agent's pair, above zero (`transbank_webpay` in the table),
  * is the figure the cardholder approves, and the cardholder's device holds Webpay's own
  * transaction to it before any card leaves.
  * SumUp's card request carries none either: the merchant's server bound the
  * total and its currency to the checkout when it created it, so the agent sends the total the
- * payment page shows, above zero (SUMUP_PSP below), and the API holds it to the checkout SumUp
+ * payment page shows, above zero (`sumup` in the table), and the API holds it to the checkout SumUp
  * itself reports.
+ * Clover's card token request carries none either: the merchant's server charges the token
+ * later for its own order, so the agent's pair, above zero (`clover` in the table), is the one figure
+ * the approval shows.
+ * Omise's card token request carries none either, for the same reason: the merchant's server
+ * charges the token afterwards for its own order (`omise` in the table).
+ * Paytrail's card method entry carries none either: the merchant's server fixed the amount, in
+ * euros, when it created the payment, so the agent sends that amount (`paytrail` in the table), and
+ * the cardholder's device holds Payment Highway's card page to it.
+ * SB Payment Service's token request carries none either: the merchant's server
+ * charges the token later, so its pair must be above zero too (`sb_payment_service` in the table), and
+ * agree with the page's order total (PAGE_AMOUNT_PROCESSORS).
+ * Midtrans' Snap card token carries none either: the merchant's server charges the token
+ * afterwards, so the agent's pair, above zero (`midtrans` in the table), is the one figure the
+ * approval shows.
+ * The table itself is agent-amount-processors.json, sorted, one processor per line
+ * (scripts/generate-agent-amount.mjs). A processor added there states its reason in the API
+ * create route's refusal, not in this comment.
  */
-const MONERIS_PSP = 'moneris';
-const PAYFAST_PSP = 'payfast';
-const PAYMONGO_PSP = 'paymongo';
 const REVOLUT_PSP = 'revolut';
-const PAY_NL_PSP = 'pay_nl';
-const PAYPAL_PSP = 'paypal';
-const GOPAY_PSP = 'gopay';
-const MAKECOMMERCE_PSP = 'makecommerce';
-const POYNT_PSP = 'poynt';
-const SUMUP_PSP = 'sumup';
-const AGENT_AMOUNT_PROCESSORS = [GMO_PSP, PELECARD_PSP, WSPAY_PSP, SECURE_ACCEPTANCE_PSP, MONERIS_PSP, PADDLE_VGS_PSP, PAYFAST_PSP, WIX_PAYMENTS_PSP, PAYMONGO_PSP, PAY_NL_PSP, HIPAY_PSP, TWOC2P_PSP, REVOLUT_PSP, PAYPAL_PSP, GOPAY_PSP, COMGATE_PSP,
-    PRZELEWY24_PSP, MAKECOMMERCE_PSP, POYNT_PSP, TOKENEX_IFRAME_PSP, TRANSBANK_PSP, SUMUP_PSP];
+const AGENT_AMOUNT_PROCESSORS = AGENT_AMOUNT.processors;
+/** The ones a zero amount is refused for, like a missing one (authorize()). */
+const ABOVE_ZERO_PROCESSORS = AGENT_AMOUNT.aboveZero;
 /** How AmountRequiredError names a processor. */
-const PROCESSOR_NAMES = { [GMO_PSP]: 'GMO', [PELECARD_PSP]: 'Pelecard', [WSPAY_PSP]: 'WSPay',
-    [SECURE_ACCEPTANCE_PSP]: 'CyberSource Secure Acceptance', [MONERIS_PSP]: 'Moneris', [PADDLE_VGS_PSP]: 'Paddle', [PAYFAST_PSP]: 'Payfast', [WIX_PAYMENTS_PSP]: 'Wix', [PAYMONGO_PSP]: 'PayMongo', [PAY_NL_PSP]: 'Pay.', [HIPAY_PSP]: 'HiPay', [TWOC2P_PSP]: '2C2P',
-    [REVOLUT_PSP]: 'Revolut', [PAYPAL_PSP]: 'PayPal', [GOPAY_PSP]: 'GoPay',
-    [COMGATE_PSP]: 'ComGate', [PRZELEWY24_PSP]: 'Przelewy24',
-    [MAKECOMMERCE_PSP]: 'MakeCommerce', [POYNT_PSP]: 'GoDaddy Payments', [TOKENEX_IFRAME_PSP]: 'TokenEx', [TRANSBANK_PSP]: 'Webpay',
-    [SUMUP_PSP]: 'SumUp' };
+const PROCESSOR_NAMES = AGENT_AMOUNT.names;
 /**
  * Processors whose request and answer name no amount at all, so the total the
  * payment page shows (`pageAmount`) is the one figure that ties the agent's pair
  * to what the page charges: authorize() refuses one without it
  * (PageAmountRequiredError), and the API answers 400 page_amount_required for the
- * same case. Pelecard only.
+ * same case. Pelecard, and SB Payment Service, whose token request and answer
+ * name no amount either.
  */
-const PAGE_AMOUNT_PROCESSORS = [PELECARD_PSP];
+const PAGE_AMOUNT_PROCESSORS = AGENT_AMOUNT.pageAmount;
 /** An integer in the smallest unit, or a decimal string in normal units with a point; nothing else. */
 export function validAmountInput(amount) {
     if (typeof amount === 'number')
@@ -741,8 +841,12 @@ export class AmountRequiredError extends Error {
     code = 'amount_required';
     constructor(psp) {
         const processor = PROCESSOR_NAMES[psp] ?? psp;
-        const lacks = psp === REVOLUT_PSP ? 'names its amount but not its currency' : 'names no amount';
-        super(`A ${processor} payment request ${lacks}, so pass amount and currency: that is the amount the cardholder approves. Nothing was created and nothing was charged.`);
+        // A Payrexx card request names the frame's total, but the merchant's page charges its own total after the token.
+        const lacks = psp === REVOLUT_PSP ? 'names its amount but not its currency'
+            : psp === PAYREXX_PSP ? "only mints a token the merchant's page charges later" : 'names no amount';
+        // "An Omise payment request", "A Clover payment request": the article follows the name's first letter.
+        const article = /^[AEIOU]/.test(processor) ? 'An' : 'A';
+        super(`${article} ${processor} payment request ${lacks}, so pass amount and currency: that is the amount the cardholder approves. Nothing was created and nothing was charged.`);
         this.psp = psp;
         this.name = 'AmountRequiredError';
     }
@@ -760,7 +864,7 @@ export class PageAmountRequiredError extends Error {
     psp;
     code = 'page_amount_required';
     constructor(psp) {
-        const processor = psp === PELECARD_PSP ? 'Pelecard' : psp;
+        const processor = PROCESSOR_NAMES[psp] ?? psp;
         super(`A ${processor} payment request names no amount, so pass the total its payment page shows as pageAmount beside amount and currency. Nothing was created and nothing was charged.`);
         this.psp = psp;
         this.name = 'PageAmountRequiredError';
@@ -1086,12 +1190,12 @@ function refusalsOf(v) {
     return out;
 }
 /**
- * How often sendEbanxFollowUp reads a send back while the cardholder's device has it: every half second, whatever the
- * client's own `pollIntervalMs`. One send is out at a time per approval, so this is 120 reads a minute, inside the
- * API's 240 a minute per caller and authorization (routes/api/v2/checkout-follow-ups.ts).
+ * How often sendEbanxFollowUp and sendPayrexxFollowUp read a send back while the cardholder's device has it: every
+ * half second, whatever the client's own `pollIntervalMs`. One send is out at a time per approval, so this is 120
+ * reads a minute, inside the API's 240 a minute per caller and authorization (routes/api/v2/checkout-follow-ups.ts).
  */
 export const EBANX_FOLLOW_UP_READ_MS = 500;
-/** The longest sendEbanxFollowUp waits after reads the API refused as too many (429): 1, 2, 4, 8, then 15 seconds. */
+/** The longest a follow-up send waits after reads the API refused as too many (429): 1, 2, 4, 8, then 15 seconds. */
 export const EBANX_FOLLOW_UP_BACKOFF_MAX_MS = 15_000;
 export class CheckoutApiError extends Error {
     status;
@@ -1199,23 +1303,7 @@ function parseErrorEnvelope(bodyText) {
     }
     return { code: null, details: {} };
 }
-/**
- * A slash as the masks below read one: plain, or escaped once or more in either case (%2F, %2f, %252F). A path keeps
- * an escape as it was written, and the id behind it is the same id, so every slash a mask names reads in any of these
- * spellings. The slashes right before an id read as a run, and a doubled slash hides nothing either.
- */
-const SLASH = '(?:/|%(?:25)*2f)';
-/** A hyphen inside an id: plain, or escaped once or more in either case (%2D, %252d). */
-const HYPHEN = '(?:-|%(?:25)*2d)';
-/**
- * The masks that find a uuid by its shape take it in any case, with or without its hyphens, each hyphen in any
- * spelling HYPHEN reads. The pattern reads a percent escape as one unit and keeps it, so the hex digits of an escaped
- * separator before the id (%2F, %252F, %3D) never start a match and leave the id's last digits showing.
- */
-const UUID_OR_ESCAPE = new RegExp(`%(?:25)*[0-9a-f]{2}|[0-9a-f]{8}${HYPHEN}?[0-9a-f]{4}${HYPHEN}?[0-9a-f]{4}${HYPHEN}?[0-9a-f]{4}${HYPHEN}?[0-9a-f]{12}`, 'gi');
-function maskUuids(path, label) {
-    return path.replace(UUID_OR_ESCAPE, (token) => (token.startsWith('%') ? token : label));
-}
+// SLASH, HYPHEN and maskUuids, which every mask below reads, live in url-mask-parts.ts with the UrlMask shape.
 const CREDITGUARD_HOST = /(?:^|\.)creditguard\.co\.il\.?$/i;
 const CREDITGUARD_TXN = new RegExp(`(${SLASH}txn${SLASH}+)[^/]+`, 'gi');
 function maskCreditguardTxId(path) {
@@ -1384,6 +1472,32 @@ const SUMUP_CHECKOUT = new RegExp(`(${SLASH}checkouts${SLASH}+)[^/]*`, 'gi');
 function maskSumupCheckout(path) {
     return maskUuids(path.replace(SUMUP_CHECKOUT, '$1{checkout}'), '{checkout}');
 }
+/**
+ * FastSpring's checkout posts its card payment to <store>.onfastspring.com[/popup-<name>]/session/<id>/payment
+ * (payment-core fastspring.js), and the session id in that path is a credential: the session's own document,
+ * which anyone holding the id can read with no cookie, carries the order and the session's token. On every
+ * host under onfastspring.com the segment after /session/, in any case and in any spelling of the slashes around
+ * /session/ that SLASH reads, reads {session}.
+ */
+const FASTSPRING_HOST = /(?:^|\.)onfastspring\.com\.?$/i;
+const FASTSPRING_SESSION = new RegExp(`(${SLASH}session${SLASH}+)[^/]*`, 'gi');
+function maskFastspringSession(path) {
+    return path.replace(FASTSPRING_SESSION, '$1{session}');
+}
+/**
+ * PayU Latam's WebCheckout sends the card to /ppp-web-gateway-payu/checkout/submit/<country>/credit_card/<key>
+ * on its own host (payment-core payu-latam.js), and the key, 32 hex characters, is the checkout session's
+ * only credential: the page's card-free routes answer it with no cookie, the order, the payer and the
+ * merchant among them. Every route of the page carries the same key, so on every host under
+ * payulatam.com any run of 32 or more hex characters, in any case or after an escaped slash, reads {key}. A hex
+ * character escaped once or more (%66 or %2566 for f, in either case) counts as that character, since PayU's server
+ * reads the same key, so an escape inside the key cannot split it into two runs too short to mask.
+ */
+const PAYU_LATAM_HOST = /(?:^|\.)payulatam\.com\.?$/i;
+const PAYU_LATAM_KEY = /(?:[0-9a-f]|%(?:25)*(?:3[0-9]|4[1-6]|6[1-6])){32,}/gi;
+function maskPayuLatamKey(path) {
+    return path.replace(PAYU_LATAM_KEY, '{key}');
+}
 /**
  * The processors whose card request carries its own credential in the URL path, with the hosts
  * that send it, the text that names those hosts anywhere else (a string that is not a URL, or a
@@ -1531,10 +1645,7 @@ const QUICKPAY_SESSION = /(\/|%2f)[0-9a-f]{32,}/gi;
 function maskQuickpaySession(path) {
     return path.replace(QUICKPAY_SESSION, '$1{session}');
 }
-/**
- * `mask` reads a text that names the processor's host; `pathMask`, where a processor has one, reads the path of a
- * URL already parsed on that host, which `mask` reads otherwise.
- */
+/** Today's masks here; each later processor's in its own src/url-masks/<psp>.ts (URL_MASKS). */
 const PATH_CREDENTIALS = [
     { host: PATH_SECRET_HOST, named: /(?:wspay\.biz|monri\.com)/i, mask: maskPathSecret },
     { host: CREDITGUARD_HOST, named: /creditguard\.co\.il/i, mask: maskCreditguardTxId },
@@ -1558,6 +1669,9 @@ const PATH_CREDENTIALS = [
     { host: PAYMENT_HIGHWAY_HOST, named: /(?:paymenthighway\.io|sph-test-solinor\.com)/i, mask: maskPaymentHighwaySession },
     { host: TWOC2P_PAGE_HOST, named: /pgw-ui\.2c2p\.com/i, mask: maskTwoC2pToken, pathMask: maskTwoC2pPath },
     { host: QUICKPAY_HOST, named: /quickpay\.net/i, mask: maskQuickpaySession },
+    { host: FASTSPRING_HOST, named: /onfastspring\.com/i, mask: maskFastspringSession },
+    { host: PAYU_LATAM_HOST, named: /payulatam\.com/i, mask: maskPayuLatamKey },
+    ...URL_MASKS,
 ];
 /**
  * A URL as it may appear in an error message: origin + path only. A paused
@@ -1595,6 +1709,11 @@ const PATH_CREDENTIALS = [
  * https://pgw-ui.2c2p.com/payment/4.1/{token}.
  * On QuickPay's host the window's session reads `{session}`:
  * https://payment.quickpay.net/{session}/3ds_auth.
+ * On FastSpring's store hosts the session id reads `{session}`:
+ * https://daisydisk.onfastspring.com/session/{session}/payment.
+ * On PayU Latam's hosts the checkout session's key reads `{key}`:
+ * https://checkout.payulatam.com/ppp-web-gateway-payu/checkout/submit/co/credit_card/{key}.
+ * Each mask in src/url-masks/ says what it reads in its own file.
  * A string that is not a URL keeps the part before any `?` or `#`, with the
  * same segments masked for every processor whose host it names.
  * A URL is read by its host only when the parser finds one. Text before a URL
@@ -1703,6 +1822,18 @@ const PADDLE_VGS_PREPARATION_REFUSALS = [
  * `unsupported_checkout`, which PREPARATION_REFUSALS names for every checkout. Only for a Wix checkout.
  */
 const WIX_PAYMENTS_PREPARATION_REFUSALS = ['processor_unavailable', 'live_host_on_sandbox_row', 'merchant_profile_mismatch'];
+/**
+ * The API's refusals of a Paygent preparation, before any preparation exists, that prepareCheckout passes on
+ * by name: Paygent is off for the company (`processor_unavailable`), the environment is not the client's test
+ * or live mode, a live checkout's currency is not the one the reviewed merchant charges in
+ * (`unsupported_currency`), and the price is zero (`amount_required`): Paygent's token request names no
+ * amount, so the price the agent sends is the one the cardholder approves. A page and name no reviewed pin
+ * lists answers `unsupported_checkout`, which PREPARATION_REFUSALS names for every checkout. The API holds the
+ * pins, not this build, so a merchant a later release reviews needs no new SDK. Only for a Paygent checkout.
+ */
+const PAYGENT_PREPARATION_REFUSALS = [
+    'processor_unavailable', 'sandbox_host_on_live_row', 'live_host_on_sandbox_row', 'unsupported_currency', 'amount_required',
+];
 /**
  * The API's refusals of a HiPay preparation, before any preparation exists, that prepareCheckout surfaces by name:
  * the company is not turned on for HiPay (`processor_unavailable`), the environment is not the caller's key mode's
@@ -2293,6 +2424,8 @@ export class VaultClient {
             throw fail(secureAcceptanceRefusal);
         const secureAcceptanceProfileId = secureAcceptance ? secureAcceptanceCheckoutProfile({ environment: input.environment,
             profileId: input.secureAcceptanceProfileId, merchantOrigin: input.merchantOrigin }) : null;
+        // A live Paygent checkout's merchant is the API's to judge against the reviewed pins it holds, before anyone is
+        // asked to approve (PAYGENT_PREPARATION_REFUSALS); test mode needs no pin.
         const timeoutMs = input.timeoutMs ?? 15 * 60_000;
         if (!Number.isInteger(timeoutMs) || timeoutMs <= 0 || timeoutMs > 2_147_483_647)
             throw fail('timeout_invalid');
@@ -2412,6 +2545,7 @@ export class VaultClient {
                     || (input.psp === EPROTECT_PSP && EPROTECT_PREPARATION_REFUSALS.includes(error.code))
                     || (input.psp === PADDLE_VGS_PSP && PADDLE_VGS_PREPARATION_REFUSALS.includes(error.code))
                     || (input.psp === WIX_PAYMENTS_PSP && WIX_PAYMENTS_PREPARATION_REFUSALS.includes(error.code))
+                    || (input.psp === PAYGENT_PSP && PAYGENT_PREPARATION_REFUSALS.includes(error.code))
                     || (input.psp === HIPAY_PSP && HIPAY_PREPARATION_REFUSALS.includes(error.code))
                     || (!!flexContext && CYBERSOURCE_FLEX_PREPARATION_REFUSALS.includes(error.code))))
                     || (input.psp === 'fiserv' && error.status === 502 && error.code === 'cse_key_unavailable')))
@@ -2667,14 +2801,15 @@ export class VaultClient {
                     : `checkout authorization is POST-only; got ${method} for ${redactUrl(input.request.url)}. ` +
                         'A non-POST tokenizer needs recognizer support before it can be intercepted.');
         }
-        // A GET card request is its URL alone. This build completes two kinds: Worldpay
-        // eProtect's registration exactly as payment-core admits it, with no body, and a
-        // hosted page's entry link exactly as its rule admits it (hosted-entry.ts), with no
-        // body, which the cardholder's device takes over.
+        // A GET card request is its URL alone. This build completes three kinds: Worldpay
+        // eProtect's registration and SB Payment Service's token request, each exactly as
+        // payment-core admits it, with no body, and a hosted page's entry link exactly as its
+        // rule admits it (hosted-entry.ts), with no body, which the cardholder's device takes over.
         const eprotect = rec?.psp === EPROTECT_PSP;
         const hostedGetEntry = mode === 'hosted_form' && !!rec && isHostedGetEntry(rec.psp, input.request.url)
             && (input.request.body === undefined || input.request.body === null || input.request.body === '');
-        if (cardMethod === 'GET' && !(eprotect && isEprotectRegistration(input.request)) && !hostedGetEntry) {
+        const sbps = rec?.psp === SBPS_PSP;
+        if (cardMethod === 'GET' && !(eprotect && isEprotectRegistration(input.request)) && !hostedGetEntry && !(sbps && isSbpsTokenGet(input.request))) {
             throw new Error(`this ${rec?.psp} GET is not a card registration this version of @agent-cards/checkout can complete: ${redactUrl(input.request.url)}.`);
         }
         // A CyberSource Secure Acceptance token create (always prepared: its recognizer requires it). The
@@ -2709,17 +2844,17 @@ export class VaultClient {
         // the total GoPay's payment already holds, so a zero pair would show the cardholder no price at all: it is refused
         // like a missing one.
         // A ComGate payment charges the total ComGate already holds for it, the same way, and a Webpay transaction the
-        // total the merchant's server bound to it.
+        // total the merchant's server bound to it, and a Payrexx page charges its own
+        // total after the frame's token.
         // A Moneris token is charged later for whatever the merchant's server decides, and a Payfast pay, a
         // PayMongo attach or a MakeCommerce card post charges the total its payment, checkout session or
         // transaction already holds, so a zero pair would show the cardholder no price at all: it is refused
         // like a missing one. So is a TokenEx iframe token, which the merchant's server charges later for its own order.
-        if (hasAmount && rec && rec.psp === PRZELEWY24_PSP && Number(input.amount) <= 0)
-            throw new AmountRequiredError(rec.psp);
-        if (hasAmount && rec && (rec.psp === MONERIS_PSP || rec.psp === PAYFAST_PSP || rec.psp === PAYMONGO_PSP || rec.psp === HIPAY_PSP || rec.psp === TWOC2P_PSP
-            || rec.psp === REVOLUT_PSP || rec.psp === PAY_NL_PSP || rec.psp === PAYPAL_PSP
-            || rec.psp === GOPAY_PSP || rec.psp === COMGATE_PSP || rec.psp === MAKECOMMERCE_PSP
-            || rec.psp === POYNT_PSP || rec.psp === TOKENEX_IFRAME_PSP || rec.psp === TRANSBANK_PSP || rec.psp === SUMUP_PSP) && Number(input.amount) <= 0)
+        // A Clover token is charged later for whatever the merchant's server decides, as a Moneris one is.
+        // A Toast payment method is charged by the page's own confirm for whatever its intent says, the same way.
+        // An Omise token is charged later for whatever the merchant's server decides, as a Clover one is.
+        // An SB Payment Service token is charged later the same way.
+        if (hasAmount && rec && ABOVE_ZERO_PROCESSORS.includes(rec.psp) && Number(input.amount) <= 0)
             throw new AmountRequiredError(rec.psp);
         // Nor is the agent's pair tied to the page by anything but the total the
         // page shows: without it the cardholder could approve one figure while the
@@ -3055,6 +3190,10 @@ export class VaultClient {
                         // source.encryptionData and removes nothing (fiserv.ts); any other shape is not one to act on.
                         if (rec.psp === 'fiserv' && !isFiservSubstitution(sub))
                             throw new PaymentOutcomeUnknownError(authorizationId, 'cse_substitutions_malformed');
+                        // A Toast approval carries exactly one sealed card, cardData at `card`, and removes nothing
+                        // (payment-core toast-seal.js substituteToastCardData checks the rest at the swap).
+                        if (rec.psp === TOAST_PSP && !isToastSubstitution(sub))
+                            throw new PaymentOutcomeUnknownError(authorizationId, 'cse_substitutions_malformed');
                         // `remove`: sibling keys the API says to drop with the swap (Adyen's
                         // `brand`, stamped by adyen-web from the agent's dummy digits). Absent
                         // on an older API; anything but a list of names is refused, since a
@@ -3153,6 +3292,18 @@ export class VaultClient {
                         response.headers = answer.headers;
                         response.body = answer.body;
                     }
+                    if (sbps) {
+                        // SB Payment Service: the paused <script> is answered the way SBPS answers it,
+                        // `<callback>({"tokenRes": ...})` under a script type, with the callback the paused URL named
+                        // and only a token payment-core's judge accepts for that URL. Anything else is not an answer to
+                        // hand the page, and the device may already have sent the card to SBPS.
+                        const answer = sbpsScriptAnswer(input.request.url, response);
+                        if (!answer)
+                            throw new PaymentOutcomeUnknownError(authorizationId, 'sbps_token_unconfirmed');
+                        response.status = answer.status;
+                        response.headers = answer.headers;
+                        response.body = answer.body;
+                    }
                     if (secureAcceptance) {
                         // CyberSource Secure Acceptance: the paused frame navigation is answered with CyberSource's own
                         // reply page, byte for byte, with status 200 and its one content type, and only a page
@@ -3225,6 +3376,18 @@ export class VaultClient {
                         response.headers = answer.headers;
                         response.body = answer.body;
                     }
+                    if (rec?.psp === PAYGENT_PSP) {
+                        // Paygent's answer enters the page only as payment-core rebuilds an approved token from its members
+                        // (paygent.js paygentAnswerOutcome: HTTP 200, result 0000 and a token in shape), under a JSON content
+                        // type. Anything else, a refusal Paygent answers inside HTTP 200 included, is never handed over as an
+                        // approval; the card may have left the device, so the outcome is unknown rather than declined.
+                        const judged = paygentAnswerOutcome(response.status, response.body, null);
+                        if (judged.outcome !== 'approved' || typeof judged.body !== 'string')
+                            throw new PaymentOutcomeUnknownError(authorizationId, 'paygent_token_unconfirmed');
+                        response.status = 200;
+                        response.headers = { 'content-type': 'application/json' };
+                        response.body = judged.body;
+                    }
                     if (rec?.psp === PRIMER_PSP) {
                         // Primer's answer enters the page only as one single-use card token rebuilt from
                         // payment-core's allow-list, under a JSON content type (primer.ts primerTokenAnswer).
@@ -3279,8 +3442,9 @@ export class VaultClient {
                         chargedAmount: typeof s.charged_amount === 'number' ? s.charged_amount : null,
                         chargedCurrency: typeof s.charged_currency === 'string' ? s.charged_currency : null,
                         chargedKind: s.charged_kind === 'captured' || s.charged_kind === 'authorized' || s.charged_kind === 'none' ? s.charged_kind : null,
-                        // An EBANX token approval that covers the sends after it names until when (ebanx.ts EbanxFollowUps).
-                        ...(rec?.psp === 'ebanx' && typeof s.follow_ups?.until === 'string' && Number.isFinite(Date.parse(s.follow_ups.until))
+                        // An EBANX token approval, or a Payrexx card request whose answer started 3-D Secure, that covers the sends
+                        // after it names until when (ebanx.ts EbanxFollowUps, payrexx.ts PayrexxFollowUps).
+                        ...((rec?.psp === 'ebanx' || rec?.psp === PAYREXX_PSP) && typeof s.follow_ups?.until === 'string' && Number.isFinite(Date.parse(s.follow_ups.until))
                             ? { followUpsUntil: s.follow_ups.until } : {}),
                         ...amountAuthority,
                         ...execution,
@@ -3493,6 +3657,20 @@ export class VaultClient {
      * an answer that carried the card, or `options.until` (the approval's window, plus the API's own clocks) passed.
      */
     async sendEbanxFollowUp(authorizationId, request, options = {}) {
+        return this.sendFollowUp(authorizationId, request, options, (reason, cardSent) => new EbanxFollowUpError(reason, cardSent, authorizationId));
+    }
+    /**
+     * Send one of Payrexx's 3-D Secure sends an approved Payrexx card request covers (payrexx.ts says which: the card
+     * frame's authentication after the ACS method and its post-authentication after the bank's challenge, bound to that
+     * approval) from the cardholder's device, and resolve with Payrexx's answer for the paused request, exactly as
+     * sendEbanxFollowUp does for EBANX: the same create, reads and clocks, and no prompt. Rejects with a
+     * PayrexxFollowUpError naming why there is no answer and whether the card may have reached Payrexx.
+     */
+    async sendPayrexxFollowUp(authorizationId, request, options = {}) {
+        return this.sendFollowUp(authorizationId, request, options, (reason, cardSent) => new PayrexxFollowUpError(reason, cardSent, authorizationId));
+    }
+    /** The send behind sendEbanxFollowUp and sendPayrexxFollowUp; `fail` builds the processor's error for a send with no answer. */
+    async sendFollowUp(authorizationId, request, options, fail) {
         if (!/^cauth_[A-Za-z0-9_-]{1,128}$/.test(authorizationId))
             throw new Error('Invalid authorization ID.');
         const base = `/v2/checkout/authorizations/${authorizationId}/follow_ups`;
@@ -3506,16 +3684,16 @@ export class VaultClient {
         catch (error) {
             // A refusal (a 4xx answer) stored no send, so nothing left. Any other failure (a 5xx, a timeout, a dropped
             // connection, an unreadable 201) may have come after the API stored the send, which the device then sends:
-            // the card may reach EBANX, and for a confirm that is a payment whose outcome is unknown.
+            // the card may reach the processor, and for an EBANX confirm that is a payment whose outcome is unknown.
             const refused = error instanceof CheckoutApiError && error.status >= 400 && error.status < 500;
             const reason = error instanceof CheckoutApiError
                 ? (typeof error.details.reason === 'string' && /^[a-z_]{1,64}$/.test(error.details.reason) ? error.details.reason : error.code ?? `http_${error.status}`)
                 : 'follow_up_unavailable';
-            throw new EbanxFollowUpError(reason, !refused, authorizationId);
+            throw fail(reason, !refused);
         }
         const id = created?.id;
         if (typeof id !== 'string' || !/^cfu_[0-9a-f]{24}$/.test(id) || created.authorization !== authorizationId) {
-            throw new EbanxFollowUpError('follow_up_unrecognized', true, authorizationId);
+            throw fail('follow_up_unrecognized', true);
         }
         // Reads the API refused in a row as too many (429): each waits twice as long as the last before the next read.
         let limited = 0;
@@ -3527,14 +3705,14 @@ export class VaultClient {
             }
             catch (error) {
                 if (signal.aborted)
-                    throw new EbanxFollowUpError('answer_late', true, authorizationId);
+                    throw fail('answer_late', true);
                 if (error instanceof CheckoutApiError && error.status === 429)
                     limited += 1;
             }
             if (read?.status === 'answered') {
                 const r = read.response;
                 if (!r || !Number.isInteger(r.status) || r.status < 200 || r.status > 599 || typeof r.body !== 'string' || !r.headers || typeof r.headers !== 'object') {
-                    throw new EbanxFollowUpError('follow_up_unrecognized', true, authorizationId);
+                    throw fail('follow_up_unrecognized', true);
                 }
                 const headers = {};
                 for (const [name, value] of Object.entries(r.headers))
@@ -3544,10 +3722,10 @@ export class VaultClient {
             }
             if (read?.status === 'failed' || read?.status === 'expired') {
                 const reason = typeof read.failure_reason === 'string' && /^[a-z_]{1,64}$/.test(read.failure_reason) ? read.failure_reason : read.status;
-                throw new EbanxFollowUpError(reason, read.card_sent !== false, authorizationId);
+                throw fail(reason, read.card_sent !== false);
             }
             if (signal.aborted || Date.now() >= deadline)
-                throw new EbanxFollowUpError('answer_late', true, authorizationId);
+                throw fail('answer_late', true);
             const wait = limited === 0 ? EBANX_FOLLOW_UP_READ_MS : Math.min(EBANX_FOLLOW_UP_BACKOFF_MAX_MS, 1000 * 2 ** (limited - 1));
             await interruptibleSleep(Math.max(1, Math.min(wait, deadline - Date.now())), signal);
         }
@@ -4108,3 +4286,14 @@ function interruptibleSleep(ms, signal) {
         signal?.addEventListener('abort', done, { once: true });
     });
 }
+/** A served Toast set: exactly { cardData } at `card`, a 256-byte base64 value, with nothing to remove. */
+function isToastSubstitution(sub) {
+    if (!sub || typeof sub !== 'object')
+        return false;
+    const { at, fields, remove } = sub;
+    if (at !== 'card' || !fields || typeof fields !== 'object' || Array.isArray(fields))
+        return false;
+    const keys = Object.keys(fields);
+    return keys.length === 1 && keys[0] === 'cardData' && isToastCiphertext(fields.cardData)
+        && (remove === undefined || (Array.isArray(remove) && remove.length === 0));
+}