@agenzo/merchant-cli 0.8.13 → 0.8.15

package/dist/index.js

@@ -1519,9 +1519,24 @@ var hotelPayOrderSchema = {
   cli: CLI_NAME,
   noun: HOTEL_NOUN,
   verb: "pay-order",
-  description: 'Settle an existing AWAITING_PAYMENT order created by create-order. Takes only --order-id; the billing path is decided server-side by the order billing_mode. monthly_settlement deducts from the developer credit account then confirms with the supplier; pay_per_call verifies the user EVO payment \u2014 the EVO merchantTransID IS the order_id (the user pays via EVO under the order_id), so the platform queries EVO for that order_id and requires an exact amount/currency match before confirming (the response settlement_path is then "pay_per_call"). On success the order becomes PAID. Supports --watch to poll on PAYMENT_NOT_COMPLETED until PAID',
+  description: "Settle an existing AWAITING_PAYMENT order created by create-order. Charging happens in this step \u2014 platform create-order only locks inventory/price and moves no money (lock-then-pay). Optional payment credentials (--payment-method-id / --payment-token-id / --authorized-merchant-trans-id) are forwarded to the pay body; omit them to let the platform settle by billing_mode (monthly_settlement deducts credit; pay_per_call selects the developer default card / EVO preauth). Token wins over method id server-side. On EVO cardholder authentication the response is AUTHENTICATION_REQUIRED with a three_ds_url + merchant_trans_id; resume by re-calling pay-order with --authorized-merchant-trans-id. On success the order becomes PAID. Supports --watch to poll on PAYMENT_NOT_COMPLETED until PAID",
   flags: {
-    "order-id": { type: "string", required: true, description: "Order to settle (create-order.response.order_id). For pay_per_call this is also the EVO merchantTransID the user paid under." },
+    "order-id": { type: "string", required: true, description: "Order to settle (create-order.response.order_id)." },
+    "payment-method-id": {
+      type: "string",
+      required: false,
+      description: "Optional bound-card id to charge (pay_per_call / EVO preauth). Ignored for monthly_settlement and when payment-token-id is set."
+    },
+    "payment-token-id": {
+      type: "string",
+      required: false,
+      description: "Optional network-token id (UnionPay/Visa). When set the platform settles via network-token direct charge instead of EVO preauth+capture. Wins over payment-method-id."
+    },
+    "authorized-merchant-trans-id": {
+      type: "string",
+      required: false,
+      description: "Resume a 3DS challenge: merchant trans id of an already-authorised preauth returned by a prior AUTHENTICATION_REQUIRED response. Reuses that authorization instead of creating a new one (pay_per_call only)."
+    },
     "idempotency-key": {
       type: "string",
       required: true,
@@ -2309,12 +2324,13 @@ var flightChangePaySchema = flightSchema(
     currency: { type: "string", required: false, default: "USD", description: "ISO 4217 currency code." },
     "payment-method-id": { type: "string", required: false, description: "Optional bound-card id (EVO path)." },
     "payment-token-id": { type: "string", required: false, description: "Optional UPI network-token id (unionpay charge path)." },
+    "authorized-merchant-trans-id": { type: "string", required: false, description: "Resume a 3DS challenge with the merchant trans id of the already-authorised preauth; the platform reuses and captures it instead of authorizing again." },
     "idempotency-key": { type: "string", required: true, description: "Idempotency-Key header." }
   },
   {
     change_order_no: { type: "string", description: "Change order number." },
     status: { type: "string", description: "PROCESSING after payment." },
-    payment_status: { type: "string", description: "SETTLED on success." }
+    payment_status: { type: "string", description: "SETTLED on success. Absent when the card needs 3DS \u2014 the response then carries a challenge object instead (status AUTHENTICATION_REQUIRED, three_ds_url, merchant_trans_id) and nothing has been charged yet." }
   },
   { command: "agenzo-merchant-cli flight-flink change-pay --change-order-no C1 --order-no ffo_... --amount 120 --currency USD --idempotency-key k6", output_summary: "Change fee charged; change ticketing triggered." }
 );
@@ -4150,7 +4166,10 @@ function isPaymentTerminal(record) {
   return status === "PAID";
 }
 function registerHotelPayOrderCommand(parent, deps) {
-  const cmd = parent.command("pay-order").description("Settle an existing hotel order (path decided by billing_mode: monthly_settlement or pay_per_call)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--order-id <id>", "Order ID to pay (from create-order response)").option(
+  const cmd = parent.command("pay-order").description("Settle an existing hotel order (path decided by billing_mode: monthly_settlement or pay_per_call)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--order-id <id>", "Order ID to pay (from create-order response)").option("--payment-method-id <id>", "Optional bound-card id to charge (pay_per_call / EVO preauth)").option("--payment-token-id <id>", "Optional network-token id (unionpay/visa charge path)").option(
+    "--authorized-merchant-trans-id <id>",
+    "Resume a 3DS challenge: merchant trans id of an already-authorised preauth"
+  ).option(
     "--idempotency-key <key>",
     "Idempotency key forwarded verbatim as the Idempotency-Key header"
   ).option("--watch", "Poll until PAID or timeout (NDJSON output)", false).option(
@@ -4183,6 +4202,11 @@ function registerHotelPayOrderCommand(parent, deps) {
     const watchInterval = resolveSeconds(opts.watchInterval, DEFAULT_PAY_WATCH_INTERVAL_SECONDS);
     const watchTimeout = resolveSeconds(opts.watchTimeout, DEFAULT_PAY_WATCH_TIMEOUT_SECONDS);
     const body = {};
+    if (opts.paymentMethodId !== void 0) body.payment_method_id = opts.paymentMethodId;
+    if (opts.paymentTokenId !== void 0) body.payment_token_id = opts.paymentTokenId;
+    if (opts.authorizedMerchantTransId !== void 0) {
+      body.authorized_merchant_trans_id = opts.authorizedMerchantTransId;
+    }
     if (!isYes) {
       const confirmed = await confirm5({
         message: `Settle hotel order ${orderId}? This moves money via the order's configured billing mode (monthly_settlement or pay_per_call).`,
@@ -5873,7 +5897,10 @@ function registerChangeCancelCommand(parent, deps) {
 // src/flight-flink/change-pay.ts
 import { confirm as confirm12 } from "@inquirer/prompts";
 function registerChangePayCommand(parent, deps) {
-  const cmd = parent.command("change-pay").description("Pay a change request fee (like a normal order) and trigger change ticketing").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--change-order-no <id>", "Change order number").option("--order-no <id>", "Original order reference (ownership check)").option("--amount <amount>", "Change fee total in decimal units (change-detail price_total)").option("--currency <currency>", "ISO 4217 currency code", "USD").option("--payment-method-id <id>", "Optional bound-card id (EVO path)").option("--payment-token-id <id>", "Optional UPI network-token id (unionpay charge path)").option("--idempotency-key <key>", "Forwarded verbatim as the Idempotency-Key header");
+  const cmd = parent.command("change-pay").description("Pay a change request fee (like a normal order) and trigger change ticketing").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--change-order-no <id>", "Change order number").option("--order-no <id>", "Original order reference (ownership check)").option("--amount <amount>", "Change fee total in decimal units (change-detail price_total)").option("--currency <currency>", "ISO 4217 currency code", "USD").option("--payment-method-id <id>", "Optional bound-card id (EVO path)").option("--payment-token-id <id>", "Optional UPI network-token id (unionpay charge path)").option(
+    "--authorized-merchant-trans-id <id>",
+    "Resume a 3DS challenge: merchant trans id of the already-authorised preauth"
+  ).option("--idempotency-key <key>", "Forwarded verbatim as the Idempotency-Key header");
   attachSchemaHelp(cmd, flightChangePaySchema);
   cmd.action(async () => {
     const opts = cmd.optsWithGlobals();
@@ -5891,11 +5918,13 @@ function registerChangePayCommand(parent, deps) {
     };
     if (opts.paymentMethodId !== void 0) body.payment_method_id = opts.paymentMethodId;
     if (opts.paymentTokenId !== void 0) body.payment_token_id = opts.paymentTokenId;
+    if (opts.authorizedMerchantTransId !== void 0) {
+      body.authorized_merchant_trans_id = opts.authorizedMerchantTransId;
+    }
     if (!isYes) {
-      const ok = await confirm12({
-        message: `Pay change fee ${amount} ${currency} for change order ${changeOrderNo}? This charges the customer and triggers change ticketing.`,
-        default: false
-      });
+      const isResume = opts.authorizedMerchantTransId !== void 0;
+      const message = isResume ? `Resume change fee ${amount} ${currency} for change order ${changeOrderNo}? The card is already authorised; this captures it and triggers change ticketing.` : `Pay change fee ${amount} ${currency} for change order ${changeOrderNo}? This charges the customer and triggers change ticketing.`;
+      const ok = await confirm12({ message, default: false });
       if (!ok) throw new CliError("CLIENT_ABORTED", "Change payment aborted by user.");
     }
     const idempotencyKey = await resolveIdempotencyKey(opts.idempotencyKey, {
@@ -5911,10 +5940,24 @@ function registerChangePayCommand(parent, deps) {
     );
     spinner?.stop();
     if (!result.success) throw CliError.fromApi(result, { auth: "api-key" });
-    await render2(
-      result.data,
-      opts.format,
-      (d) => [
+    await render2(result.data, opts.format, (d) => {
+      const challenge = d.challenge ?? null;
+      if (challenge) {
+        return [
+          Formatter.keyValue([
+            ["Change order no", String(challenge.change_order_no ?? "-")],
+            ["Status", String(challenge.status ?? "-")],
+            ["Amount", `${challenge.amount ?? "-"} ${challenge.currency ?? ""}`.trim()],
+            ["Authentication URL", String(challenge.three_ds_url ?? "-")],
+            ["Merchant trans id", String(challenge.merchant_trans_id ?? "-")]
+          ]),
+          Formatter.status(
+            "warning",
+            "Not charged yet \u2014 the card requires 3-D Secure and the funds are not held. Open the authentication URL, then re-run change-pay with --authorized-merchant-trans-id <merchant trans id>."
+          )
+        ].join("\n\n");
+      }
+      return [
         Formatter.keyValue([
           ["Change order no", String(d.change_order_no ?? "-")],
           ["Status", String(d.status ?? "-")],
@@ -5922,8 +5965,8 @@ function registerChangePayCommand(parent, deps) {
           ["Payment status", String(d.payment_status ?? "-")]
         ]),
         Formatter.status("info", "Change fee charged; change ticketing triggered. Poll change-detail until SUCCESS.")
-      ].join("\n\n")
-    );
+      ].join("\n\n");
+    });
   });
 }