@agenzo/merchant-cli 0.8.12 → 0.8.14

package/dist/index.js

@@ -1047,6 +1047,11 @@ var bookSchema = {
       required: false,
       description: "Bound payment method id to charge (pay_per_call only). Opaque id from `token payment-methods list`; ignored for monthly_settlement"
     },
+    "payment-token-id": {
+      type: "string",
+      required: false,
+      description: "UPI Agent Pay: network-token id from an already-completed UnionPay/Visa capture. When set, the platform skips EVO preauth/capture and only books the ride + records this credential (funds already charged)"
+    },
     member: MEMBER_FLAG_SCHEMA,
     "passenger-name": { type: "string", required: true, description: "Passenger full name" },
     "passenger-phone": { type: "string", required: true, description: "Passenger phone in E.164 format (e.g. +14155551234)" },
@@ -2304,12 +2309,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." }
 );
@@ -2538,6 +2544,9 @@ function registerBookCommand(parent, deps) {
   const cmd = parent.command("book").description("Book a ride using a quote_id returned by quote").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--quote-id <id>", "Quote id from `ride-elife quote`").option("--vehicle-class <class>", "Chosen vehicle class").option("--price-amount <amount>", "Fare in decimal currency units (not cents)").option("--price-currency <currency>", "Currency code (default USD)").option("--payment-order-id <id>", "Paid payment order id (pay_per_call mode only)").option(
     "--payment-method-id <id>",
     "Bound payment method id to charge (pay_per_call mode only)"
+  ).option(
+    "--payment-token-id <id>",
+    "UPI Agent Pay: payment token id from an already-completed UnionPay/Visa network-token capture. When set, the platform skips EVO preauth/capture and only books the ride + records this credential (funds already charged)."
   ).option(
     "--authorized-merchant-trans-id <id>",
     "EVO merchant transaction id of an already-authorised preauth (3DS challenge resume). When set, the server reuses that authorization instead of creating a new one, avoiding a second hold on the card (pay_per_call mode only)."
@@ -2565,6 +2574,7 @@ function registerBookCommand(parent, deps) {
     };
     if (opts.paymentOrderId) body.payment_order_id = opts.paymentOrderId;
     if (opts.paymentMethodId) body.payment_method_id = opts.paymentMethodId;
+    if (opts.paymentTokenId) body.payment_token_id = opts.paymentTokenId;
     if (opts.authorizedMerchantTransId) {
       body.authorized_merchant_trans_id = opts.authorizedMerchantTransId;
     }
@@ -5864,7 +5874,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();
@@ -5882,11 +5895,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, {
@@ -5902,10 +5917,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 ?? "-")],
@@ -5913,8 +5942,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");
+    });
   });
 }