@agent-cards/sdk 0.23.18 → 0.23.20

package/dist/client.d.ts

@@ -257,6 +257,28 @@ export declare const SUPPORTED_REGISTRY_FEATURES: readonly string[];
  * 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.
+ *
+ * `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
+ * sends the card to HiPay directly and the frame gets back HiPay's token. The number-only post
+ * the frame sends while the number is typed, and its /update once it holds a token, fail in the
+ * browser (pre-claim.ts hipayPreClaim). Served on the same terms: only to a build that lists it,
+ * for a company Agentcard turned HiPay on for.
+ *
+ * `twoc2p_secure_pay`: the Payment 2C2P's hosted payment page posts to its payment API
+ * (pgwv4.2c2p.com), carrying the card only as one field the page encrypts under 2C2P's static
+ * key. This build pauses it and writes over the placeholder's field the one the cardholder's
+ * device wrote under the key payment-core pins (twoc2p.ts), into that Payment alone; 3-D Secure
+ * then runs in the agent's browser. Served only to a build that lists it, and only for Agentcard's
+ * proof company, whatever the API's processor lists name: the field is the card under 2C2P's one
+ * static key, which any 2C2P merchant could charge.
+ *
+ * `quickpay_hosted_payment_page`: QuickPay's hosted payment window, whose card-free signed entry
+ * this build pauses for the cardholder's device and whose card post, fee lookup, wallet post, 3-D
+ * Secure step and card lookup this build never lets the agent's browser send (pre-claim.ts,
+ * quickpay.ts). Served on the same terms as NMI's and Redsys's: only to a build that lists it, for a
+ * company Agentcard turned QuickPay on for.
  */
 export declare const SUPPORTED_CAPABILITIES: readonly string[];
 /**
@@ -1187,8 +1209,24 @@ export declare class CheckoutAuthError extends Error {
  * 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}`.
+ * On 2C2P's page hosts everything after the build's folder reads `{token}`:
+ * 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.
  * 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 {
@@ -1231,8 +1269,8 @@ export interface VaultClientOptions {
     /**
      * The voice module: how this product approves purchases by voice, named
      * once per business, with the Vault return link and the verifier address
-     * beside it. Leave it out for a client that approves no purchase by voice;
-     * `agentcard.voice.*` then throws `missing_approval_posture`. See `VoiceOptions`.
+     * beside it. Leave it out and the client approves on Agentcard's page
+     * (`approval: 'sheet'`). See `VoiceOptions`.
      */
     voice?: VoiceOptions;
     /**
@@ -1297,8 +1335,8 @@ export declare class VaultClient {
     /**
      * Approve purchases by voice inside your own product: connect a person once,
      * create the purchase, ask for the key word, read the result. Same
-     * credentials, same token as the checkout calls. Needs `voice: { approval }`
-     * at construction; without it every verb throws `missing_approval_posture`.
+     * credentials, same token as the checkout calls. Approves on Agentcard's
+     * page unless `voice: { approval: 'in_app' }` was named at construction.
      */
     readonly voice: VoiceModule;
     /**

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';
@@ -16,7 +16,9 @@ import { SHIJI_STS_CAPABILITY, SHIJI_STS_PSP, isShijiStsServedCompanion, isShiji
 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 { classifyStripeCheckoutRequest, encodeStripeCheckoutContext, hasStripeCheckoutMarker, parseStripeCheckoutContext, parseStripeCheckoutResponse, STRIPE_CHECKOUT_CONTEXT_HEADER, } from './stripe-checkout.generated.js';
 import { VoiceModule } from './voice.js';
 import { BuyModule } from './buy.js';
@@ -241,9 +243,31 @@ export const SUPPORTED_REGISTRY_FEATURES = ['card_fields', 'checkout_sessions'];
  * 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.
+ *
+ * `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
+ * sends the card to HiPay directly and the frame gets back HiPay's token. The number-only post
+ * the frame sends while the number is typed, and its /update once it holds a token, fail in the
+ * browser (pre-claim.ts hipayPreClaim). Served on the same terms: only to a build that lists it,
+ * for a company Agentcard turned HiPay on for.
+ *
+ * `twoc2p_secure_pay`: the Payment 2C2P's hosted payment page posts to its payment API
+ * (pgwv4.2c2p.com), carrying the card only as one field the page encrypts under 2C2P's static
+ * key. This build pauses it and writes over the placeholder's field the one the cardholder's
+ * device wrote under the key payment-core pins (twoc2p.ts), into that Payment alone; 3-D Secure
+ * then runs in the agent's browser. Served only to a build that lists it, and only for Agentcard's
+ * proof company, whatever the API's processor lists name: the field is the card under 2C2P's one
+ * static key, which any 2C2P merchant could charge.
+ *
+ * `quickpay_hosted_payment_page`: QuickPay's hosted payment window, whose card-free signed entry
+ * this build pauses for the cardholder's device and whose card post, fee lookup, wallet post, 3-D
+ * Secure step and card lookup this build never lets the agent's browser send (pre-claim.ts,
+ * quickpay.ts). Served on the same terms as NMI's and Redsys's: only to a build that lists it, for a
+ * company Agentcard turned QuickPay 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, 'paymongo_checkout_pay'];
+    'redsys_hosted_payment_page', 'lyra_krypton_payment', 'payfast_card_pay', WIX_PAYMENTS_CAPABILITY, 'paymongo_checkout_pay', HIPAY_CAPABILITY, TWOC2P_CAPABILITY, 'quickpay_hosted_payment_page'];
 /**
  * Processors whose paused request names no amount at all, so the pair the
  * agent passes is the amount the cardholder approves: authorize() refuses one
@@ -275,15 +299,20 @@ export const SUPPORTED_CAPABILITIES = ['fiserv_card_capture', GMO_CAPABILITY, CY
  * 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.
+ * own page shows. 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.
+ * 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.
  */
 const MONERIS_PSP = 'moneris';
 const PAYFAST_PSP = 'payfast';
 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];
+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, HIPAY_PSP, TWOC2P_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', [PAYMONGO_PSP]: 'PayMongo' };
+    [SECURE_ACCEPTANCE_PSP]: 'CyberSource Secure Acceptance', [MONERIS_PSP]: 'Moneris', [PADDLE_VGS_PSP]: 'Paddle', [PAYFAST_PSP]: 'Payfast', [WIX_PAYMENTS_PSP]: 'Wix', [PAYMONGO_PSP]: 'PayMongo', [HIPAY_PSP]: 'HiPay', [TWOC2P_PSP]: '2C2P' };
 /**
  * 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
@@ -1041,9 +1070,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'];
+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
@@ -1084,10 +1116,11 @@ 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 = new RegExp(`(${SLASH}v1${SLASH}checkouts${SLASH}+)[^/]*`, 'gi');
@@ -1162,21 +1195,36 @@ function maskGopayToken(path) {
  * 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 any 25 letters and digits left that end a run read
- * {session} too, so an id after a dot segment, a backslash or an escape KOMOJU's frame never writes is
- * masked as well; no other path KOMOJU's card fields use holds such a run.
+ * 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 = /[a-z0-9]{25}(?![a-z0-9])/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, '{session}');
+    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
@@ -1212,7 +1260,107 @@ const PRZELEWY24_TOKEN = new RegExp(`[0-9a-f]{10}${HYPHEN}[0-9a-f]{6}${HYPHEN}[0
 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}');
+}
+/**
+ * 2C2P's hosted payment page names its payment token in its hash routes (pgw-ui.2c2p.com/payment/<build>/#/token/
+ * <token>, #/info/<token>, #/mobile/process/<token>), and the token is all a browser needs to open that payment's page
+ * (payment-core twoc2p.js). redactUrl drops a fragment, but a URL whose `#` was escaped carries the route in its path,
+ * and then in any spelling: escaped or doubled separators, escaped letters, parameters. Nothing past the build's folder
+ * on 2C2P's page hosts is worth a log line, so everything after `/payment/<build>/`, its separators in any spelling
+ * SLASH reads, reads {token}, and on any other path everything after its first separator. A string that is not a URL
+ * is cut the same way after a whole page-host authority it names (at the start, or after a space, a quote, a bracket,
+ * a colon such as a `see:` before it, a comma, a semicolon, an equals sign or `//`, and followed by a path, a port or
+ * the end), and only up to the end of that URL, so the message's own words,
+ * another site's path naming the host and a lookalike host stay; a text naming several such URLs has each one cut.
+ * Anchored matches and cuts in one pass: no input makes it backtrack.
+ */
+const TWOC2P_PAGE_HOST = /^(?:sandbox-)?pgw-ui\.2c2p\.com\.?$/i;
+const TWOC2P_PAGE_FOLDER = new RegExp(`^${SLASH}payment${SLASH}4\\.[0-9]{1,2}${SLASH}`, 'i');
+const TWOC2P_FIRST_SEPARATOR = new RegExp(`^${SLASH}`, 'i');
+const TWOC2P_PAGE_AUTHORITY = `(?:^|[\\s"'(<\\[:,;=]|//)(?:sandbox-)?pgw-ui\\.2c2p\\.com\\.?(?::[0-9]{1,5})?(?=${SLASH}|$)`;
+/** One page path, from its first separator: the build's folder stays and the rest reads {token}. */
+function maskTwoC2pPath(path) {
+    const kept = TWOC2P_PAGE_FOLDER.exec(path) ?? TWOC2P_FIRST_SEPARATOR.exec(path);
+    const end = kept ? kept[0].length : 0;
+    return path.length > end ? `${path.slice(0, end)}{token}` : path;
+}
+/**
+ * Text that is not a URL: every whole page-host authority it names, each URL cut only to its own end (the first
+ * space, quote or bracket), so the words between and after them stay. A text that starts with a slash is read the
+ * same way, so another site's protocol-relative URL that names the host keeps its own host and path.
+ */
+function maskTwoC2pToken(path) {
+    const authority = new RegExp(TWOC2P_PAGE_AUTHORITY, 'gi');
+    // A closing bracket or parenthesis ends the URL only when no path or token character follows it, so a URL
+    // a message wraps in [] or () keeps the words after it, and a bracket inside the path still cannot end the cut early.
+    const urlEnd = /[\s"'<>]|[\])](?![A-Za-z0-9+/=%\\])/g;
+    let out = '';
+    let done = 0;
+    for (let host = authority.exec(path); host !== null; host = authority.exec(path)) {
+        const start = host.index + host[0].length;
+        urlEnd.lastIndex = start;
+        const stop = urlEnd.exec(path);
+        const end = stop ? stop.index : path.length;
+        out += path.slice(done, start) + maskTwoC2pPath(path.slice(start, end));
+        done = end;
+        authority.lastIndex = end;
+    }
+    return out + path.slice(done);
+}
+/**
+ * QuickPay's window names its session as the first segment of its own path (/<32 hex>, then /3ds_auth or
+ * /poll-response), and that id is what carries a card post into the payment the merchant's signed entry
+ * opened; a payment link's id (/payments/<64 hex>) opens one the same way. On QuickPay's host a run of 32 hex
+ * digits or more after a slash, in any case or escaped, reads {session} whatever follows it: a URL parser drops a
+ * newline after the URL, so words after it can run on into the id. The entry, the host's root, carries none.
+ */
+const QUICKPAY_HOST = /^payment\.quickpay\.net\.?$/i;
+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.
+ */
 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 },
@@ -1227,6 +1375,12 @@ const PATH_CREDENTIALS = [
     { 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 },
+    { host: TWOC2P_PAGE_HOST, named: /pgw-ui\.2c2p\.com/i, mask: maskTwoC2pToken, pathMask: maskTwoC2pPath },
+    { host: QUICKPAY_HOST, named: /quickpay\.net/i, mask: maskQuickpaySession },
 ];
 /**
  * A URL as it may appear in an error message: origin + path only. A paused
@@ -1254,30 +1408,52 @@ const PATH_CREDENTIALS = [
  * 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}`.
+ * On 2C2P's page hosts everything after the build's folder reads `{token}`:
+ * 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.
  * 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.pathMask ?? 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
@@ -1350,6 +1526,16 @@ 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 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
+ * (`live_host_on_sandbox_row`, `sandbox_host_on_live_row`), a checkout's merchant is not the name the reviewed pin
+ * carries (`merchant_profile_mismatch`), and the price is zero (`amount_required`), since every create after it would be
+ * refused. An unreviewed origin answers `unsupported_checkout`, which PREPARATION_REFUSALS names for every checkout.
+ * Only for a HiPay checkout.
+ */
+const HIPAY_PREPARATION_REFUSALS = ['processor_unavailable', 'live_host_on_sandbox_row', 'sandbox_host_on_live_row', 'merchant_profile_mismatch',
+    'amount_required'];
 /**
  * The reason the cardholder's device declines a bound prepared row with, per processor, when its own
  * send boundary passed before the card left it (the Vault's sendWindow, 12 seconds after it last saw
@@ -1362,6 +1548,7 @@ const PREPARED_SEND_WINDOW_DECLINES = Object.freeze({
     amadeus_checkout: 'amadeus_send_window_closed',
     [SECURE_ACCEPTANCE_PSP]: 'secure_acceptance_send_window_closed',
     [WIX_PAYMENTS_PSP]: 'wix_payments_send_window_closed',
+    [HIPAY_PSP]: 'hipay_send_window_closed',
 });
 /**
  * Refusals a CyberSource Flex preparation that tokenizes before Pay answers (4xx) before any
@@ -1450,8 +1637,8 @@ export class VaultClient {
     /**
      * Approve purchases by voice inside your own product: connect a person once,
      * create the purchase, ask for the key word, read the result. Same
-     * credentials, same token as the checkout calls. Needs `voice: { approval }`
-     * at construction; without it every verb throws `missing_approval_posture`.
+     * credentials, same token as the checkout calls. Approves on Agentcard's
+     * page unless `voice: { approval: 'in_app' }` was named at construction.
      */
     voice;
     /**
@@ -1565,7 +1752,9 @@ export class VaultClient {
         // wspay_confirm, shiji_sts_pinned_key, amadeus_checkout_actions.v1,
         // worldline_mycheckout_form, verifone_card_capture, ekashu_hosted_payment_page,
         // cybersource_sa_token_create, gravy_session_fields_put,
-        // moneris_hosted_tokenization, paddle_vgs_cards, redsys_hosted_payment_page) and
+        // moneris_hosted_tokenization, paddle_vgs_cards, paddle_tokenex_pay,
+        // redsys_hosted_payment_page, lyra_krypton_payment, payfast_card_pay,
+        // quickpay_hosted_payment_page) and
         // the caller's company is one Agentcard turned that processor on for, so this
         // build arms Fiserv's card capture, GMO's getToken, CyberSource Flex's card
         // fields, Juspay's card flow, Datatrans's Secure Fields card post, the
@@ -2044,6 +2233,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 === 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')))
                 throw fail(error.code);
@@ -2327,10 +2517,11 @@ 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 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)
+        // A Moneris or a HiPay token is charged later for whatever the merchant's server decides, and a Payfast pay, a
+        // PayMongo attach or a 2C2P Payment charges the total its payment, checkout session or payment token
+        // 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 || rec.psp === HIPAY_PSP || rec.psp === TWOC2P_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
@@ -2476,8 +2667,11 @@ export class VaultClient {
         // and the API names 500 ms as such a row's poll interval.
         // A prepared Paddle VGS card request too, for 20 seconds: Paddle's frame aborts it 10 seconds after
         // Pay and sends it once more, and the API names 500 ms as such a row's poll interval.
+        // A prepared HiPay token create too, for 20 seconds: HiPay's hosted fields give it 20 seconds from Pay, so
+        // an answer the cardholder's device records late in that span still reaches the frame before it gives up,
+        // and the API names 500 ms as such a row's poll interval.
         const preparedFastPollUntil = preparation?.psp === 'mercado_pago' ? Date.now() + 10_000
-            : preparation?.psp === PADDLE_VGS_PSP ? Date.now() + 20_000
+            : preparation?.psp === PADDLE_VGS_PSP || preparation?.psp === HIPAY_PSP ? Date.now() + 20_000
                 : preparation?.psp === EPROTECT_PSP ? Date.now() + 15_000
                     : preparation?.psp === SECURE_ACCEPTANCE_PSP ? Date.now() + SECURE_ACCEPTANCE_FAST_POLL_MS : 0;
         // A preparation that tokenized before Pay: the cardholder's device already holds CyberSource's

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;