@inkress/admin-sdk 1.1.46 → 1.1.47

package/README.md

@@ -42,7 +42,7 @@ import { InkressSDK } from '@inkress/admin-sdk';
 
 const inkress = new InkressSDK({
   accessToken: 'your-jwt-token',
-  username: 'merchant-username', // Optional
+  username: 'merchant-username', // Optional - only needed for merchant operations
   mode: 'live', // Optional - 'live' (default) or 'sandbox'
 });
 ```
@@ -222,6 +222,7 @@ The SDK provides access to 23+ fully-typed resources:
 - **Subscriptions** - Recurring billing and subscriptions
 - **Payment Links** - Payment link generation
 - **Payment Methods** - Payment method configuration
+- **Checkout Sessions** - Embedded checkout for card payments
 
 ### Financial
 - **Financial Accounts** - Account management
@@ -702,6 +703,231 @@ await inkress.paymentLinks.update(linkId, { amount: 89.99 });
 await inkress.paymentLinks.delete(linkId);
 ```
 
+### Checkout Sessions (Embedded Checkout)
+
+Checkout Sessions enable embedded payment forms that can be integrated directly into your website via an iframe. This provides a seamless checkout experience without redirecting customers away from your site.
+
+```typescript
+// Create a checkout session
+const session = await inkress.checkoutSessions.create({
+  reference_id: 'order-123',
+  total: 100.00,
+  kind: 'online',
+  currency_code: 'JMD',
+  title: 'Premium Subscription',
+  customer: {
+    email: 'customer@example.com',
+    first_name: 'John',
+    last_name: 'Doe',
+    phone: '+1234567890'
+  }
+});
+
+// Access the iframe URL for embedding
+const iframeUrl = session.result.frame_url;
+const sessionId = session.result.session_id;
+
+// Get session details
+const details = await inkress.checkoutSessions.get('S.75a29ad32e52');
+console.log(details.result.status); // 'pending', 'awaiting_payment', 'completed', etc.
+
+// Cancel a session
+await inkress.checkoutSessions.delete('S.75a29ad32e52');
+```
+
+#### Embedding the Checkout Iframe
+
+The checkout session returns a `frame_url` that you can embed in your page:
+
+```html
+<!-- Embed the checkout iframe -->
+<iframe
+  id="inkress-checkout"
+  src="https://inkress.com/checkout/session/S.75a29ad32e52"
+  style="width: 100%; height: 600px; border: none;"
+  allow="payment"
+></iframe>
+```
+
+#### Handling Checkout Events
+
+The embedded checkout iframe emits two important `postMessage` events that your application should listen for:
+
+| Event | Description | When Fired |
+|-------|-------------|------------|
+| `frame_unload` | User has entered card information | Card details submitted to payment processor |
+| `payment_posted` | Payment attempt completed | After 3DS verification or payment processing |
+
+```typescript
+const session_id = mySession.id;
+// Listen for checkout events from the iframe
+window.addEventListener('message', (event) => {
+  // Verify the origin for security
+  if (event.origin !== 'https://inkress.com') {
+    return;
+  }
+
+  const { type, data } = event.data;
+
+  switch (type) {
+    case 'frame_unload':
+      // User has entered their card information
+      // The iframe is processing the payment
+      console.log('Payment processing started...');
+      expandFrameFor3DS();
+      break;
+
+    case 'payment_posted':
+      // Payment attempt has completed
+      // Check the session status to determine outcome
+      handlePaymentResult();
+      break;
+  }
+});
+
+async function handlePaymentResult() {
+  // Fetch the updated session to get the final status
+  const session = await inkress.checkoutSessions.get(dsession_id);
+  
+  if (session.result.status === 'completed') {
+    // Payment successful!
+    showSuccessMessage();
+    redirectToConfirmation(session.result.order_id);
+  } else {
+    // Payment failed or requires action
+    showErrorMessage('Payment could not be completed. Please try again.');
+  }
+}
+```
+
+#### Complete Integration Example
+
+```typescript
+import { InkressSDK } from '@inkress/admin-sdk';
+
+const inkress = new InkressSDK({
+  accessToken: 'your-jwt-token',
+  username: 'your-merchant'
+});
+
+async function initializeCheckout(orderData: {
+  total: number;
+  currency: string;
+  customer: { email: string; firstName: string; lastName: string; phone: string };
+}) {
+  // 1. Create the checkout session
+  const session = await inkress.checkoutSessions.create({
+    reference_id: `${Math.random().toString(36).substring(2, 9)}`,
+    total: orderData.total,
+    kind: 'online',
+    currency_code: orderData.currency,
+    title: 'Your Order',
+    customer: {
+      email: orderData.customer.email,
+      first_name: orderData.customer.firstName,
+      last_name: orderData.customer.lastName,
+      phone: orderData.customer.phone
+    }
+  });
+
+  // 2. Store session details for later reference
+  const sessionId = session.result.session_id;
+  const expiresAt = session.result.expires;
+
+  // 3. Display the checkout iframe
+  const iframe = document.createElement('iframe');
+  iframe.src = session.result.frame_url;
+  iframe.style.cssText = 'width: 100%; height: 600px; border: none;';
+  iframe.allow = 'payment';
+  document.getElementById('checkout-container')!.appendChild(iframe);
+
+  // 4. Set up event listeners
+  window.addEventListener('message', async (event) => {
+    if (event.origin !== 'https://inkress.com') return;
+
+    const { type } = event.data;
+
+    if (type === 'frame_unload') {
+      // Show loading state while payment processes
+      document.getElementById('loading-overlay')!.style.display = 'flex';
+    }
+
+    if (type === 'payment_posted') {
+      // Check final payment status
+      const updatedSession = await inkress.checkoutSessions.get(sessionId);
+      
+      if (updatedSession.result.status === 'completed') {
+        window.location.href = `/order-confirmation?order=${updatedSession.result.order_id}`;
+      } else {
+        document.getElementById('loading-overlay')!.style.display = 'none';
+        alert('Payment failed. Please try again.');
+      }
+    }
+  });
+
+  // 5. Handle session expiration
+  const timeUntilExpiry = expiresAt - Date.now();
+  setTimeout(() => {
+    alert('Your checkout session has expired. Please try again.');
+    window.location.reload();
+  }, timeUntilExpiry);
+
+  return { sessionId, expiresAt };
+}
+```
+
+#### Session Response Structure
+
+```typescript
+interface CreateCheckoutSessionResponse {
+  session_id: string;           // e.g., 'S.75a29ad32e52'
+  reference_id: string;         // Your order reference
+  status: string;               // 'pending'
+  order_id: string;             // Internal order ID
+  currency: string;             // e.g., 'JMD'
+  currency_code: string;        // e.g., 'JMD'
+  created_at: string;           // ISO timestamp
+  payment_initiated_at: string; // ISO timestamp
+  completed_at: string | null;  // null until completed
+  expires: number;              // Expiration timestamp (ms)
+  
+  // Payment totals breakdown
+  totals: {
+    sub_total: number;
+    customer_total: number;     // Amount customer pays
+    merchant_total: number;     // Amount merchant receives
+    platform_total: number;
+    provider_total: number;
+    shipping_total: number;
+    tax_total: number;
+    discount_total: number;
+  };
+  
+  // Customer info
+  customer: {
+    id: number | null;
+    email: string;
+    first_name: string;
+    last_name: string;
+    phone: string;
+  };
+  
+  // Iframe and payment data
+  frame_url: string;            // URL to embed in iframe
+  redirect_data: string;        // 3DS redirect HTML (if needed)
+  spi_token: string;            // Payment processor token
+  transaction_id: string;       // Transaction UUID
+  amount: number;               // Total amount
+  
+  // Additional fields
+  title: string;
+  products: any[];
+  transaction_type: string | null;
+  three_d_secure: any | null;
+  is_subscription: boolean;
+}
+```
+
 ### Financial Accounts
 
 ```typescript

package/dist/index.d.ts

@@ -20,6 +20,7 @@ import { FeesResource } from './resources/fees';
 import { PaymentMethodsResource } from './resources/payment-methods';
 import { TransactionEntriesResource } from './resources/transaction-entries';
 import { GenericsResource } from './resources/generics';
+import { CheckoutSessionsResource } from './resources/checkout-sessions';
 /**
  * Main Inkress Commerce API SDK class
  *
@@ -86,6 +87,7 @@ export declare class InkressSDK {
     readonly paymentMethods: PaymentMethodsResource;
     readonly transactionEntries: TransactionEntriesResource;
     readonly generics: GenericsResource;
+    readonly checkoutSessions: CheckoutSessionsResource;
     constructor(config: InkressConfig);
     /**
      * Update the SDK configuration
@@ -100,6 +102,7 @@ export * from './types';
 export * from './client';
 export type { WebhookPayload, WebhookVerificationOptions, IncomingWebhookRequest, } from './resources/webhook-urls';
 export { KYC_DOCUMENT_REQUIREMENTS, type EntityType, type KycDocumentType, type KycDocumentStatus, type KycRequirements, } from './resources/kyc';
+export type { CheckoutSession, CheckoutSessionStatus, CheckoutSessionFees, CheckoutSessionFeeMapping, CheckoutSessionTotals, CheckoutSessionCurrency, CheckoutSessionCustomer, CreateCheckoutSessionResponseData, DeleteCheckoutSessionResponseData, } from './resources/checkout-sessions';
 export type { BankInfoUpdateRequestData, BankAccountUpdateRequestResponse, BankAccountUpdateConfirmResponse, } from './resources/merchants';
 export { InkressSDK as default };
 export type { OrderQueryParams, ProductQueryParams, UserQueryParams, MerchantQueryParams, CategoryQueryParams, BillingPlanQueryParams, SubscriptionQueryParams, PaymentLinkQueryParams, FinancialAccountQueryParams, FinancialRequestQueryParams, WebhookUrlQueryParams, TokenQueryParams, AddressQueryParams, CurrencyQueryParams, ExchangeRateQueryParams, FeeQueryParams, PaymentMethodQueryParams, TransactionEntryQueryParams, OrderFilterParams, ProductFilterParams, UserFilterParams, MerchantFilterParams, CategoryFilterParams, BillingPlanFilterParams, SubscriptionFilterParams, PaymentLinkFilterParams, FinancialAccountFilterParams, FinancialRequestFilterParams, WebhookUrlFilterParams, TokenFilterParams, AddressFilterParams, CurrencyFilterParams, ExchangeRateFilterParams, FeeFilterParams, PaymentMethodFilterParams, TransactionEntryFilterParams, OrderListResponse, ProductListResponse, UserListResponse, MerchantListResponse, CategoryListResponse, BillingPlanListResponse, SubscriptionListResponse, PaymentLinkListResponse, FinancialAccountListResponse, FinancialRequestListResponse, WebhookUrlListResponse, TokenListResponse, AddressListResponse, CurrencyListResponse, ExchangeRateListResponse, FeeListResponse, PaymentMethodListResponse, TransactionEntryListResponse, PageInfo, } from './types/resources';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.esm.js

@@ -4857,6 +4857,93 @@ class GenericsResource {
     }
 }
 
+/**
+ * Checkout Sessions Resource
+ *
+ * Handles creation and management of checkout sessions for payments.
+ * Checkout sessions provide a way to create temporary payment sessions
+ * with pre-calculated fees and payment URLs.
+ */
+class CheckoutSessionsResource {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create a new checkout session
+     *
+     * Creates a checkout session with pre-calculated fees and returns
+     * payment URLs for processing the payment.
+     *
+     * Requires Client-Id header to be set in the configuration.
+     *
+     * @param data - Order data for the checkout session (same as order creation)
+     * @returns The created checkout session with payment URLs and fee breakdown
+     *
+     * @example
+     * ```typescript
+     * const session = await sdk.checkoutSessions.create({
+     *   reference_id: 'order-123',
+     *   total: 100.00,
+     *   kind: 'online',
+     *   currency_code: 'JMD',
+     *   customer: {
+     *     email: 'customer@example.com',
+     *     first_name: 'John',
+     *     last_name: 'Doe',
+     *     phone: '+1234567890'
+     *   },
+     *   title: 'My Order'
+     * });
+     *
+     * // Redirect customer to payment URL
+     * console.log(session.result.payment_url);
+     * ```
+     */
+    async create(data) {
+        return this.client.post('/checkout/sessions', data);
+    }
+    /**
+     * Get checkout session details by session ID
+     *
+     * Retrieves the current state of a checkout session including
+     * payment status, customer info, and fee breakdown.
+     *
+     * Requires Client-Id header to be set in the configuration.
+     *
+     * @param sessionId - The session ID (e.g., 'S.75a29ad32e52')
+     * @returns The checkout session details
+     *
+     * @example
+     * ```typescript
+     * const session = await sdk.checkoutSessions.get('S.75a29ad32e52');
+     * console.log(session.result.status); // 'awaiting_payment'
+     * ```
+     */
+    async get(sessionId) {
+        return this.client.get(`/checkout/sessions/${sessionId}`);
+    }
+    /**
+     * Delete (cancel) a checkout session
+     *
+     * Cancels an active checkout session. Once cancelled, the session
+     * can no longer be used for payment.
+     *
+     * Requires Client-Id header to be set in the configuration.
+     *
+     * @param sessionId - The session ID to cancel (e.g., 'S.75a29ad32e52')
+     * @returns Confirmation of the cancellation
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.checkoutSessions.delete('S.75a29ad32e52');
+     * console.log(result.result); // 'Session cancelled'
+     * ```
+     */
+    async delete(sessionId) {
+        return this.client.delete(`/checkout/sessions/${sessionId}`);
+    }
+}
+
 /**
  * Main Inkress Commerce API SDK class
  *
@@ -4925,6 +5012,7 @@ class InkressSDK {
         this.paymentMethods = new PaymentMethodsResource(this.client);
         this.transactionEntries = new TransactionEntriesResource(this.client);
         this.generics = new GenericsResource(this.client);
+        this.checkoutSessions = new CheckoutSessionsResource(this.client);
     }
     /**
      * Update the SDK configuration