@agent-cards/sdk 0.23.17 → 0.23.19

package/dist/client.d.ts

@@ -249,6 +249,14 @@ export declare const SUPPORTED_REGISTRY_FEATURES: readonly string[];
  * Wix's token. A second card request from the frame, which Wix's frame sends after a 401
  * or 403 under a fresh instance, is never answered from the same approval. Served on the
  * same terms: only to a build that lists it, for a company Agentcard turned Wix on for.
+ *
+ * `paymongo_checkout_pay`: the card attach PayMongo's hosted checkout sends to its own page
+ * URL (checkout.paymongo.com/<session>) as a Next.js Server Action. This build pauses only the
+ * page's own card attach and answers it with PayMongo's answer as the API recorded it, under the
+ * RSC type the page reads: a paid payment intent, or the step toward PayMongo's 3-D Secure page
+ * that the page then runs in the agent's browser. The cardholder's device sends the card through
+ * the checkout relay. Served on the same terms: only to a build that lists it, for a company
+ * Agentcard turned PayMongo on for.
  */
 export declare const SUPPORTED_CAPABILITIES: readonly string[];
 /**
@@ -1176,8 +1184,23 @@ export declare class CheckoutAuthError extends Error {
  * https://www.paypal.com/v2/checkout/orders/{order}/confirm-payment-source.
  * On PayMongo's checkout host the session id reads `{session}`: https://checkout.paymongo.com/{session}.
  * On GoPay's card frame hosts the card form's token reads `{token}`: https://secure.gopay.com/gp-card-comm/h/{token}.
+ * On komoju.com a session id reads `{session}`: https://komoju.com/api/v1/sessions/{session}/pay.
+ * On Przelewy24's hosts the transaction's token reads `{token}`:
+ * https://secure.przelewy24.pl/trnRequest/{token}.
+ * On Revolut's card payment and hosted checkout hosts an order or payment token reads `{token}`:
+ * https://merchant.revolut.com/api/public/orders/{token}/payments.
+ * On SumUp's API host a checkout id reads `{checkout}`: https://api.sumup.com/v0.2/checkouts/{checkout}.
+ * On Paytrail's hosts a payment's id reads `{transaction}`:
+ * https://services.paytrail.com/payments/{transaction}/click-to-pay/loading-and-redirect, and on Payment
+ * Highway's a card page's session reads `{session}`.
  * A string that is not a URL keeps the part before any `?` or `#`, with the
- * same segments masked.
+ * 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
+ * can read as a scheme: `see:https://api.stripe.com/...` parses as a URL with
+ * the scheme `see`, no host, and the whole Stripe URL as its path, so a parse
+ * with no host is read as a string that is not a URL. A path can carry a URL of
+ * its own, as `http:https://api.stripe.com/...` does once `https` reads as its
+ * host, so every processor whose host the path names masks the URL too.
  */
 export declare function redactUrl(raw: string): string;
 export interface VaultClientOptions {

package/dist/client.js

@@ -1,7 +1,7 @@
 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, redactAciCheckoutId } from './aci.js';
+import { ACI_CAPABILITY, ACI_PSP, aciCardLegAnswer } from './aci.js';
 import { EPROTECT_CAPABILITY, EPROTECT_PSP, eprotectCheckoutRefusal, eprotectScriptAnswer, isEprotectRegistration } from './eprotect.js';
 import { isMercadoTokenRequest, parseMercadoCheckoutContext, validateMercadoProcessorContext } from './mercado-checkout.generated.js';
 import { matchesPreparation, preparationMode, validPreparationEnvironment } from './prepared-processor.js';
@@ -233,9 +233,17 @@ export const SUPPORTED_REGISTRY_FEATURES = ['card_fields', 'checkout_sessions'];
  * Wix's token. A second card request from the frame, which Wix's frame sends after a 401
  * or 403 under a fresh instance, is never answered from the same approval. Served on the
  * same terms: only to a build that lists it, for a company Agentcard turned Wix on for.
+ *
+ * `paymongo_checkout_pay`: the card attach PayMongo's hosted checkout sends to its own page
+ * URL (checkout.paymongo.com/<session>) as a Next.js Server Action. This build pauses only the
+ * page's own card attach and answers it with PayMongo's answer as the API recorded it, under the
+ * RSC type the page reads: a paid payment intent, or the step toward PayMongo's 3-D Secure page
+ * that the page then runs in the agent's browser. The cardholder's device sends the card through
+ * the checkout relay. Served on the same terms: only to a build that lists it, for a company
+ * Agentcard turned PayMongo on for.
  */
 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];
+    'redsys_hosted_payment_page', 'lyra_krypton_payment', 'payfast_card_pay', WIX_PAYMENTS_CAPABILITY, 'paymongo_checkout_pay'];
 /**
  * Processors whose paused request names no amount at all, so the pair the
  * agent passes is the amount the cardholder approves: authorize() refuses one
@@ -264,13 +272,18 @@ export const SUPPORTED_CAPABILITIES = ['fiserv_card_capture', GMO_CAPABILITY, CY
  * 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.
+ * 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
+ * own page shows.
  */
 const MONERIS_PSP = 'moneris';
 const PAYFAST_PSP = 'payfast';
-const AGENT_AMOUNT_PROCESSORS = [GMO_PSP, PELECARD_PSP, WSPAY_PSP, SECURE_ACCEPTANCE_PSP, MONERIS_PSP, PADDLE_VGS_PSP, PAYFAST_PSP, WIX_PAYMENTS_PSP];
+const PAYMONGO_PSP = 'paymongo';
+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];
 /** 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' };
+    [SECURE_ACCEPTANCE_PSP]: 'CyberSource Secure Acceptance', [MONERIS_PSP]: 'Moneris', [PADDLE_VGS_PSP]: 'Paddle', [PAYFAST_PSP]: 'Payfast', [WIX_PAYMENTS_PSP]: 'Wix', [PAYMONGO_PSP]: 'PayMongo' };
 /**
  * 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
@@ -1000,10 +1013,27 @@ 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));
+}
 const CREDITGUARD_HOST = /(?:^|\.)creditguard\.co\.il\.?$/i;
+const CREDITGUARD_TXN = new RegExp(`(${SLASH}txn${SLASH}+)[^/]+`, 'gi');
 function maskCreditguardTxId(path) {
-    return path.replace(/(\/txn\/)[^/]+/gi, '$1{txId}')
-        .replace(/[0-9a-f]{8}-?[0-9a-f]{4}-?[0-9a-f]{4}-?[0-9a-f]{4}-?[0-9a-f]{12}/gi, '{txId}');
+    return maskUuids(path.replace(CREDITGUARD_TXN, '$1{txId}'), '{txId}');
 }
 /**
  * Hosts that put a per-payment secret in the PATH: Monri Components and
@@ -1011,9 +1041,12 @@ function maskCreditguardTxId(path) {
  * /v2/payment/{client_secret}/confirm (and /show, /status), and with the page's
  * public token that secret confirms the payment and reads its status.
  */
-const PATH_SECRET_HOSTS = ['proxy.wspay.biz', 'proxy-test.wspay.biz', 'ipg.monri.com', 'ipgtest.monri.com'];
-/** The segment after a `payment` segment, in any case (the WSPay proxy is IIS) or after an escaped slash. */
-const PATH_SECRET = /(\/payment(?:\/|%2f))[^/]*/gi;
+const PATH_SECRET_HOST = /^(?:proxy(?:-test)?\.wspay\.biz|ipg(?:test)?\.monri\.com)\.?$/i;
+/** The segment after a `payment` segment, in any case (the WSPay proxy is IIS) and any spelling of its slashes. */
+const PATH_SECRET = new RegExp(`(${SLASH}payment${SLASH}+)[^/]*`, 'gi');
+function maskPathSecret(path) {
+    return path.replace(PATH_SECRET, '$1{client_secret}');
+}
 /**
  * Gravy (Gr4vy) gives every merchant hosts of its own under gr4vy.app, and Secure Fields sends the
  * card to /checkout/sessions/<session id>/fields with no auth header, so the session id is that
@@ -1023,10 +1056,9 @@ const PATH_SECRET = /(\/payment(?:\/|%2f))[^/]*/gi;
  * session ids.
  */
 const GRAVY_HOST = /(?:^|\.)gr4vy\.app\.?$/i;
-const GRAVY_SESSION = /(\/checkout\/sessions(?:\/|%2f))[^/]*/gi;
-const GRAVY_SESSION_ID = /[0-9a-f]{8}-?[0-9a-f]{4}-?[0-9a-f]{4}-?[0-9a-f]{4}-?[0-9a-f]{12}/gi;
+const GRAVY_SESSION = new RegExp(`(${SLASH}checkout${SLASH}sessions${SLASH}+)[^/]*`, 'gi');
 function maskGravySession(path) {
-    return path.replace(GRAVY_SESSION, '$1{session}').replace(GRAVY_SESSION_ID, '{session}');
+    return maskUuids(path.replace(GRAVY_SESSION, '$1{session}'), '{session}');
 }
 /**
  * Rapyd's hosted pages send the card to api.rapyd.net (sandboxapi.rapyd.net in test) with no auth
@@ -1037,7 +1069,7 @@ function maskGravySession(path) {
  * after an escaped slash, read {token}.
  */
 const RAPYD_HOST = /(?:^|\.)rapyd\.net\.?$/i;
-const RAPYD_CARD_PAGE = /(\/hosted\/collect\/card(?:\/|%2f))[^/]*/gi;
+const RAPYD_CARD_PAGE = new RegExp(`(${SLASH}hosted${SLASH}collect${SLASH}card${SLASH}+)[^/]*`, 'gi');
 const RAPYD_PAGE_ID = /(?:checkout|hp_[a-z]+)_[a-z0-9]+/gi;
 function maskRapydToken(path) {
     return path.replace(RAPYD_CARD_PAGE, '$1{token}').replace(RAPYD_PAGE_ID, '{token}');
@@ -1050,18 +1082,19 @@ function maskRapydToken(path) {
  * SetupIntent id stays: confirming one also needs its client_secret, which rides in the body.
  */
 const STRIPE_API_HOST = /^api\.stripe\.com\.?$/i;
-const STRIPE_PAYMENT_PAGE = /(\/payment_pages(?:\/|%2f))[^/]*/gi;
+const STRIPE_PAYMENT_PAGE = new RegExp(`(${SLASH}payment_pages${SLASH}+)[^/]*`, 'gi');
 function maskStripeSession(path) {
     return path.replace(STRIPE_PAYMENT_PAGE, '$1{session}');
 }
 /**
- * redactAciCheckoutId (aci.ts) takes the checkout id out of the paths ACI's widget sends. This rule
- * takes any other copy of it out on ACI's hosts: a trailing dot on the host, an escaped or doubled
- * slash, another case, a string that is not a URL. The segment after /v1/checkouts/ and any id of
- * ACI's shape (<32 hex>.<cluster>-vm-tx<nn>) read {checkoutId}.
+ * ACI's checkout id is that checkout's only capability: once the card-number request carried the real
+ * card, anyone holding it can post /payment against that card for the rest of the checkout's 30
+ * minutes. On ACI's hosts, with a trailing dot, an escaped or doubled slash, in another case or in a
+ * string that is not a URL, the segment after /v1/checkouts/ and any id of ACI's shape
+ * (<32 hex>.<cluster>-vm-tx<nn>) read {checkoutId}.
  */
 const ACI_HOST = /^(?:eu-prod\.|eu-test\.|test\.)?oppwa\.com\.?$/i;
-const ACI_CHECKOUT = /(\/v1\/checkouts(?:\/|%2f))[^/]*/gi;
+const ACI_CHECKOUT = new RegExp(`(${SLASH}v1${SLASH}checkouts${SLASH}+)[^/]*`, 'gi');
 const ACI_CHECKOUT_ID = /[0-9a-f]{32}\.[a-z0-9]{1,16}-vm-tx[0-9]{1,3}/gi;
 function maskAciCheckout(path) {
     return path.replace(ACI_CHECKOUT, '$1{checkoutId}').replace(ACI_CHECKOUT_ID, '{checkoutId}');
@@ -1071,34 +1104,35 @@ function maskAciCheckout(path) {
  * with no auth header and no CSRF token (payment-core payfast.js): the payment's uuid is the
  * request's only credential, and with it anyone can read that payment page, its amount and its
  * merchant. Every route of the page carries the same uuid, so on every host Payfast owns (payfast.io and
- * payfast.co.za and any name under them) any id of its shape, in any case or after an escaped slash,
- * reads {uuid}.
+ * payfast.co.za and any name under them) any id of its shape, in every spelling maskUuids reads, reads {uuid}.
  */
 const PAYFAST_HOST = /(?:^|\.)payfast\.(?:io|co\.za)\.?$/i;
-const PAYFAST_UUID = /[0-9a-f]{8}-?[0-9a-f]{4}-?[0-9a-f]{4}-?[0-9a-f]{4}-?[0-9a-f]{12}/gi;
 function maskPayfastUuid(path) {
-    return path.replace(PAYFAST_UUID, '{uuid}');
+    return maskUuids(path, '{uuid}');
 }
 /**
  * Paddle's checkout frame pays a TokenEx checkout with its own /pay on checkout-service.paddle.com
  * (sandbox-checkout-service in test), and the checkout id in that path is the checkout's only
  * credential there, no cookies (payment-core paddle-tokenex.js): with it, and the card in the body,
  * a payment reaches that checkout. On those hosts the segment between /checkout/ or
- * /transaction-checkout/ and /pay, in any case or after an escaped slash, reads {checkout}.
+ * /transaction-checkout/ and /pay, in any case and any spelling of the slashes around it, reads {checkout}.
+ * The segment ends at the first slash in any spelling, so a long run of them cannot make the pattern try
+ * every way of splitting the run between the segment and the slashes.
  */
 const PADDLE_CHECKOUT_HOST = /^(?:sandbox-)?checkout-service\.paddle\.com\.?$/i;
-const PADDLE_PAY = /(\/(?:checkout|transaction-checkout)(?:\/|%2f))[^/]*(\/pay)/gi;
+const PADDLE_PAY = new RegExp(`(${SLASH}(?:checkout|transaction-checkout)${SLASH}+)(?:[^/%]|%(?!(?:25)*2f))+(${SLASH}+pay)`, 'gi');
 function maskPaddleCheckout(path) {
     return path.replace(PADDLE_PAY, '$1{checkout}$2');
 }
 /**
  * Lyra's Krypton frame sends its payment to ProcessPayment/2 on the brand's API host with the form
  * token's session id as a `;jsessionid=` path parameter (payment-core lyra.js). With the form token the
- * body carries, that id continues the payment on Lyra's side, so on Lyra's hosts it reads `{session}`,
- * in any case: https://api.systempay.fr/api-payment/V4/Charge/Public/ProcessPayment/2;jsessionid={session}.
+ * body carries, that id continues the payment on Lyra's side, so on Lyra's hosts it reads `{session}`, in any
+ * case and with its `;` or `=` escaped once or more:
+ * https://api.systempay.fr/api-payment/V4/Charge/Public/ProcessPayment/2;jsessionid={session}.
  */
 const LYRA_HOST = /^(?:api\.payzen\.eu|api\.systempay\.fr|api-sogecommerce\.societegenerale\.eu|api\.lyra\.com)\.?$/i;
-const LYRA_SESSION = /;jsessionid=[^/;?#]*/gi;
+const LYRA_SESSION = /(?:;|%(?:25)*3b)jsessionid(?:=|%(?:25)*3d)[^/;?#]*/gi;
 function maskLyraSession(path) {
     return path.replace(LYRA_SESSION, ';jsessionid={session}');
 }
@@ -1123,24 +1157,54 @@ function maskPaymongoSession(path) {
  * case or after an escaped slash, reads {token}: https://secure.gopay.com/gp-card-comm/h/{token}.
  */
 const GOPAY_CARD_FORM_HOST = /^secure(?:\.sandbox)?\.gopay\.com\.?$/i;
-const GOPAY_CARD_FORM_TOKEN = /(\/h(?:\/|%2f))[^/?#]*/gi;
+const GOPAY_CARD_FORM_TOKEN = new RegExp(`(${SLASH}h${SLASH}+)[^/?#]*`, 'gi');
 function maskGopayToken(path) {
     return path.replace(GOPAY_CARD_FORM_TOKEN, '$1{token}');
 }
+/**
+ * KOMOJU's Hosted Fields frame pays a session with POST /api/v1/sessions/<id>/pay on komoju.com under
+ * the merchant's publishable key, which is public (payment-core komoju.js): with the session id, anyone
+ * can read that session's amount and buyer email and pay it. On komoju.com the segment after /sessions,
+ * in any case and after any run of slashes, each written plain or escaped once or more, reads {session}:
+ * https://komoju.com/api/v1/sessions/{session}/pay. Then every run of 25 or more letters and digits left
+ * reads {session}, so an id after a dot segment, a backslash or an escape KOMOJU's frame never writes is
+ * masked as well; a percent escape right before the run stays when 25 or more remain after it. No other
+ * path KOMOJU's card fields use holds such a run. The whole run reads {session}, never only its last 25
+ * characters, so a longer id of another processor in the same text is never cut in two before that
+ * processor's mask reads it.
+ */
+const KOMOJU_HOST = /^komoju\.com\.?$/i;
+const KOMOJU_SESSION = new RegExp(`(${SLASH}sessions)(${SLASH}+)[^/]*`, 'gi');
+const KOMOJU_SESSION_ID = /(%(?:25)*[0-9a-f]{2})?[a-z0-9]{25,}/gi;
+function maskKomojuSession(path) {
+    return path.replace(KOMOJU_SESSION, '$1$2{session}').replace(KOMOJU_SESSION_ID, (_run, escape) => `${escape ?? ''}{session}`);
+}
+/**
+ * SumUp's Payment Widget sends the card to https://api.sumup.com/v0.2/checkouts/<checkout id> with no cookie and
+ * no auth header (payment-core sumup.js), so the checkout id is that request's only credential: with it anyone can
+ * read the checkout's amount and merchant and pay it. On api.sumup.com the segment after /checkouts/, in any case
+ * and any spelling of the slashes before it, reads {checkout}, as does any other id shaped like SumUp's UUID
+ * checkout ids, in every spelling maskUuids reads.
+ */
+const SUMUP_API_HOST = /^api\.sumup\.com\.?$/i;
+const SUMUP_CHECKOUT = new RegExp(`(${SLASH}checkouts${SLASH}+)[^/]*`, 'gi');
+function maskSumupCheckout(path) {
+    return maskUuids(path.replace(SUMUP_CHECKOUT, '$1{checkout}'), '{checkout}');
+}
 /**
  * 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 in a string that is not a URL, and the mask. The
- * guard in redact-url.test.mjs fails for a payment-core recognizer that no one has sorted into
- * this list or out of it.
+ * that send it, the text that names those hosts anywhere else (a string that is not a URL, or a
+ * path that carries a URL of its own), and the mask. The guard in redact-url.test.mjs fails for a
+ * payment-core recognizer that no one has sorted into this list or out of it.
  */
 /**
  * Redsys's hosted payment page names its session in the path of every page and post after the entry
  * (/sis/pagoTarjeta;jsessionid=<id>), and that id is what carries a card post into the session the
- * merchant's signed entry opened. On Redsys's hosts the session id, in any case or escaped, reads
- * {session}. The entry itself carries none.
+ * merchant's signed entry opened. On Redsys's hosts the session id, in any case or escaped once or more,
+ * reads {session}. The entry itself carries none.
  */
 const REDSYS_HOST = /^sis(?:-t)?\.redsys\.es\.?$/i;
-const REDSYS_SESSION = /((?:;|%3b)jsessionid(?:=|%3d))[^/?#;]*/gi;
+const REDSYS_SESSION = /((?:;|%(?:25)*3b)jsessionid(?:=|%(?:25)*3d))[^/?#;]*/gi;
 function maskRedsysSession(path) {
     return path.replace(REDSYS_SESSION, '$1{session}');
 }
@@ -1151,11 +1215,61 @@ function maskRedsysSession(path) {
  * segment after /orders/, in any case or after an escaped slash, reads {order}.
  */
 const PAYPAL_HOST = /(?:^|\.)paypal\.com\.?$/i;
-const PAYPAL_ORDER = /(\/orders(?:\/|%2f))[^/]*/gi;
+const PAYPAL_ORDER = new RegExp(`(${SLASH}orders${SLASH}+)[^/]*`, 'gi');
 function maskPaypalOrder(path) {
     return path.replace(PAYPAL_ORDER, '$1{order}');
 }
+/**
+ * Przelewy24's pay wall names its transaction by one token in the path of every page and post
+ * (/trnRequest/<token>, its method links, /card/p24form/<token>, /trnResult/<token>), and that token
+ * is all a browser needs to open the transaction's pay wall (payment-core processors/przelewy24.js).
+ * On Przelewy24's hosts a token-shaped segment, in any case, after an escaped slash or with its hyphens
+ * escaped, reads {token}.
+ */
+const PRZELEWY24_HOST = /(?:^|\.)przelewy24\.pl\.?$/i;
+const PRZELEWY24_TOKEN = new RegExp(`[0-9a-f]{10}${HYPHEN}[0-9a-f]{6}${HYPHEN}[0-9a-f]{6}${HYPHEN}[0-9a-f]{10}`, 'gi');
+function maskPrzelewy24Token(path) {
+    return path.replace(PRZELEWY24_TOKEN, '{token}');
+}
+/**
+ * Revolut's card field and card popup send the card payment to /api/public/orders/<order token>/payments on
+ * merchant.revolut.com (sandbox-merchant.revolut.com in test), and the frame polls /api/public/payments/<payment
+ * token> (payment-core revolut.js). Neither carries a header or cookie that binds it: the order token alone
+ * opens that order's checkout, its amount and its merchant, and pays it, and the payment token reads the payment.
+ * Revolut's hosted checkout page names the same order token in its own paths (/payment-link/<order token>), and the
+ * frame reads the order at merchant-mgmt.revolut.com/orders/token/<order token>. On those hosts every id of their
+ * uuid shape, in every spelling maskUuids reads, reads {token}.
+ */
+const REVOLUT_HOST = /^(?:sandbox-)?(?:merchant|checkout|merchant-mgmt)\.revolut\.com\.?$/i;
+function maskRevolutToken(path) {
+    return maskUuids(path, '{token}');
+}
+/**
+ * Paytrail names its payment in the path of every route of its card method
+ * (/payments/<transaction>/click-to-pay/loading-and-redirect, and its success and cancel routes), and the same id
+ * opens Paytrail's own payment wall for that payment (pay.paytrail.com/pay/<transaction>), its amount, its
+ * merchant and every method's form, to anyone who holds it (payment-core processors/paytrail.js). On every host
+ * Paytrail owns, any id of its shape, with or without its hyphens, in any case, after an escaped slash or with its
+ * hyphens escaped, reads {transaction}. Payment Highway, Paytrail's card platform, names its card page's session
+ * the same way (/form/<session>/pay_with_click_to_pay), and that path is what carries a card post into the payment,
+ * so on its hosts the same shape reads {session}. The pattern reads a percent escape as one unit and keeps it, so
+ * the hex digits of an escaped separator (%2F, %252F, %3D) never start an id and leave part of it showing.
+ */
+const PAYTRAIL_HOST = /(?:^|\.)paytrail\.com\.?$/i;
+const PAYMENT_HIGHWAY_HOST = /(?:^|\.)(?:paymenthighway\.io|sph-test-solinor\.com)\.?$/i;
+const PAYTRAIL_ID_HYPHEN = '(?:-|%(?:25)*2d)?';
+const PAYTRAIL_ID = new RegExp(`%(?:25)*[0-9a-f]{2}|[0-9a-f]{8}${PAYTRAIL_ID_HYPHEN}[0-9a-f]{4}${PAYTRAIL_ID_HYPHEN}[0-9a-f]{4}${PAYTRAIL_ID_HYPHEN}[0-9a-f]{4}${PAYTRAIL_ID_HYPHEN}[0-9a-f]{12}`, 'gi');
+function maskPaytrailId(path, label) {
+    return path.replace(PAYTRAIL_ID, (token) => (token.startsWith('%') ? token : label));
+}
+function maskPaytrailTransaction(path) {
+    return maskPaytrailId(path, '{transaction}');
+}
+function maskPaymentHighwaySession(path) {
+    return maskPaytrailId(path, '{session}');
+}
 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 },
     { host: GRAVY_HOST, named: /gr4vy\.app/i, mask: maskGravySession },
     { host: RAPYD_HOST, named: /rapyd\.net/i, mask: maskRapydToken },
@@ -1168,6 +1282,12 @@ const PATH_CREDENTIALS = [
     { host: PAYPAL_HOST, named: /paypal\.com/i, mask: maskPaypalOrder },
     { host: PAYMONGO_CHECKOUT_HOST, named: /checkout\.paymongo\.com/i, mask: maskPaymongoSession },
     { host: GOPAY_CARD_FORM_HOST, named: /secure(?:\.sandbox)?\.gopay\.com/i, mask: maskGopayToken },
+    { host: KOMOJU_HOST, named: /komoju\.com/i, mask: maskKomojuSession },
+    { host: PRZELEWY24_HOST, named: /przelewy24\.pl/i, mask: maskPrzelewy24Token },
+    { host: REVOLUT_HOST, named: /(?:merchant|checkout|merchant-mgmt)\.revolut\.com/i, mask: maskRevolutToken },
+    { host: SUMUP_API_HOST, named: /api\.sumup\.com/i, mask: maskSumupCheckout },
+    { host: PAYTRAIL_HOST, named: /paytrail\.com/i, mask: maskPaytrailTransaction },
+    { host: PAYMENT_HIGHWAY_HOST, named: /(?:paymenthighway\.io|sph-test-solinor\.com)/i, mask: maskPaymentHighwaySession },
 ];
 /**
  * A URL as it may appear in an error message: origin + path only. A paused
@@ -1192,30 +1312,51 @@ const PATH_CREDENTIALS = [
  * https://www.paypal.com/v2/checkout/orders/{order}/confirm-payment-source.
  * On PayMongo's checkout host the session id reads `{session}`: https://checkout.paymongo.com/{session}.
  * On GoPay's card frame hosts the card form's token reads `{token}`: https://secure.gopay.com/gp-card-comm/h/{token}.
+ * On komoju.com a session id reads `{session}`: https://komoju.com/api/v1/sessions/{session}/pay.
+ * On Przelewy24's hosts the transaction's token reads `{token}`:
+ * https://secure.przelewy24.pl/trnRequest/{token}.
+ * On Revolut's card payment and hosted checkout hosts an order or payment token reads `{token}`:
+ * https://merchant.revolut.com/api/public/orders/{token}/payments.
+ * On SumUp's API host a checkout id reads `{checkout}`: https://api.sumup.com/v0.2/checkouts/{checkout}.
+ * On Paytrail's hosts a payment's id reads `{transaction}`:
+ * https://services.paytrail.com/payments/{transaction}/click-to-pay/loading-and-redirect, and on Payment
+ * Highway's a card page's session reads `{session}`.
  * A string that is not a URL keeps the part before any `?` or `#`, with the
- * same segments masked.
+ * 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
+ * can read as a scheme: `see:https://api.stripe.com/...` parses as a URL with
+ * the scheme `see`, no host, and the whole Stripe URL as its path, so a parse
+ * with no host is read as a string that is not a URL. A path can carry a URL of
+ * its own, as `http:https://api.stripe.com/...` does once `https` reads as its
+ * host, so every processor whose host the path names masks the URL too.
  */
 export function redactUrl(raw) {
-    // An ACI checkout id is that checkout's only capability; it never rides on an event.
-    const aci = redactAciCheckoutId(raw);
-    if (aci !== null)
-        return aci;
+    let url;
     try {
-        const u = new URL(raw);
-        // A trailing dot names the same host, so it cannot let the secret through.
-        let path = PATH_SECRET_HOSTS.includes(u.hostname.replace(/\.$/, '')) ? u.pathname.replace(PATH_SECRET, '$1{client_secret}') : u.pathname;
-        for (const rule of PATH_CREDENTIALS)
-            if (rule.host.test(u.hostname))
-                path = rule.mask(path);
-        return `${u.origin}${path}`;
+        url = new URL(raw);
     }
     catch {
-        let bare = raw.split(/[?#]/)[0].replace(PATH_SECRET, '$1{client_secret}');
-        for (const rule of PATH_CREDENTIALS)
-            if (rule.named.test(bare))
-                bare = rule.mask(bare);
-        return bare;
+        url = null;
+    }
+    if (!url?.hostname) {
+        const text = raw.split(/[?#]/)[0];
+        return maskNamed(maskPathSecret(text), text);
     }
+    let path = url.pathname;
+    for (const rule of PATH_CREDENTIALS)
+        if (rule.host.test(url.hostname))
+            path = rule.mask(path);
+    return maskNamed(`${url.origin}${path}`, url.pathname);
+}
+/**
+ * `text` with the mask of every processor whose host `names` names. `names` is read before any mask
+ * runs, so a mask that rewrites another processor's host cannot keep that processor's mask from running.
+ */
+function maskNamed(text, names) {
+    for (const rule of PATH_CREDENTIALS)
+        if (rule.named.test(names))
+            text = rule.mask(text);
+    return text;
 }
 /**
  * Refusals a preparation create answers before any preparation exists, surfaced
@@ -2265,10 +2406,10 @@ export class VaultClient {
         // amount_required.
         if (!hasAmount && rec && AGENT_AMOUNT_PROCESSORS.includes(rec.psp))
             throw new AmountRequiredError(rec.psp);
-        // A Moneris token is charged later for whatever the merchant's server decides, and a Payfast pay
-        // charges the total its payment already holds, so a zero pair would show the cardholder no price
-        // at all: it is refused like a missing one.
-        if (hasAmount && rec && (rec.psp === MONERIS_PSP || rec.psp === PAYFAST_PSP) && Number(input.amount) <= 0)
+        // A Moneris token is charged later for whatever the merchant's server decides, and a Payfast pay or a
+        // PayMongo attach charges the total its payment or checkout session already holds, so a zero pair
+        // would show the cardholder no price at all: it is refused like a missing one.
+        if (hasAmount && rec && (rec.psp === MONERIS_PSP || rec.psp === PAYFAST_PSP || rec.psp === PAYMONGO_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

package/dist/datatrans.d.ts

@@ -69,8 +69,8 @@ export interface DatatransRepeatAnswer {
  * The approved Datatrans answers one attachment handed to a card post, per frame. `frame` is the
  * adapter's identity for the request's frame (the CDP frameId, the Playwright Frame); a request
  * whose frame is unknown is never remembered and never answered. Only an answer payment-core reads
- * as approved ({transactionId, cardInfo}) is kept: an error answer leaves the next post a new
- * question, so the page can try again.
+ * as approved (the token, with cardInfo when Datatrans sends one) is kept: an error answer leaves
+ * the next post a new question, so the page can try again.
  */
 export declare class DatatransRepeats {
     private readonly windowMs;

package/dist/datatrans.generated.js

@@ -1,6 +1,6 @@
 // @ts-nocheck
 // Generated from @agent-cards/payment-core. Do not edit.
-// artifact-sha256: 9c00d227ed43d3b5346dba02fe0431f4cc4762fc7d2d9333eeeb34233b0c9844
+// artifact-sha256: 829167e03a7ffe9fc109ababe9755f1263a840fd5294ebec970e08d41aa9741b
 // src/datatrans.js
 var DATATRANS_HOSTS = Object.freeze(["pay.datatrans.com", "pay.sandbox.datatrans.com"]);
 var DATATRANS_TOKENIZE_PATH = "/upp/payment/SecureFields/paymentField";
@@ -346,7 +346,7 @@ function injectDatatransCard(body, card, policy = DATATRANS_REGISTRATION_POLICY)
 var TRANSACTION_ID = /^[0-9]{18}$/;
 var CARD_WORD = /^[A-Za-z][A-Za-z _-]{0,31}$/;
 var COUNTRY = /^[A-Z]{2}$/;
-var CARD_INFO_KEYS = ["brand", "type", "usage", "country", "issuer", "coBrand"];
+var CARD_INFO_KEYS = ["brand", "type", "usage", "country", "issuer", "coBrand", "accountType", "binLength"];
 var UNFOLLOWED_KEYS = ["tds2EnrollmentResult", "redirect", "dcc", "mcp"];
 var ERROR_CODES = [
     [/^Invalid merchantId$/, "invalid_merchant_id"],
@@ -368,10 +368,11 @@ function readAnswer(body) {
     }
 }
 var optionalText = (value, pattern) => value === null || exact(pattern, value);
+var optionalBinLength = (value) => value === null || Number.isInteger(value) && value >= 1 && value <= 19;
 function rebuildCardInfo(info) {
-    if (!record(info) || !Object.keys(info).every((key) => CARD_INFO_KEYS.includes(key)) || !exact(CARD_WORD, info.brand))
+    if (!record(info) || !Object.keys(info).every((key) => CARD_INFO_KEYS.includes(key)))
         return null;
-    if (owns(info, "type") && !optionalText(info.type, CARD_WORD) || owns(info, "usage") && !optionalText(info.usage, CARD_WORD) || owns(info, "country") && !optionalText(info.country, COUNTRY) || owns(info, "issuer") && info.issuer !== null && !plain(info.issuer, 128) || owns(info, "coBrand") && info.coBrand !== null && !plain(info.coBrand, 64))
+    if (owns(info, "brand") && !optionalText(info.brand, CARD_WORD) || owns(info, "type") && !optionalText(info.type, CARD_WORD) || owns(info, "usage") && !optionalText(info.usage, CARD_WORD) || owns(info, "country") && !optionalText(info.country, COUNTRY) || owns(info, "issuer") && info.issuer !== null && !plain(info.issuer, 128) || owns(info, "coBrand") && info.coBrand !== null && !plain(info.coBrand, 64) || owns(info, "accountType") && !optionalText(info.accountType, CARD_WORD) || owns(info, "binLength") && !optionalBinLength(info.binLength))
         return null;
     const safe = {};
     for (const key of CARD_INFO_KEYS)
@@ -380,10 +381,14 @@ function rebuildCardInfo(info) {
     return safe;
 }
 function rebuildSuccess(value) {
-    if (Object.keys(value).length !== 2 || !exact(TRANSACTION_ID, value.transactionId))
-        return null;
+    if (!Object.keys(value).every((key) => key === "transactionId" || key === "cardInfo"))
+        return { reason: "datatrans_unexpected_key" };
+    if (!exact(TRANSACTION_ID, value.transactionId))
+        return { reason: "datatrans_unexpected_token" };
+    if (!owns(value, "cardInfo") || value.cardInfo === null)
+        return { answer: { transactionId: value.transactionId } };
     const cardInfo = rebuildCardInfo(value.cardInfo);
-    return cardInfo ? { transactionId: value.transactionId, cardInfo } : null;
+    return cardInfo ? { answer: { transactionId: value.transactionId, cardInfo } } : { reason: "datatrans_unexpected_card_info" };
 }
 function rebuildError(value) {
     return Object.keys(value).length === 1 && plain(value.error, 256) && value.error.trim() !== "" ? { error: value.error } : null;
@@ -407,15 +412,15 @@ function datatransResponseOutcome(status, body, card) {
     if (owns(value, "error")) {
         const error = rebuildError(value);
         if (!error)
-            return { outcome: "unknown", reason: "datatrans_unexpected_response" };
+            return { outcome: "unknown", reason: "datatrans_unexpected_error" };
         const code = datatransErrorCode(error.error);
         return code === "too_many_requests" ? { outcome: "unknown", reason: "datatrans_repeat_request" } : { outcome: "refused", code };
     }
     if (UNFOLLOWED_KEYS.some((key) => owns(value, key)))
         return { outcome: "unknown", reason: "datatrans_unsupported_flow" };
-    const safe = rebuildSuccess(value);
+    const { answer: safe, reason } = rebuildSuccess(value);
     if (!safe)
-        return { outcome: "unknown", reason: "datatrans_unexpected_response" };
+        return { outcome: "unknown", reason };
     if (card && digits(card.number, 12, 19) && safe.transactionId.includes(card.number)) {
         return { outcome: "unknown", reason: "datatrans_token_mismatch" };
     }
@@ -432,7 +437,7 @@ function sanitizeDatatransTokenResponse(body) {
         return JSON.stringify(rebuildError(value) ?? fail());
     if (UNFOLLOWED_KEYS.some((key) => owns(value, key)))
         return fail();
-    return JSON.stringify(rebuildSuccess(value) ?? fail());
+    return JSON.stringify(rebuildSuccess(value).answer ?? fail());
 }
 function datatransFacts(status, body) {
     const verdict = datatransResponseOutcome(status, body);

package/dist/datatrans.js

@@ -112,8 +112,8 @@ function sameKey(a, b) {
  * The approved Datatrans answers one attachment handed to a card post, per frame. `frame` is the
  * adapter's identity for the request's frame (the CDP frameId, the Playwright Frame); a request
  * whose frame is unknown is never remembered and never answered. Only an answer payment-core reads
- * as approved ({transactionId, cardInfo}) is kept: an error answer leaves the next post a new
- * question, so the page can try again.
+ * as approved (the token, with cardInfo when Datatrans sends one) is kept: an error answer leaves
+ * the next post a new question, so the page can try again.
  */
 export class DatatransRepeats {
     windowMs;

package/dist/pelecard.generated.d.ts

@@ -1,6 +1,7 @@
 declare var PELECARD_TRANSACTION_HOSTS: readonly string[];
 declare var PELECARD_TRANSACTION_PATH: string;
 declare var PELECARD_REFUSAL_REASONS: readonly string[];
+declare var PELECARD_SUCCESS_CODES: readonly string[];
 declare function isPelecardTransactionUrl(url: any, method?: string): boolean;
 declare function pelecardBodyRefusal(body: any): "unsupported" | "keep_on_file" | null;
 declare function isPelecardNewCardBody(body: any): boolean;
@@ -29,4 +30,4 @@ declare function pelecardFacts(status: any, body: any): {
     outcome: string;
     refusalCode: any;
 };
-export { PELECARD_REFUSAL_REASONS, PELECARD_TRANSACTION_HOSTS, PELECARD_TRANSACTION_PATH, classifyPelecardRequest, injectPelecardCard, isPelecardNewCardBody, isPelecardTransactionRequest, isPelecardTransactionUrl, pelecardBodyRefusal, pelecardFacts, pelecardKeepOnFileRequested, pelecardRefusalMessage, pelecardResponseOutcome, pelecardTransactionRefusal, sanitizePelecardResponse };
+export { PELECARD_REFUSAL_REASONS, PELECARD_SUCCESS_CODES, PELECARD_TRANSACTION_HOSTS, PELECARD_TRANSACTION_PATH, classifyPelecardRequest, injectPelecardCard, isPelecardNewCardBody, isPelecardTransactionRequest, isPelecardTransactionUrl, pelecardBodyRefusal, pelecardFacts, pelecardKeepOnFileRequested, pelecardRefusalMessage, pelecardResponseOutcome, pelecardTransactionRefusal, sanitizePelecardResponse };