@djust-b2b/djust-front-sdk 3.0.0-beta.8 → 3.0.0

package/lib/services/payment/index.d.ts

@@ -0,0 +1,150 @@
+import { GetPaymentDetailsRequest, GetPaymentDetailsResponse, DeleteStoredPaymentMethodByIdRequest, GetPaymentMethodsRequest, GetPaymentMethodsResponse, InitPaymentRequest, InitPaymentResponse, PrecheckPurchaseCardL3Request, PrecheckPurchaseCardL3Response } from "./definitions";
+/**
+ * 💳 Initializes a payment transaction.
+ *
+ * This endpoint initializes a payment transaction.
+ * It supports:
+ * - Card authorizations with or without 3D Secure (3DS).
+ * - 3DS authentication flows, including redirection steps if required.
+ * - Bank transfer payment initialization using virtual IBAN feature.
+ *
+ * The response indicates the result of the transaction attempt and may contain an action
+ * (such as a redirection or bank transfer instructions) that must be followed to complete the payment.
+ *
+ * 🛠 **Endpoint**: `POST /v1/shop/payments` [PAY-101]
+ *
+ * | Parameter           | Type                | Required | Description                                    |
+ * |---------------------|---------------------|----------|------------------------------------------------|
+ * | `browserInfo`       | `BrowserInfo`       | ✅       | Browser information for 3DS authentication.   |
+ * | `countryCode`       | `string`            | ✅       | Country code for payment processing.          |
+ * | `customerUserIP`    | `string`            | ❌       | Customer's IP address.                        |
+ * | `paymentMethodData` | `PaymentMethodData` | ❌       | Payment method configuration.                 |
+ * | `reference`         | `string`            | ✅       | Payment reference identifier.                 |
+ * | `referenceType`     | `string`            | ❌       | Type of reference.                            |
+ * | `returnPath`        | `string`            | ✅       | Return URL after payment completion.          |
+ * | `storePaymentMethod`| `boolean`           | ❌       | Whether to store the payment method.          |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to an `InitPaymentResponse` containing the payment initialization result.
+ *
+ *  🛠 **Example usage**:
+ * ```ts
+ * const response = await initPayment({
+ *   browserInfo: {
+ *     acceptHeader: "......",
+ *     colorDepth: 24,
+ *     javaEnabled: true,
+ *     javaScriptEnabled: true,
+ *     language: "en-US",
+ *     screenHeight: 1080,
+ *     screenWidth: 1920,
+ *     timeZoneOffset: 0,
+ *     userAgent: "......",
+ *   },
+ *   countryCode: "FR",
+ *   customerUserIP: "127.0.0.1",
+ *   paymentMethodData: {
+ *     description: "......",
+ *   },
+ *   reference: "......",
+ *   referenceType: "......",
+ *   returnPath: "......",
+ *   storePaymentMethod: true,
+ * });
+ * console.log(response);
+ *
+ * ```
+ *
+ * @param {InitPaymentRequest} params - The parameters for the payment initialization
+ * @throws {Error} If required parameters are missing
+ * @returns {Promise<InitPaymentResponse>} A promise resolving to the payment initialization response
+ */
+export declare function initPayment({ browserInfo, countryCode, customerUserIP, paymentMethodData, reference, referenceType, returnPath, storePaymentMethod, }: InitPaymentRequest): Promise<InitPaymentResponse>;
+/**
+ * 💳 Gets payment details.
+ *
+ * This function gets additional details to an existing payment transaction.
+ * The `details` parameter is mandatory and validated before the request is executed.
+ *
+ * 🛠 **Endpoint**: `POST /v1/shop/payments/details` [PAY-102]
+ *
+ * | Parameter | Type     | Required | Description                    |
+ * |-----------|----------|----------|--------------------------------|
+ * | `details` | `object` | ✅       | The payment details to add.    |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to an `AddPaymentDetailsResponse` containing the result of adding payment details.
+ *
+ * @param {AddPaymentDetailsRequest} params - The parameters for adding payment details
+ * @throws {Error} If `details` is missing
+ * @returns {Promise<AddPaymentDetailsResponse>} A promise resolving to the response containing the result
+ */
+export declare function getPaymentDetails({ details, }: GetPaymentDetailsRequest): Promise<GetPaymentDetailsResponse>;
+/**
+ * 💳 Gets available payment methods.
+ *
+ * This endpoint retrieves the available payment methods based on the country, locale, amount, and currency.
+ * It provides a list of payment methods that can be used for checkout based on the merchant's Adyen configuration.
+ * The `reference` parameter is mandatory and validated before the request is executed.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/payments/methods` [PAY-501]
+ *
+ * | Parameter      | Type     | Required | Description                                    |
+ * |----------------|----------|----------|------------------------------------------------|
+ * | `reference`    | `string` | ✅       | The payment reference identifier.             |
+ * | `countryCode`  | `string` | ❌       | The country code for payment method filtering.|
+ * | `referenceType`| `string` | ❌       | The type of reference.                        |
+ * | `locale`       | `string` | ❌       | The locale for payment method localization.   |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to a `GetPaymentMethodsResponse` containing the available payment methods.
+ *
+ * @param {GetPaymentMethodsRequest} params - The parameters for retrieving payment methods
+ * @throws {Error} If `reference` is missing
+ * @returns {Promise<GetPaymentMethodsResponse>} A promise resolving to the response containing available payment methods
+ */
+export declare function getPaymentMethods({ reference, countryCode, referenceType, locale, }: GetPaymentMethodsRequest): Promise<GetPaymentMethodsResponse>;
+/**
+ * 💳 Deletes a stored payment method.
+ *
+ * This endpoint deletes a stored payment method (e.g., saved card) associated with the current shopper.
+ * It is intended for use on the storefront. If the specified ID does not exist or does not belong
+ * to the authenticated user, a 404 will be returned.
+ * The `storedPaymentMethodId` parameter is mandatory and validated before the request is executed.
+ *
+ * 🛠 **Endpoint**: `DELETE /v1/shop/payments/stored-payment-methods/{storedPaymentMethodId}` [PAY-300]
+ *
+ * | Parameter              | Type     | Required | Description                                    |
+ * |------------------------|----------|----------|------------------------------------------------|
+ * | `storedPaymentMethodId`| `string` | ✅       | The ID of the stored payment method to delete.|
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to `void` when the stored payment method is successfully deleted.
+ *
+ * @param {DeleteStoredPaymentMethodByIdRequest} params - The parameters for deleting the stored payment method
+ * @throws {Error} If `storedPaymentMethodId` is missing
+ * @returns {Promise<void>} A promise resolving when the stored payment method is successfully deleted
+ */
+export declare function deleteStoredPaymentMethodById({ storedPaymentMethodId, }: DeleteStoredPaymentMethodByIdRequest): Promise<void>;
+/**
+ * 💳 Prechecks a purchase card L3.
+ *
+ * This endpoint prechecks a purchase card L3.
+ * The `reference` parameter is mandatory and validated before the request is executed.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/payments/precheck` [PAY-502]
+ *
+ * | Parameter      | Type     | Required | Description                                    |
+ * |----------------|----------|----------|------------------------------------------------|
+ * | `reference`    | `string` | ✅       | The payment reference identifier.             |
+ * | `referenceType`| `string` | ❌       | The type of reference.                        |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to a `PrecheckPurchaseCardL3Response` containing the result of the precheck.
+ *
+ * @param {PrecheckPurchaseCardL3Request} params - The parameters for the precheck
+ * @throws {Error} If `reference` is missing
+ * @returns {Promise<PrecheckPurchaseCardL3Response>} A promise resolving to the response containing the result of the precheck
+ */
+export declare function precheckPurchaseCardL3({ reference, referenceType, }: PrecheckPurchaseCardL3Request): Promise<PrecheckPurchaseCardL3Response>;
+//# sourceMappingURL=index.d.ts.map

package/lib/services/payment/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/payment/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,oCAAoC,EACpC,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,6BAA6B,EAC7B,8BAA8B,EAC/B,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AAEH,wBAAsB,WAAW,CAAC,EAChC,WAAW,EACX,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,UAAU,EACV,kBAAkB,GACnB,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAwBnD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,iBAAiB,CAAC,EACtC,OAAO,GACR,EAAE,wBAAwB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAY/D;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,iBAAiB,CAAC,EACtC,SAAS,EACT,WAAW,EACX,aAAa,EACb,MAAM,GACP,EAAE,wBAAwB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAe/D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,6BAA6B,CAAC,EAClD,qBAAqB,GACtB,EAAE,oCAAoC,GAAG,OAAO,CAAC,IAAI,CAAC,CAMtD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,sBAAsB,CAAC,EAC3C,SAAS,EACT,aAAa,GACd,EAAE,6BAA6B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAazE"}

package/lib/services/payment/index.js

@@ -0,0 +1,220 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initPayment = initPayment;
+exports.getPaymentDetails = getPaymentDetails;
+exports.getPaymentMethods = getPaymentMethods;
+exports.deleteStoredPaymentMethodById = deleteStoredPaymentMethodById;
+exports.precheckPurchaseCardL3 = precheckPurchaseCardL3;
+const parameters_validation_1 = require("../../helpers/parameters-validation");
+const fetch_instance_1 = require("../../settings/fetch-instance");
+/**
+ * 💳 Initializes a payment transaction.
+ *
+ * This endpoint initializes a payment transaction.
+ * It supports:
+ * - Card authorizations with or without 3D Secure (3DS).
+ * - 3DS authentication flows, including redirection steps if required.
+ * - Bank transfer payment initialization using virtual IBAN feature.
+ *
+ * The response indicates the result of the transaction attempt and may contain an action
+ * (such as a redirection or bank transfer instructions) that must be followed to complete the payment.
+ *
+ * 🛠 **Endpoint**: `POST /v1/shop/payments` [PAY-101]
+ *
+ * | Parameter           | Type                | Required | Description                                    |
+ * |---------------------|---------------------|----------|------------------------------------------------|
+ * | `browserInfo`       | `BrowserInfo`       | ✅       | Browser information for 3DS authentication.   |
+ * | `countryCode`       | `string`            | ✅       | Country code for payment processing.          |
+ * | `customerUserIP`    | `string`            | ❌       | Customer's IP address.                        |
+ * | `paymentMethodData` | `PaymentMethodData` | ❌       | Payment method configuration.                 |
+ * | `reference`         | `string`            | ✅       | Payment reference identifier.                 |
+ * | `referenceType`     | `string`            | ❌       | Type of reference.                            |
+ * | `returnPath`        | `string`            | ✅       | Return URL after payment completion.          |
+ * | `storePaymentMethod`| `boolean`           | ❌       | Whether to store the payment method.          |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to an `InitPaymentResponse` containing the payment initialization result.
+ *
+ *  🛠 **Example usage**:
+ * ```ts
+ * const response = await initPayment({
+ *   browserInfo: {
+ *     acceptHeader: "......",
+ *     colorDepth: 24,
+ *     javaEnabled: true,
+ *     javaScriptEnabled: true,
+ *     language: "en-US",
+ *     screenHeight: 1080,
+ *     screenWidth: 1920,
+ *     timeZoneOffset: 0,
+ *     userAgent: "......",
+ *   },
+ *   countryCode: "FR",
+ *   customerUserIP: "127.0.0.1",
+ *   paymentMethodData: {
+ *     description: "......",
+ *   },
+ *   reference: "......",
+ *   referenceType: "......",
+ *   returnPath: "......",
+ *   storePaymentMethod: true,
+ * });
+ * console.log(response);
+ *
+ * ```
+ *
+ * @param {InitPaymentRequest} params - The parameters for the payment initialization
+ * @throws {Error} If required parameters are missing
+ * @returns {Promise<InitPaymentResponse>} A promise resolving to the payment initialization response
+ */
+async function initPayment({ browserInfo, countryCode, customerUserIP, paymentMethodData, reference, referenceType, returnPath, storePaymentMethod, }) {
+    (0, parameters_validation_1.required)({
+        browserInfo,
+        countryCode,
+        reference,
+        returnPath,
+    });
+    const { data } = await (0, fetch_instance_1.enhancedFetch)({
+        method: "POST",
+        path: `/v1/shop/payments`,
+        body: JSON.stringify({
+            browserInfo,
+            countryCode,
+            customerUserIP,
+            paymentMethodData,
+            reference,
+            referenceType,
+            returnPath,
+            storePaymentMethod,
+        }),
+    });
+    return data;
+}
+/**
+ * 💳 Gets payment details.
+ *
+ * This function gets additional details to an existing payment transaction.
+ * The `details` parameter is mandatory and validated before the request is executed.
+ *
+ * 🛠 **Endpoint**: `POST /v1/shop/payments/details` [PAY-102]
+ *
+ * | Parameter | Type     | Required | Description                    |
+ * |-----------|----------|----------|--------------------------------|
+ * | `details` | `object` | ✅       | The payment details to add.    |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to an `AddPaymentDetailsResponse` containing the result of adding payment details.
+ *
+ * @param {AddPaymentDetailsRequest} params - The parameters for adding payment details
+ * @throws {Error} If `details` is missing
+ * @returns {Promise<AddPaymentDetailsResponse>} A promise resolving to the response containing the result
+ */
+async function getPaymentDetails({ details, }) {
+    (0, parameters_validation_1.required)({ details });
+    const { data } = await (0, fetch_instance_1.enhancedFetch)({
+        method: "POST",
+        path: `/v1/shop/payments/details`,
+        body: JSON.stringify({
+            details,
+        }),
+    });
+    return data;
+}
+/**
+ * 💳 Gets available payment methods.
+ *
+ * This endpoint retrieves the available payment methods based on the country, locale, amount, and currency.
+ * It provides a list of payment methods that can be used for checkout based on the merchant's Adyen configuration.
+ * The `reference` parameter is mandatory and validated before the request is executed.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/payments/methods` [PAY-501]
+ *
+ * | Parameter      | Type     | Required | Description                                    |
+ * |----------------|----------|----------|------------------------------------------------|
+ * | `reference`    | `string` | ✅       | The payment reference identifier.             |
+ * | `countryCode`  | `string` | ❌       | The country code for payment method filtering.|
+ * | `referenceType`| `string` | ❌       | The type of reference.                        |
+ * | `locale`       | `string` | ❌       | The locale for payment method localization.   |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to a `GetPaymentMethodsResponse` containing the available payment methods.
+ *
+ * @param {GetPaymentMethodsRequest} params - The parameters for retrieving payment methods
+ * @throws {Error} If `reference` is missing
+ * @returns {Promise<GetPaymentMethodsResponse>} A promise resolving to the response containing available payment methods
+ */
+async function getPaymentMethods({ reference, countryCode, referenceType, locale, }) {
+    (0, parameters_validation_1.required)({ reference });
+    const { data } = await (0, fetch_instance_1.enhancedFetch)({
+        method: "GET",
+        path: `/v1/shop/payments/payment-methods`,
+        params: {
+            reference,
+            countryCode,
+            referenceType,
+            locale,
+        },
+    });
+    return data;
+}
+/**
+ * 💳 Deletes a stored payment method.
+ *
+ * This endpoint deletes a stored payment method (e.g., saved card) associated with the current shopper.
+ * It is intended for use on the storefront. If the specified ID does not exist or does not belong
+ * to the authenticated user, a 404 will be returned.
+ * The `storedPaymentMethodId` parameter is mandatory and validated before the request is executed.
+ *
+ * 🛠 **Endpoint**: `DELETE /v1/shop/payments/stored-payment-methods/{storedPaymentMethodId}` [PAY-300]
+ *
+ * | Parameter              | Type     | Required | Description                                    |
+ * |------------------------|----------|----------|------------------------------------------------|
+ * | `storedPaymentMethodId`| `string` | ✅       | The ID of the stored payment method to delete.|
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to `void` when the stored payment method is successfully deleted.
+ *
+ * @param {DeleteStoredPaymentMethodByIdRequest} params - The parameters for deleting the stored payment method
+ * @throws {Error} If `storedPaymentMethodId` is missing
+ * @returns {Promise<void>} A promise resolving when the stored payment method is successfully deleted
+ */
+async function deleteStoredPaymentMethodById({ storedPaymentMethodId, }) {
+    (0, parameters_validation_1.required)({ storedPaymentMethodId });
+    await (0, fetch_instance_1.enhancedFetch)({
+        method: "DELETE",
+        path: `/v1/shop/payments/stored-payment-methods/${storedPaymentMethodId}`,
+    });
+}
+/**
+ * 💳 Prechecks a purchase card L3.
+ *
+ * This endpoint prechecks a purchase card L3.
+ * The `reference` parameter is mandatory and validated before the request is executed.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/payments/precheck` [PAY-502]
+ *
+ * | Parameter      | Type     | Required | Description                                    |
+ * |----------------|----------|----------|------------------------------------------------|
+ * | `reference`    | `string` | ✅       | The payment reference identifier.             |
+ * | `referenceType`| `string` | ❌       | The type of reference.                        |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to a `PrecheckPurchaseCardL3Response` containing the result of the precheck.
+ *
+ * @param {PrecheckPurchaseCardL3Request} params - The parameters for the precheck
+ * @throws {Error} If `reference` is missing
+ * @returns {Promise<PrecheckPurchaseCardL3Response>} A promise resolving to the response containing the result of the precheck
+ */
+async function precheckPurchaseCardL3({ reference, referenceType, }) {
+    (0, parameters_validation_1.required)({ reference });
+    const { data } = await (0, fetch_instance_1.enhancedFetch)({
+        method: "GET",
+        path: `/v1/shop/payments/precheck`,
+        params: {
+            reference,
+            referenceType,
+        },
+    });
+    return data;
+}
+//# sourceMappingURL=index.js.map

package/lib/services/payment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/payment/index.ts"],"names":[],"mappings":";;AA2EA,kCAiCC;AAqBD,8CAcC;AAyBD,8CAoBC;AAuBD,sEAQC;AAsBD,wDAgBC;AAjQD,+EAA+D;AAC/D,kEAA8D;AAa9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AAEI,KAAK,UAAU,WAAW,CAAC,EAChC,WAAW,EACX,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,UAAU,EACV,kBAAkB,GACC;IACnB,IAAA,gCAAQ,EAAC;QACP,WAAW;QACX,WAAW;QACX,SAAS;QACT,UAAU;KACX,CAAC,CAAC;IAEH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAA,8BAAa,EAAsB;QACxD,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,mBAAmB;QACzB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,WAAW;YACX,WAAW;YACX,cAAc;YACd,iBAAiB;YACjB,SAAS;YACT,aAAa;YACb,UAAU;YACV,kBAAkB;SACnB,CAAC;KACH,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACI,KAAK,UAAU,iBAAiB,CAAC,EACtC,OAAO,GACkB;IACzB,IAAA,gCAAQ,EAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAEtB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAA,8BAAa,EAA4B;QAC9D,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,2BAA2B;QACjC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,OAAO;SACR,CAAC;KACH,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACI,KAAK,UAAU,iBAAiB,CAAC,EACtC,SAAS,EACT,WAAW,EACX,aAAa,EACb,MAAM,GACmB;IACzB,IAAA,gCAAQ,EAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAExB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAA,8BAAa,EAA4B;QAC9D,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,mCAAmC;QACzC,MAAM,EAAE;YACN,SAAS;YACT,WAAW;YACX,aAAa;YACb,MAAM;SACP;KACF,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACI,KAAK,UAAU,6BAA6B,CAAC,EAClD,qBAAqB,GACgB;IACrC,IAAA,gCAAQ,EAAC,EAAE,qBAAqB,EAAE,CAAC,CAAC;IACpC,MAAM,IAAA,8BAAa,EAAO;QACxB,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,4CAA4C,qBAAqB,EAAE;KAC1E,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACI,KAAK,UAAU,sBAAsB,CAAC,EAC3C,SAAS,EACT,aAAa,GACiB;IAC9B,IAAA,gCAAQ,EAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAExB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAA,8BAAa,EAAiC;QACnE,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,4BAA4B;QAClC,MAAM,EAAE;YACN,SAAS;YACT,aAAa;SACd;KACF,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC;AACd,CAAC"}

package/lib/services/payment/module.d.ts

@@ -0,0 +1,11 @@
+/**
+ * DJUST SDK Payment Module
+ * Re-exports all payment-related types and service.
+ *
+ * @module services/payment
+ * @since 2.17.0
+ */
+export type { BrowserInfo, PaymentMethodData, InitPaymentParams, GetPaymentDetailsParams, GetPaymentMethodsParams, DeleteStoredPaymentMethodParams, PrecheckPurchaseCardL3Params, PaymentAction, InitPaymentResponse, GetPaymentDetailsResponse, PaymentMethod, StoredPaymentMethod, GetPaymentMethodsResponse, PrecheckPurchaseCardL3Response, } from "./types";
+export { PaymentEndpoints, type PaymentEndpoint } from "./endpoints";
+export { PaymentService } from "./payment.service";
+//# sourceMappingURL=module.d.ts.map

package/lib/services/payment/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/services/payment/module.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,+BAA+B,EAC/B,4BAA4B,EAC5B,aAAa,EACb,mBAAmB,EACnB,yBAAyB,EACzB,aAAa,EACb,mBAAmB,EACnB,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/services/payment/module.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * DJUST SDK Payment Module
+ * Re-exports all payment-related types and service.
+ *
+ * @module services/payment
+ * @since 2.17.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaymentService = exports.PaymentEndpoints = void 0;
+var endpoints_1 = require("./endpoints");
+Object.defineProperty(exports, "PaymentEndpoints", { enumerable: true, get: function () { return endpoints_1.PaymentEndpoints; } });
+var payment_service_1 = require("./payment.service");
+Object.defineProperty(exports, "PaymentService", { enumerable: true, get: function () { return payment_service_1.PaymentService; } });
+//# sourceMappingURL=module.js.map

package/lib/services/payment/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../src/services/payment/module.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAmBH,yCAAqE;AAA5D,6GAAA,gBAAgB,OAAA;AACzB,qDAAmD;AAA1C,iHAAA,cAAc,OAAA"}

package/lib/services/payment/payment.service.d.ts

@@ -0,0 +1,224 @@
+/**
+ * # Payment Service
+ *
+ * Payment processing and management for B2B commerce.
+ *
+ * ## Features
+ * - Payment initialization
+ * - Multiple payment methods
+ * - Stored payment methods
+ * - Purchase card (L3) support
+ *
+ * @module services/payment
+ * @since 2.17.0
+ */
+import { BaseService } from "../base.service";
+import type { RequestContext } from "../../client/transport";
+import type { InitPaymentParams, GetPaymentDetailsParams, GetPaymentMethodsParams, DeleteStoredPaymentMethodParams, PrecheckPurchaseCardL3Params, InitPaymentResponse, GetPaymentDetailsResponse, GetPaymentMethodsResponse, PrecheckPurchaseCardL3Response } from "./types";
+/**
+ * Service for payment operations.
+ *
+ * Handles payment processing:
+ * - Payment initialization with multiple providers
+ * - Payment method management
+ * - Stored payment methods for returning customers
+ * - B2B-specific features (Purchase Cards)
+ *
+ * @example
+ * ```typescript
+ * import { createDjustClient } from '@djust-b2b/djust-front-sdk';
+ *
+ * const client = createDjustClient({ baseUrl, clientId, apiKey });
+ *
+ * // Get available payment methods
+ * const methods = await client.payment.getPaymentMethods({
+ *   reference: 'order-123',
+ *   countryCode: 'US',
+ * });
+ *
+ * // Initialize payment
+ * const payment = await client.payment.initPayment({
+ *   reference: 'order-123',
+ *   countryCode: 'US',
+ *   returnPath: '/checkout/complete',
+ *   browserInfo: { ... },
+ * });
+ * ```
+ */
+export declare class PaymentService extends BaseService {
+    readonly serviceName = "payment";
+    /**
+     * Initialize a payment session.
+     *
+     * Starts the payment flow with the configured payment provider.
+     *
+     * **Endpoint**: `POST /v1/shop/payments [PAY-100]`
+     *
+     * | Parameter            | Type     | Required | Description                    |
+     * |----------------------|----------|----------|--------------------------------|
+     * | `browserInfo`        | `object` | Yes      | Browser detection info         |
+     * | `countryCode`        | `string` | Yes      | Customer's country             |
+     * | `reference`          | `string` | Yes      | Order reference                |
+     * | `returnPath`         | `string` | Yes      | URL for payment completion     |
+     * | `referenceType`      | `string` | No       | Reference type (order, quote)  |
+     * | `paymentMethodData`  | `object` | No       | Selected payment method        |
+     * | `storePaymentMethod` | `boolean`| No       | Save for future use            |
+     *
+     * @example
+     * ```typescript
+     * const payment = await client.payment.initPayment({
+     *   reference: 'ORD-2024-001',
+     *   countryCode: 'US',
+     *   returnPath: 'https://myapp.com/checkout/complete',
+     *   browserInfo: {
+     *     acceptHeader: navigator.language,
+     *     colorDepth: screen.colorDepth,
+     *     language: navigator.language,
+     *     screenHeight: screen.height,
+     *     screenWidth: screen.width,
+     *     timeZoneOffset: new Date().getTimezoneOffset(),
+     *     userAgent: navigator.userAgent,
+     *   },
+     *   paymentMethodData: { type: 'scheme' },
+     * });
+     *
+     * if (payment.action) {
+     *   // Redirect or handle 3DS
+     *   window.location.href = payment.action.url;
+     * }
+     * ```
+     *
+     * @param params - Payment initialization parameters
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If required parameters are missing
+     * @returns Payment session data with action if required
+     */
+    initPayment(params: InitPaymentParams, context?: RequestContext): Promise<InitPaymentResponse>;
+    /**
+     * Complete payment after 3DS or redirect.
+     *
+     * Called after customer returns from payment provider redirect.
+     *
+     * **Endpoint**: `POST /v1/shop/payments/details [PAY-101]`
+     *
+     * | Parameter | Type     | Required | Description              |
+     * |-----------|----------|----------|--------------------------|
+     * | `details` | `object` | Yes      | Provider-specific data   |
+     *
+     * @example
+     * ```typescript
+     * // After 3DS redirect back to your site
+     * const urlParams = new URLSearchParams(window.location.search);
+     *
+     * const result = await client.payment.getPaymentDetails({
+     *   details: {
+     *     redirectResult: urlParams.get('redirectResult'),
+     *   },
+     * });
+     *
+     * if (result.resultCode === 'Authorised') {
+     *   // Payment successful
+     * }
+     * ```
+     *
+     * @param params - Payment details from provider
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If details is missing
+     * @returns Payment result
+     */
+    getPaymentDetails(params: GetPaymentDetailsParams, context?: RequestContext): Promise<GetPaymentDetailsResponse>;
+    /**
+     * Get available payment methods.
+     *
+     * Returns payment options available for the order/customer.
+     *
+     * **Endpoint**: `GET /v1/shop/payments/methods [PAY-102]`
+     *
+     * | Parameter       | Type     | Required | Description              |
+     * |-----------------|----------|----------|--------------------------|
+     * | `reference`     | `string` | Yes      | Order reference          |
+     * | `countryCode`   | `string` | No       | Customer's country       |
+     * | `referenceType` | `string` | No       | Reference type           |
+     * | `locale`        | `string` | No       | Locale for display       |
+     *
+     * @example
+     * ```typescript
+     * const methods = await client.payment.getPaymentMethods({
+     *   reference: 'ORD-2024-001',
+     *   countryCode: 'US',
+     *   locale: 'en-US',
+     * });
+     *
+     * console.log('Available methods:');
+     * methods.paymentMethods.forEach(m => {
+     *   console.log(`- ${m.name} (${m.type})`);
+     * });
+     *
+     * if (methods.storedPaymentMethods?.length) {
+     *   console.log('Saved cards:', methods.storedPaymentMethods.length);
+     * }
+     * ```
+     *
+     * @param params - Query parameters
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If reference is missing
+     * @returns Available payment methods including stored cards
+     */
+    getPaymentMethods(params: GetPaymentMethodsParams, context?: RequestContext): Promise<GetPaymentMethodsResponse>;
+    /**
+     * Delete a stored payment method.
+     *
+     * Removes a saved card/payment method from customer's account.
+     *
+     * **Endpoint**: `DELETE /v1/shop/payments/stored-payment-methods/{id} [PAY-103]`
+     *
+     * | Parameter               | Type     | Required | Description              |
+     * |-------------------------|----------|----------|--------------------------|
+     * | `storedPaymentMethodId` | `string` | Yes      | Stored method ID         |
+     *
+     * @example
+     * ```typescript
+     * await client.payment.deleteStoredPaymentMethod({
+     *   storedPaymentMethodId: 'pm_card_visa_1234',
+     * });
+     *
+     * console.log('Card removed successfully');
+     * ```
+     *
+     * @param params - Stored method identification
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If storedPaymentMethodId is missing
+     * @throws {NotFoundError} If stored method doesn't exist
+     */
+    deleteStoredPaymentMethod(params: DeleteStoredPaymentMethodParams, context?: RequestContext): Promise<void>;
+    /**
+     * Pre-check for Purchase Card Level 3 data.
+     *
+     * Validates if L3 data is required for B2B purchase cards.
+     *
+     * **Endpoint**: `GET /v1/shop/payments/precheck [PAY-104]`
+     *
+     * | Parameter       | Type     | Required | Description              |
+     * |-----------------|----------|----------|--------------------------|
+     * | `reference`     | `string` | Yes      | Order reference          |
+     * | `referenceType` | `string` | No       | Reference type           |
+     *
+     * @example
+     * ```typescript
+     * const precheck = await client.payment.precheckPurchaseCardL3({
+     *   reference: 'ORD-2024-001',
+     * });
+     *
+     * if (precheck.requiresL3Data) {
+     *   // Collect additional line item data for purchase card
+     * }
+     * ```
+     *
+     * @param params - Order reference
+     * @param context - Optional SSR request context
+     * @throws {ValidationError} If reference is missing
+     * @returns L3 requirements check result
+     */
+    precheckPurchaseCardL3(params: PrecheckPurchaseCardL3Params, context?: RequestContext): Promise<PrecheckPurchaseCardL3Response>;
+}
+//# sourceMappingURL=payment.service.d.ts.map

package/lib/services/payment/payment.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.service.d.ts","sourceRoot":"","sources":["../../../src/services/payment/payment.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,KAAK,EACV,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,+BAA+B,EAC/B,4BAA4B,EAC5B,mBAAmB,EACnB,yBAAyB,EACzB,yBAAyB,EACzB,8BAA8B,EAC/B,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C,QAAQ,CAAC,WAAW,aAAa;IAEjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACG,WAAW,CACf,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,mBAAmB,CAAC;IA2B/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACG,iBAAiB,CACrB,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,yBAAyB,CAAC;IAarC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACG,iBAAiB,CACrB,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,yBAAyB,CAAC;IAkBrC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,yBAAyB,CAC7B,MAAM,EAAE,+BAA+B,EACvC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;IAchB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,sBAAsB,CAC1B,MAAM,EAAE,4BAA4B,EACpC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,8BAA8B,CAAC;CAe3C"}