@ozura/elements 1.2.0-next.26 → 1.2.0-next.28

package/dist/types/types/index.d.ts

@@ -418,27 +418,46 @@ export interface CardSaleRequest {
     amount: string;
     /** ISO 4217, e.g. "USD". */
     currency: string;
-    /** From TokenResponse.token */
-    ozuraCardToken: string;
+    /**
+     * Who initiated the transaction. Required by the Pay API.
+     * - `'cit'`  — Customer-Initiated Transaction (default for web checkouts).
+     * - `'mit'`  — Merchant-Initiated (scheduled recurring charge, customer not present).
+     * - `'ucof'` — Unscheduled Credential-on-File (threshold billing, account-updater, etc.).
+     * - `'refund'` — Voids, returns, reversals (not a stored-credential use).
+     */
+    transactionInitiationType: 'cit' | 'mit' | 'ucof' | 'refund';
+    /**
+     * Channel through which the transaction is processed. Required by the Pay API.
+     * - `'ecommerce'`  — Online, customer self-serve (default for web checkouts).
+     * - `'moto'`       — Mail order / telephone order.
+     * - `'cardPresent'`— POS / in-person.
+     * - `'recurring'`  — Scheduled MIT charge; never the initial CIT charge.
+     */
+    transactionChannel: 'cardPresent' | 'ecommerce' | 'moto' | 'recurring';
+    /** From TokenResponse.token. The vault token representing the stored card. */
+    ozuraVaultToken: string;
     /** From TokenResponse.cvcSession */
     ozuraCvcSession: string;
     billingFirstName: string;
     billingLastName: string;
-    /** Optional but must be non-empty if provided — Pay API enforces minLength 1. Omit the key rather than send "". */
+    /**
+     * Required by the Pay API (minLength 1). Optional here so merchants can omit it
+     * in rare server-side-only flows, but the Pay API will reject the request if absent.
+     */
     billingEmail?: string;
-    /** E.164 format, max 50 chars. Optional but must be non-empty if provided. */
+    /** E.164 format, max 50 chars. Required by the Pay API; optional here for flexibility. */
     billingPhone?: string;
-    /** Optional but must be non-empty if provided. */
+    /** Required by the Pay API; optional here for flexibility. Must be non-empty if provided. */
     billingAddress1?: string;
-    /** Omit entirely if blank — schema enforces minLength 1 if present. */
+    /** Omit entirely if blank — Pay API schema enforces minLength 1 if present. */
     billingAddress2?: string;
-    /** Optional but must be non-empty if provided. */
+    /** Required by the Pay API; optional here for flexibility. Must be non-empty if provided. */
     billingCity?: string;
-    /** 2-letter state/province code. Optional but must be non-empty if provided. */
+    /** 2-letter state/province code. Required by the Pay API; optional here for flexibility. */
     billingState?: string;
-    /** Optional but must be non-empty if provided. */
+    /** Required by the Pay API; optional here for flexibility. Must be non-empty if provided. */
     billingZipcode?: string;
-    /** ISO 3166-1 alpha-2. Defaults to 'US'. */
+    /** ISO 3166-1 alpha-2. Required by the Pay API. Defaults to 'US' in `Ozura.cardSale()`. */
     billingCountry?: string;
     /** Fetch from your server — use an internal route, not api.ipify.org (ad-blockers block it). */
     clientIpAddress: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ozura/elements",
-  "version": "1.2.0-next.26",
+  "version": "1.2.0-next.28",
   "description": "PCI-compliant card tokenization SDK for the Ozura Vault — collect card data in iframe-isolated fields and tokenize without PCI scope",
   "main": "dist/oz-elements.umd.js",
   "module": "dist/oz-elements.esm.js",