@agent-cards/sdk 0.23.20 → 0.23.21

package/dist/client.js

@@ -2,7 +2,11 @@ import { BUILTIN_REGISTRY, cardUrlPatterns as deriveCardUrlPatterns, LOOPBACK_UR
 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 { isHostedGetEntry } from './hosted-entry.js';
+import { TRANSBANK_CAPABILITY, TRANSBANK_PSP } from './transbank.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';
@@ -32,6 +36,7 @@ import { JUSPAY_CAPABILITY, JUSPAY_PSP, juspayPageAnswer } from './juspay-gate.j
 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';
@@ -228,6 +233,13 @@ export const SUPPORTED_REGISTRY_FEATURES = ['card_fields', 'checkout_sessions'];
  * checkout relay. Served on the same terms: only to a build that lists it, for a company
  * Agentcard turned Payfast on for.
  *
+ * `przelewy24_hosted_payment_page`: Przelewy24's pay wall, whose card-free link
+ * (secure.przelewy24.pl/trnRequest/<token>, a plain GET the merchant's redirect or script sends
+ * the buyer to) this build pauses for the cardholder's device by its exact link (hosted-entry.ts),
+ * and whose card method post, card form post and Saferpay resolver this build never lets the
+ * agent's browser send (pre-claim.ts, przelewy24.ts). Served on the same terms as NMI's and
+ * Redsys's: only to a build that lists it, for a company Agentcard turned Przelewy24 on for.
+ *
  * `wix_payments_tokenize`: the card request Wix Cashier's card frame sends to Wix's
  * tokenizer (cashier-pci.wixapps.net), only through a prepared checkout: Wix's payment
  * widget fails the payment 30 seconds after it asks the frame for a token. The
@@ -244,6 +256,15 @@ export const SUPPORTED_REGISTRY_FEATURES = ['card_fields', 'checkout_sessions'];
  * the checkout relay. Served on the same terms: only to a build that lists it, for a company
  * Agentcard turned PayMongo on for.
  *
+ * `gopay_card_form`: the card post GoPay's card frame sends to its own URL
+ * (secure.gopay.com/gp-card-comm/h/<token>) inside the GoPay gateway a shop opens. This build pauses
+ * only the frame's own card post and answers it with GoPay's answer as the API recorded it, the
+ * empty JSON object the frame reads; the gateway then reads the payment's end from GoPay and runs
+ * 3-D Secure in the agent's browser when the bank asks for it. The cardholder's device sends the card
+ * through the checkout relay. Served only to a build that lists it, and only for Agentcard's proof
+ * 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.
+ *
  * `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
@@ -265,9 +286,89 @@ export const SUPPORTED_REGISTRY_FEATURES = ['card_fields', 'checkout_sessions'];
  * 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.
+ *
+ * `revolut_card_field`: the card payment Revolut Business's card field or card popup sends from
+ * its frame to /api/public/orders/<order token>/payments on merchant.revolut.com, on a merchant's
+ * own page or Revolut's hosted checkout. This build pauses only the frame's card payment and
+ * answers it with Revolut's answer as the API recorded it: the payment Revolut created, which the
+ * frame then follows, through any 3-D Secure step, in the agent's browser. A payment by Apple Pay,
+ * Google Pay or Revolut Pay on the same URL carries no card and continues untouched. Revolut's
+ * host answers the Vault's origin, so the cardholder's device sends the card itself, with no relay.
+ * Served on the same terms: only to a build that lists it, for a company Agentcard turned Revolut
+ * on for.
+ *
+ * `pay_nl_card_token`: the card token request a shop's card form sends to Pay. (pay.nl),
+ * Weeztix's sandboxed frame posting its FormData to payment.pay.nl/v1/Payment/getCardToken/json.
+ * 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
+ * Agentcard turned Pay. on for.
+ *
+ * `paypal_card_fields`: PayPal Card Fields' confirm, the POST its v5 frame sends to
+ * www.paypal.com and its v6 frame to api-m.paypal.com. This build pauses it only in
+ * the frames' own shape, refuses one that asks PayPal to keep the card or forces
+ * 3-D Secure in the browser with a `blocked` event, and answers the frame with the
+ * order's id and status as the API recorded them. The device sends a v5 confirm
+ * through the checkout relay and a v6 one directly. Served on the same terms: only
+ * to a build that lists it, for a company Agentcard turned PayPal Card Fields on
+ * for. Every other company keeps the checkout guard's refusal (paypal-card-forms.ts).
+ *
+ * `comgate_hosted_payment_page`: ComGate's payment gateway, whose card-free gateway link
+ * (payN.comgate.cz/init?id=<transaction id>, a plain GET) this build pauses for the
+ * cardholder's device by its exact link (hosted-entry.ts), in the page, in a frame of it or
+ * in a window it opened, and whose card hosts this build never lets the agent's browser post
+ * to (pre-claim.ts, comgate.ts). Served on the same terms as NMI's and Redsys's: only to a
+ * build that lists it, for a company Agentcard turned ComGate on for.
+ *
+ * `makecommerce_card_frame`: the card post MakeCommerce's card frame sends to its own card endpoint
+ * (cc.maksekeskus.ee/card-payment) under the shop's publishable key. This build pauses only the
+ * frame's own one-time card payment and answers it with MakeCommerce's answer as the API recorded
+ * it: the URL of MakeCommerce's 3-D Secure page, which the frame then opens 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 MakeCommerce on for.
+ *
+ * `poynt_collect_nonce`: GoDaddy Payments' card request, the POST Poynt Collect's
+ * card frame sends to a store's generate-nonce on services.poynt.net. This build
+ * pauses it only as the frame writes it, refuses a body that asks Poynt to keep the
+ * card in the browser with a `blocked` event, and answers the frame with the nonce as
+ * the API recorded it. The 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
+ * GoDaddy Payments on for.
+ *
+ * `tokenex_iframe_tokenize`: the card post TokenEx's hosted iframe v3 sends from its card-number frame
+ * to its own document URL on htp.tokenex.com (JetBlue's card form). This build pauses only the PCI frame's
+ * own card post with its CVV frame, refuses in the browser every other post on that path that carries a
+ * card (tokenex-iframe.ts), answers it with TokenEx's token as the API recorded it, rebuilt from
+ * payment-core's allow-list, and answers the same frame's byte-identical repeat from that answer while the
+ * approval is being handed off. Served on the same terms: only to a build that lists it, for a company
+ * Agentcard turned the TokenEx iframe on for.
+ *
+ * `transbank_webpay_hosted_payment_page`: Transbank's Webpay Plus, whose card-free entry
+ * (webpay3g.transbank.cl/webpayserver/initTransaction?token_ws=<token>, the merchant's
+ * redirect, a plain GET) this build pauses for the cardholder's device by its exact link
+ * (hosted-entry.ts) in the page or a frame of it, and with attachToCdp also in a window the
+ * page opened, and whose hosts this build never lets the agent's browser post to (pre-claim.ts,
+ * transbank.ts), so the token is never spent there. attachToPlaywright covers the page it is
+ * attached to and that page's frames only, and pauses only a direct or scripted navigation to
+ * the entry: its page.route sees no HTTP redirect hop, so a merchant's redirect needs attachToCdp.
+ * Served on the same terms as NMI's and Redsys's: only to a build that lists it, for a company
+ * Agentcard turned Webpay on for.
+ *
+ * `sumup_checkout_process`: the card request SumUp's Payment Widget sends from its hidden form frame
+ * on gateway.sumup.com, a PUT to https://api.sumup.com/v0.2/checkouts/<checkout id>. This build pauses
+ * that PUT as it pauses Gravy's, so only the CDP and Playwright adapters see it (the form frame is
+ * cross-origin to the page), and answers the frame with SumUp's own answer as the API recorded it: the
+ * paid checkout, or the 3-D Secure step the widget then runs in the agent's browser. The cardholder's
+ * 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.
  */
 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', HIPAY_CAPABILITY, TWOC2P_CAPABILITY, 'quickpay_hosted_payment_page'];
+    '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'];
 /**
  * Processors whose paused request names no amount at all, so the pair the
  * agent passes is the amount the cardholder approves: authorize() refuses one
@@ -299,20 +400,68 @@ 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. 2C2P's Payment carries none either: the merchant bound the total to the
+ * 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).
+ * 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.
+ * 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.
  * 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.
+ * 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
+ * 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
+ * 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.
+ * 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
+ * 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.
+ * 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 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.
+ * 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),
+ * 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
+ * itself reports.
  */
 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, HIPAY_PSP, TWOC2P_PSP];
+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];
 /** 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', [HIPAY_PSP]: 'HiPay', [TWOC2P_PSP]: '2C2P' };
+    [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' };
 /**
  * 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
@@ -543,13 +692,18 @@ const PROCESSOR_PLACEHOLDER_NUMBERS = Object.freeze({});
 /**
  * The placeholder number for a network (lowercase, as GET /api/v2/vault_cards names it) on a
  * processor's page: the processor's own number for that network when `overrides` names one, else
- * the network's default, else undefined for a network with no placeholder.
+ * the network's default, else undefined for a network with no placeholder. On a TokenEx iframe
+ * (`tokenex_iframe`) the number must also be one TokenEx's frame reads as that network, since the frame
+ * names the brand to the page from the typed digits and the cardholder's device refuses a mismatch: the
+ * frame's table takes Visa, Mastercard and American Express, so every other network gets undefined.
  */
 export function placeholderNumber(brand, psp, overrides = PROCESSOR_PLACEHOLDER_NUMBERS) {
     const own = psp !== undefined && Object.prototype.hasOwnProperty.call(overrides, psp) ? overrides[psp] : undefined;
-    if (own && Object.prototype.hasOwnProperty.call(own, brand))
-        return own[brand];
-    return Object.prototype.hasOwnProperty.call(PLACEHOLDER_NUMBERS, brand) ? PLACEHOLDER_NUMBERS[brand] : undefined;
+    const number = own && Object.prototype.hasOwnProperty.call(own, brand) ? own[brand]
+        : Object.prototype.hasOwnProperty.call(PLACEHOLDER_NUMBERS, brand) ? PLACEHOLDER_NUMBERS[brand] : undefined;
+    if (number !== undefined && psp === TOKENEX_IFRAME_PSP && !tokenexIframePlaceholderFits(brand, number))
+        return undefined;
+    return number;
 }
 /**
  * The recognizer says this processor is preparation-required, and no preparation
@@ -575,7 +729,9 @@ export class PreparationRequiredError extends Error {
  * when the merchant's server created the payment), so the `amount` and
  * `currency` you pass are what the cardholder approves, and for WSPay the
  * figure the API compares with WSPay's answer when that answer names one (a
- * 3-D Secure step names none). Thrown locally before any create or
+ * 3-D Secure step names none). A Revolut card payment names the order's
+ * amount but not its currency, so it takes the same pair, above zero.
+ * Thrown locally before any create or
  * prompt, and terminal: the same request without an amount fails the same
  * way. The API answers 400 amount_required for the same case. A page total
  * (`pageAmount`) does not count.
@@ -585,7 +741,8 @@ export class AmountRequiredError extends Error {
     code = 'amount_required';
     constructor(psp) {
         const processor = PROCESSOR_NAMES[psp] ?? psp;
-        super(`A ${processor} payment request names no amount, so pass amount and currency: that is the amount the cardholder approves. Nothing was created and nothing was charged.`);
+        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.`);
         this.psp = psp;
         this.name = 'AmountRequiredError';
     }
@@ -1183,12 +1340,19 @@ function maskPaymongoSession(path) {
  * https://secure.gopay.com/gp-card-comm/h/<hex token>?lang=..&ver=..&SG=<64 hex> (payment-core gopay.js). The
  * token names that payment's card form, and with the SG, which redactUrl drops with the query, anyone who holds
  * the URL can open the form and post a card to it. On GoPay's two card frame hosts the segment after /h/, in any
- * case or after an escaped slash, reads {token}: https://secure.gopay.com/gp-card-comm/h/{token}.
+ * case or after an escaped slash, reads {token}: https://secure.gopay.com/gp-card-comm/h/{token}. Then every run of
+ * 16 or more hex digits left reads {token} too, so a token after a path the frame never writes (an escaped h, a
+ * path parameter) is masked as well; the token is 16 hex digits or more, and no other path the card frame uses holds
+ * such a run. The pattern reads a percent escape as one unit: an escaped hex digit (%61, %2561) counts toward a run,
+ * so escaping some of a token's digits never splits it into runs that show, and any other escape (%2F, %252F, %68)
+ * is kept whole, so its own hex digits never start a run and leave part of a token showing.
  */
 const GOPAY_CARD_FORM_HOST = /^secure(?:\.sandbox)?\.gopay\.com\.?$/i;
 const GOPAY_CARD_FORM_TOKEN = new RegExp(`(${SLASH}h${SLASH}+)[^/?#]*`, 'gi');
+const GOPAY_TOKEN_RUN = /(?:[0-9a-f]|%(?:25)*(?:3[0-9]|[46][1-6])){16,}|%(?:25)*[0-9a-f]{2}/gi;
+const GOPAY_LONE_ESCAPE = /^%(?:25)*[0-9a-f]{2}$/i;
 function maskGopayToken(path) {
-    return path.replace(GOPAY_CARD_FORM_TOKEN, '$1{token}');
+    return path.replace(GOPAY_CARD_FORM_TOKEN, '$1{token}').replace(GOPAY_TOKEN_RUN, (run) => (GOPAY_LONE_ESCAPE.test(run) ? run : '{token}'));
 }
 /**
  * KOMOJU's Hosted Fields frame pays a session with POST /api/v1/sessions/<id>/pay on komoju.com under
@@ -1273,6 +1437,18 @@ const REVOLUT_HOST = /^(?:sandbox-)?(?:merchant|checkout|merchant-mgmt)\.revolut
 function maskRevolutToken(path) {
     return maskUuids(path, '{token}');
 }
+/**
+ * ComGate's gateway pages name the payment by its transaction id in their paths (pay1.comgate.cz/<id>,
+ * /specify/card2/<id>, payment-core processors/comgate.js), and the id alone opens that payment's gateway page, its
+ * amount and its merchant. Its entry link names the id in the query, which redactUrl drops. On every host ComGate
+ * owns, any id of its shape, in any case and with each hyphen in any spelling HYPHEN reads, reads {payment}. The
+ * pattern reads a percent escape as one unit and keeps it, as maskUuids does.
+ */
+const COMGATE_HOST = /(?:^|\.)comgate\.cz\.?$/i;
+const COMGATE_ID = new RegExp(`%(?:25)*[0-9a-f]{2}|[a-z0-9]{4}${HYPHEN}[a-z0-9]{4}${HYPHEN}[a-z0-9]{4}`, 'gi');
+function maskComgateId(path) {
+    return path.replace(COMGATE_ID, (token) => (token.startsWith('%') ? token : '{payment}'));
+}
 /**
  * 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
@@ -1377,6 +1553,7 @@ const PATH_CREDENTIALS = [
     { 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: COMGATE_HOST, named: /comgate\.cz/i, mask: maskComgateId },
     { 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 },
@@ -1754,7 +1931,7 @@ export class VaultClient {
         // cybersource_sa_token_create, gravy_session_fields_put,
         // moneris_hosted_tokenization, paddle_vgs_cards, paddle_tokenex_pay,
         // redsys_hosted_payment_page, lyra_krypton_payment, payfast_card_pay,
-        // quickpay_hosted_payment_page) and
+        // quickpay_hosted_payment_page, tokenex_iframe_tokenize, among others) 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
@@ -1948,7 +2125,9 @@ export class VaultClient {
      * The facts hold only while the cardholder pays with that card. `psp` names the processor
      * whose card form the agent types into (the recognizer's name, `worldline_mycheckout`): a
      * processor that needs its own number for the card's network gets it, and every other gets the
-     * network's default. Throws PlaceholderCardError when there is no such card, its network has no
+     * network's default. On a TokenEx iframe (`tokenex_iframe`, JetBlue) the number is one TokenEx's frame
+     * reads as the card's own network, Visa, Mastercard or American Express, and any other network has no
+     * placeholder there. Throws PlaceholderCardError when there is no such card, its network has no
      * placeholder, or it carries no expiry.
      */
     async placeholderCard(input) {
@@ -2488,10 +2667,14 @@ 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 one: Worldpay
-        // eProtect's registration exactly as payment-core admits it, with no body.
+        // 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.
         const eprotect = rec?.psp === EPROTECT_PSP;
-        if (cardMethod === 'GET' && !(eprotect && isEprotectRegistration(input.request))) {
+        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) {
             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
@@ -2517,11 +2700,26 @@ export class VaultClient {
         // amount_required.
         if (!hasAmount && rec && AGENT_AMOUNT_PROCESSORS.includes(rec.psp))
             throw new AmountRequiredError(rec.psp);
-        // 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)
+        // A Przelewy24 pay wall charges the amount the merchant's server registered with Przelewy24 under the link's
+        // token, so a zero pair would show the cardholder no price at all: it is refused like a missing one.
+        // A Moneris, a HiPay or a Pay. token, or a GoDaddy Payments nonce, is charged later for whatever the merchant's
+        // server decides, a Payfast pay, a PayMongo attach, a 2C2P Payment, a Revolut card payment or a SumUp card request
+        // charges the total its payment, checkout session, payment token, order or checkout already holds, and a PayPal
+        // order's amount was fixed by the merchant's server and never shown in the confirm, and a GoPay card post charges
+        // 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.
+        // 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)
             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
@@ -3039,6 +3237,18 @@ export class VaultClient {
                         response.headers = answer.headers;
                         response.body = answer.body;
                     }
+                    if (rec?.psp === TOKENEX_IFRAME_PSP) {
+                        // TokenEx's answer enters the frame only as TokenEx's 200 with a sound token, rebuilt from payment-core's
+                        // allow-list under a JSON content type (tokenex-iframe.ts tokenexIframePageAnswer); the frame adds its own
+                        // cardType. Anything else is never handed over: the device may already have sent the card, so the
+                        // outcome is unknown rather than declined.
+                        const answer = tokenexIframePageAnswer(response.status, response.body);
+                        if (!answer)
+                            throw new PaymentOutcomeUnknownError(authorizationId, 'tokenex_iframe_token_unconfirmed');
+                        response.status = answer.status;
+                        response.headers = answer.headers;
+                        response.body = answer.body;
+                    }
                     let processorContext;
                     if (mercadoContext) {
                         try {

package/dist/comgate.d.ts

@@ -0,0 +1,50 @@
+/**
+ * ComGate's payment gateway (pay1 to pay4.comgate.cz, where most Czech and Slovak e-shops send the buyer), as this
+ * SDK reads it.
+ *
+ * The merchant's server creates the payment at ComGate and sends the buyer's browser to the gateway link ComGate
+ * answered with, https://payN.comgate.cz/init?id=<transaction id>, by a redirect or by setting the page's or a
+ * frame's location. That GET carries no card and nothing but the payment's id, and it is the one request a build
+ * that declares ComGate's capability pauses for ComGate (hosted-entry.ts): the cardholder's device then makes the
+ * gateway's own calls for that payment over the end-to-end TLS relay (payment-core processors/comgate.js). Only the
+ * link exactly as ComGate writes it is the entry; any other parameter would be handed on to the gateway's own
+ * route, which these rules never see.
+ *
+ * COMGATE_GATEWAY_HOSTS is payment-core's COMGATE_GATEWAY_HOSTS, and isComgateEntryUrl is payment-core's rule of
+ * the same name; hosted-entry.test.mjs pins both to payment-core on every case payment-core's own tests list.
+ */
+export declare const COMGATE_PSP = "comgate";
+/** The dark-launch capability the API serves ComGate's recognizer behind (payment-core definitions.js). */
+export declare const COMGATE_CAPABILITY = "comgate_hosted_payment_page";
+/** The four gateway hosts ComGate's create answer names, each a host of its own entry. */
+export declare const COMGATE_GATEWAY_HOSTS: readonly string[];
+/**
+ * The hosts that take a card, or part of one, for ComGate: the gateway's API (payments.comgate.cz behind pay1 and pay2,
+ * payments-gcp.comgate.cz behind pay3 and pay4), where the gateway posts the card (/client/instructions/card-process,
+ * check-card) and ComGate's Web Checkout SDK posts its own (/checkout/provider/*, /checkout/card/check-card), and the
+ * card frames' hosts (sec.comgate.cz, sec-gcp.comgate.cz), which post the card's first digits to their /bin-checker.
+ * The card is already encrypted in ComGate's frame by then, so no body rule could see it: once ComGate is served, this
+ * build fails every request to these hosts but a GET, so the card the agent typed never reaches ComGate.
+ */
+export declare const COMGATE_CARD_HOSTS: readonly string[];
+/** The Fetch.enable globs attachToCdp arms for the card hosts, only while ComGate is served (cdp.ts). */
+export declare const COMGATE_CARD_PATTERNS: readonly string[];
+/** Whether this URL is on one of ComGate's card hosts (https, no credentials, any port, a trailing dot or not). */
+export declare function isComgateCardHost(url: string): boolean;
+/** Whether this build's registry serves ComGate's entry: a company Agentcard turned ComGate on for, on a build that declares it. */
+export declare function servesComgate(vault: {
+    isCardRequest(url: string, method?: string): boolean;
+} | undefined): boolean;
+/**
+ * Whether an adapter must hand this request to the pre-claim gates: it is on one of ComGate's card hosts and this
+ * build's registry serves ComGate. attachToPlaywright's route predicate asks this, as attachToCdp arms the hosts.
+ */
+export declare function isArmedComgateUrl(vault: {
+    isCardRequest(url: string, method?: string): boolean;
+} | undefined, url: string): boolean;
+/**
+ * Whether a URL is ComGate's gateway link exactly as ComGate's create answer writes it: https, one of the four
+ * gateway hosts in lowercase, the default port, no credentials or fragment, the path /init, and a query of the one
+ * `id` parameter holding a transaction id. A string that parses to another spelling is not it.
+ */
+export declare function isComgateEntryUrl(raw: unknown): boolean;

package/dist/comgate.js

@@ -0,0 +1,80 @@
+/**
+ * ComGate's payment gateway (pay1 to pay4.comgate.cz, where most Czech and Slovak e-shops send the buyer), as this
+ * SDK reads it.
+ *
+ * The merchant's server creates the payment at ComGate and sends the buyer's browser to the gateway link ComGate
+ * answered with, https://payN.comgate.cz/init?id=<transaction id>, by a redirect or by setting the page's or a
+ * frame's location. That GET carries no card and nothing but the payment's id, and it is the one request a build
+ * that declares ComGate's capability pauses for ComGate (hosted-entry.ts): the cardholder's device then makes the
+ * gateway's own calls for that payment over the end-to-end TLS relay (payment-core processors/comgate.js). Only the
+ * link exactly as ComGate writes it is the entry; any other parameter would be handed on to the gateway's own
+ * route, which these rules never see.
+ *
+ * COMGATE_GATEWAY_HOSTS is payment-core's COMGATE_GATEWAY_HOSTS, and isComgateEntryUrl is payment-core's rule of
+ * the same name; hosted-entry.test.mjs pins both to payment-core on every case payment-core's own tests list.
+ */
+export const COMGATE_PSP = 'comgate';
+/** The dark-launch capability the API serves ComGate's recognizer behind (payment-core definitions.js). */
+export const COMGATE_CAPABILITY = 'comgate_hosted_payment_page';
+/** The four gateway hosts ComGate's create answer names, each a host of its own entry. */
+export const COMGATE_GATEWAY_HOSTS = Object.freeze(['pay1.comgate.cz', 'pay2.comgate.cz', 'pay3.comgate.cz', 'pay4.comgate.cz']);
+const COMGATE_ENTRY_PATH = '/init';
+// The id the gateway's router takes: three groups of four letters or digits.
+const TRANS_ID = /^[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}$/;
+/**
+ * The hosts that take a card, or part of one, for ComGate: the gateway's API (payments.comgate.cz behind pay1 and pay2,
+ * payments-gcp.comgate.cz behind pay3 and pay4), where the gateway posts the card (/client/instructions/card-process,
+ * check-card) and ComGate's Web Checkout SDK posts its own (/checkout/provider/*, /checkout/card/check-card), and the
+ * card frames' hosts (sec.comgate.cz, sec-gcp.comgate.cz), which post the card's first digits to their /bin-checker.
+ * The card is already encrypted in ComGate's frame by then, so no body rule could see it: once ComGate is served, this
+ * build fails every request to these hosts but a GET, so the card the agent typed never reaches ComGate.
+ */
+export const COMGATE_CARD_HOSTS = Object.freeze(['payments.comgate.cz', 'payments-gcp.comgate.cz', 'sec.comgate.cz', 'sec-gcp.comgate.cz']);
+/** The Fetch.enable globs attachToCdp arms for the card hosts, only while ComGate is served (cdp.ts). */
+export const COMGATE_CARD_PATTERNS = Object.freeze(COMGATE_CARD_HOSTS.map((host) => `*${host}*`));
+// A gateway link, as ComGate writes one: the registry reads ComGate as served when it takes this as a GET entry.
+const COMGATE_SAMPLE_ENTRY = 'https://pay1.comgate.cz/init?id=AAAA-BBBB-CCCC';
+/** Whether this URL is on one of ComGate's card hosts (https, no credentials, any port, a trailing dot or not). */
+export function isComgateCardHost(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return false;
+    }
+    return parsed.protocol === 'https:' && !parsed.username && !parsed.password
+        && COMGATE_CARD_HOSTS.includes(parsed.hostname.toLowerCase().replace(/\.$/, ''));
+}
+/** Whether this build's registry serves ComGate's entry: a company Agentcard turned ComGate on for, on a build that declares it. */
+export function servesComgate(vault) {
+    return typeof vault?.isCardRequest === 'function' && vault.isCardRequest(COMGATE_SAMPLE_ENTRY, 'GET');
+}
+/**
+ * Whether an adapter must hand this request to the pre-claim gates: it is on one of ComGate's card hosts and this
+ * build's registry serves ComGate. attachToPlaywright's route predicate asks this, as attachToCdp arms the hosts.
+ */
+export function isArmedComgateUrl(vault, url) {
+    return isComgateCardHost(url) && servesComgate(vault);
+}
+/**
+ * Whether a URL is ComGate's gateway link exactly as ComGate's create answer writes it: https, one of the four
+ * gateway hosts in lowercase, the default port, no credentials or fragment, the path /init, and a query of the one
+ * `id` parameter holding a transaction id. A string that parses to another spelling is not it.
+ */
+export function isComgateEntryUrl(raw) {
+    if (typeof raw !== 'string' || raw.length > 256)
+        return false;
+    let url;
+    try {
+        url = new URL(raw);
+    }
+    catch {
+        return false;
+    }
+    if (url.href !== raw || url.protocol !== 'https:' || url.port || url.username || url.password || url.hash)
+        return false;
+    if (!COMGATE_GATEWAY_HOSTS.includes(url.hostname) || url.pathname !== COMGATE_ENTRY_PATH)
+        return false;
+    return url.search.startsWith('?id=') && TRANS_ID.test(url.search.slice(4));
+}

package/dist/cybersource-secure-acceptance.generated.d.ts

@@ -38,7 +38,7 @@ declare function isPreparedSecureAcceptanceRequest(url: any, method: any, body:
 declare function secureAcceptanceMerchantEntry(profileId: any, merchantOrigin: any, entries?: any): any;
 declare function secureAcceptanceMerchantRefusal(environment: any, profileId: any, merchantOrigin: any, accessKey: any, entries?: any): "unsupported_environment" | "invalid_profile_id" | "secure_acceptance_merchant_unreviewed" | "secure_acceptance_merchant_pending" | "secure_acceptance_access_key_unreviewed" | "secure_acceptance_merchant_observe" | null;
 declare function secureAcceptanceCardType(number: any): "001" | "002" | "003" | "004" | null;
-declare function secureAcceptanceCardRefusal(environment: any, card: any): "unsupported_environment" | "sandbox_host_requires_documented_test_card" | "invalid_card_number" | "live_host_refuses_documented_test_card" | "card_network_unsupported" | "invalid_expiry" | "invalid_cvn" | null;
+declare function secureAcceptanceCardRefusal(environment: any, card: any): "invalid_card_number" | "unsupported_environment" | "sandbox_host_requires_documented_test_card" | "live_host_refuses_documented_test_card" | "card_network_unsupported" | "invalid_expiry" | "invalid_cvn" | null;
 declare function isSecureAcceptanceDeviceRequest(templateBody: any, deviceBody: any, environment: any): boolean;
 declare function secureAcceptanceDeviceRequest(request: any, card: any, options: any): {
     url: any;

package/dist/eprotect.generated.d.ts

@@ -81,7 +81,7 @@ declare function eprotectMerchantPin(paypageId: any, merchantOrigin: any, pins?:
 declare function eprotectMerchantRefusal(environment: any, paypageId: any, merchantOrigin: any, pins?: any): "invalid_paypage_id" | "unsupported_environment" | "eprotect_merchant_unreviewed" | null;
 declare function defaultRandom(bytes: any): void;
 declare function eprotectEncrypt(text: any, key: any, random?: typeof defaultRandom): string;
-declare function eprotectCardRefusal(environment: any, cardNumber: any): "unsupported_environment" | "sandbox_host_requires_documented_test_card" | "invalid_card_number" | "live_host_refuses_documented_test_card" | null;
+declare function eprotectCardRefusal(environment: any, cardNumber: any): "invalid_card_number" | "unsupported_environment" | "sandbox_host_requires_documented_test_card" | "live_host_refuses_documented_test_card" | null;
 declare function eprotectDeviceRequest(templateUrl: any, card: any, sessionKey: any, random?: typeof defaultRandom): {
     url: string;
     method: string;

package/dist/gmo.generated.js

@@ -1,6 +1,6 @@
 // @ts-nocheck
 // Generated from @agent-cards/payment-core. Do not edit.
-// artifact-sha256: 8149714daf5515a2fd3ec90d5aa0c7eb58a66d5ce79c3e3f0ba81c29d2946dc3
+// artifact-sha256: a65199bcbf0b67546130fb4f2c12ba72c8f51a2ff5b4e3054e2bfcc29b06f95d
 // src/sha256.js
 var K = /* @__PURE__ */ new Uint32Array([
     1116352408,
@@ -153,6 +153,9 @@ var typedArrayName = Object.getOwnPropertyDescriptor(TYPED_ARRAY, Symbol.toStrin
 function parseRsaPublicKey(key) {
     const spki = key && typeof key === "object" ? key.spki : void 0;
     const pin = key && typeof key === "object" ? key.sha256 : void 0;
+    const named = key && typeof key === "object" && Object.prototype.hasOwnProperty.call(key, "exponent") ? key.exponent : void 0;
+    if (named !== void 0 && named !== 17)
+        throw refuse("key");
     if (typeof spki !== "string" || spki.length > 1024 || spki.length % 4 !== 0 || !BASE64.test(spki))
         throw refuse("key");
     if (typeof pin !== "string" || !SHA256_HEX.test(pin))
@@ -188,9 +191,10 @@ function parseRsaPublicKey(key) {
     if (!MODULUS_BYTES.includes(n.length) || !(n[0] & 128) || !(n[n.length - 1] & 1))
         throw refuse("key");
     const e = exponent.bytes;
-    if (e.length !== 3 || e[0] !== 1 || e[1] !== 0 || e[2] !== 1)
+    const expected = named === 17 ? [17] : [1, 0, 1];
+    if (e.length !== expected.length || !expected.every((byte, i) => e[i] === byte))
         throw refuse("key");
-    return Object.freeze({ n: toBigInt(n), e: 65537n, size: n.length });
+    return Object.freeze({ n: toBigInt(n), e: named === 17 ? 17n : 65537n, size: n.length });
 }
 function rsaesPkcs1v15Encrypt(key, message, random) {
     const { n, e, size } = parseRsaPublicKey(key);

package/dist/hipay.generated.d.ts

@@ -25,11 +25,11 @@ declare function hipayUsername(headers: any): string | null;
 declare function hipayRequestRefusal(request: any): any;
 declare function isPreparedHipayRequest(url: any, method: any, body: any, environment: any, headers: any): boolean;
 declare function hipayPinOriginUsable(origin: any): boolean;
-declare var HIPAY_MERCHANT_PINS: readonly never[];
-declare function hipayOriginPin(merchantOrigin: any, pins?: readonly never[]): null;
-declare function hipayPreparationRefusal(environment: any, merchantOrigin: any, pins?: readonly never[]): "unsupported_environment" | "hipay_merchant_unreviewed" | null;
-declare function hipayMerchantPin(merchantOrigin: any, username: any, pins?: readonly never[]): null;
-declare function hipayMerchantRefusal(environment: any, merchantOrigin: any, username: any, pins?: readonly never[]): "hipay_headers_refused" | "unsupported_environment" | "hipay_merchant_unreviewed" | null;
+declare var HIPAY_MERCHANT_PINS: readonly any[];
+declare function hipayOriginPin(merchantOrigin: any, pins?: readonly any[]): any;
+declare function hipayPreparationRefusal(environment: any, merchantOrigin: any, pins?: readonly any[]): "unsupported_environment" | "hipay_merchant_unreviewed" | null;
+declare function hipayMerchantPin(merchantOrigin: any, username: any, pins?: readonly any[]): any;
+declare function hipayMerchantRefusal(environment: any, merchantOrigin: any, username: any, pins?: readonly any[]): "hipay_headers_refused" | "unsupported_environment" | "hipay_merchant_unreviewed" | null;
 declare function hipayRefusalMessage(code: any): any;
 declare function injectHipayCard(body: any, card: any): {
     body: string;