@astrasyncai/verification-gateway 5.4.2 → 5.5.0

package/dist/index.mjs

@@ -19,7 +19,7 @@ function getTrustLevel(score) {
 }
 
 // src/version.ts
-var SDK_VERSION = "5.4.1";
+var SDK_VERSION = "5.5.0";
 
 // src/http.ts
 var SDK_USER_AGENT = `astrasync-sdk/${SDK_VERSION}`;
@@ -554,7 +554,10 @@ async function verify(config, request, options) {
       recommendationReasons: apiResponse.recommendationReasons,
       stepUpApproval: apiResponse.stepUpApproval,
       settlement: apiResponse.settlement,
-      settlementOutcome: apiResponse.settlementOutcome
+      settlementOutcome: apiResponse.settlementOutcome,
+      // 5.5.0 self-settlement: merchant-only material — passes through to the
+      // MERCHANT caller only (bridge callers strip it before the agent plane).
+      settlementToken: apiResponse.settlementToken
     };
     return result2;
   }
@@ -612,7 +615,8 @@ async function verify(config, request, options) {
     warningHeader: apiResponse.warningHeader,
     stepUpApproval: apiResponse.stepUpApproval,
     settlement: apiResponse.settlement,
-    settlementOutcome: apiResponse.settlementOutcome
+    settlementOutcome: apiResponse.settlementOutcome,
+    settlementToken: apiResponse.settlementToken
   };
   if (result.recommendation === "deny") {
     result.policyAllowed = false;
@@ -2644,6 +2648,13 @@ var VerificationGatewayClient = class {
    * settled/failed/requires_action/no_instrument outcome (+ `orderId`), and the
    * identity/policy/`failures` fields for a denial. On any non-`confirm`/first-
    * party path `settlementOutcome` is simply absent — no money moves.
+   *
+   * 5.5.0 self-settling merchants (settlement_mode='self_settle'): the result
+   * carries `.settlementToken` instead of a completed charge. Charge on your
+   * own integration with Stripe idempotency key `voucher:<token.jti>` and
+   * `metadata: { jti: token.jti, sessionId: token.sessionId }`, then call
+   * `reportSettlement()` with the outcome. Treat any `settlementOutcome.status`
+   * you don't recognize (e.g. `pending_merchant`) as PENDING, never failed.
    */
   async confirmCheckout(options) {
     const credentials = {
@@ -2673,6 +2684,32 @@ var VerificationGatewayClient = class {
       )
     );
   }
+  /**
+   * 5.5.0 (astra-pay): report a self-settled charge outcome back to the
+   * platform — the other half of the `settlementToken` contract. Call after
+   * your PaymentIntent reaches a terminal state so the buyer's dashboard,
+   * /orders and the agent's poll surface reconcile. Authenticated with this
+   * client's api key (must be the merchant's own). Amounts must match the
+   * order EXACTLY (integer minor units) or the report is rejected whole
+   * (409 amount_mismatch). Replays of the same terminal state are safe.
+   */
+  async reportSettlement(options) {
+    const base = this.config.apiBaseUrl.replace(/\/+$/, "");
+    const res = await sdkFetch(`${base}/merchant/settlements/report`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        // Same auth pair as every backend call the SDK makes (verify.ts).
+        ...this.config.apiKey ? { Authorization: `Bearer ${this.config.apiKey}`, "X-API-Key": this.config.apiKey } : {}
+      },
+      body: JSON.stringify(options)
+    });
+    const json = await res.json().catch(() => ({}));
+    if (!res.ok || !json.success || !json.data) {
+      throw new Error(`reportSettlement failed (${res.status}): ${json.error ?? "unknown error"}`);
+    }
+    return json.data;
+  }
   /**
    * Quick verification — checks credentials and policy in one call.
    *