@phonepe-pg/pg-sdk-node 2.0.4

package/dist/src/payments/v2/CustomCheckoutClient.js

@@ -0,0 +1,229 @@
+"use strict";
+/*
+ *  Copyright (c) 2025 Original Author(s), PhonePe India Pvt. Ltd.
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomCheckoutClient = void 0;
+const class_transformer_1 = require("class-transformer");
+const BaseClient_1 = require("../../common/BaseClient");
+const CommonUtils_1 = require("../../common/CommonUtils");
+const Exceptions_1 = require("../../common/exception/Exceptions");
+const HttpMethodType_1 = require("../../common/http/HttpMethodType");
+const Env_1 = require("../../Env");
+const Constants_1 = require("./customcheckout/Constants");
+const CallbackResponse_1 = require("../../common/models/response/CallbackResponse");
+const CustomCheckoutPayResponse_1 = require("./models/response/CustomCheckoutPayResponse");
+const OrderStatusResponse_1 = require("../../common/models/response/OrderStatusResponse");
+const RefundResponse_1 = require("../../common/models/response/RefundResponse");
+const RefundStatusResponse_1 = require("../../common/models/response/RefundStatusResponse");
+const PaymentFlowType_1 = require("../../common/models/PaymentFlowType");
+const CreateSdkOrderResponse_1 = require("./models/response/CreateSdkOrderResponse");
+const Constants_2 = require("../../common/exception/Constants");
+const Headers_1 = require("../../common/constants/Headers");
+const EventType_1 = require("../../common/events/models/enums/EventType");
+const EventState_1 = require("../../common/events/models/enums/EventState");
+const EventBuillder_1 = require("../../common/events/builders/EventBuillder");
+class CustomCheckoutClient extends BaseClient_1.BaseClient {
+    constructor(clientId, clientSecret, clientVersion, env, shouldPublishEvents) {
+        super(clientId, clientSecret, clientVersion, env, shouldPublishEvents);
+        /**
+         * Initiate a Pay Order
+         *
+         * @param payRequest Request required to initiate the order. Depending on the instrument type, different builders can be used
+         * @return Promise<CustomCheckoutPayResponse> which contains the data according to the instrument used
+         */
+        this.pay = (payRequest) => __awaiter(this, void 0, void 0, function* () {
+            const url = Constants_1.CustomCheckoutConstants.PAY_API;
+            const headers = payRequest.deviceOS
+                ? Object.assign(Object.assign({}, this.headers), { [Headers_1.Headers.X_DEVICE_OS]: payRequest.deviceOS }) : this.headers;
+            try {
+                const response = yield this.requestViaAuthRefresh(HttpMethodType_1.HttpMethodType.POST, url, CustomCheckoutPayResponse_1.CustomCheckoutPayResponse, headers, payRequest);
+                this.eventPublisher.send((0, EventBuillder_1.buildCustomCheckoutPayRequest)(EventState_1.EventState.SUCCESS, EventType_1.EventType.PAY_SUCCESS, payRequest, url));
+                return response;
+            }
+            catch (error) {
+                this.eventPublisher.send((0, EventBuillder_1.buildCustomCheckoutPayRequest)(EventState_1.EventState.FAILED, EventType_1.EventType.PAY_FAILED, payRequest, url, error));
+                throw error;
+            }
+        });
+        /**
+         * Gets status of an order
+         *
+         * @param merchantOrderId Order id generated by merchant
+         * @param details         true -> order status has all attempt details under paymentDetails list
+         *                        false -> order status has only latest attempt details under paymentDetails list
+         * @return Promise<OrderStatusResponse> which contains the details about the order
+         */
+        this.getOrderStatus = (merchantOrderId, details = false) => __awaiter(this, void 0, void 0, function* () {
+            const url = Constants_1.CustomCheckoutConstants.ORDER_STATUS_API.replace('{ORDER_ID}', merchantOrderId);
+            try {
+                const response = yield this.requestViaAuthRefresh(HttpMethodType_1.HttpMethodType.GET, url, OrderStatusResponse_1.OrderStatusResponse, this.headers, {}, { [Constants_1.CustomCheckoutConstants.ORDER_DETAILS]: details.toString() });
+                this.eventPublisher.send((0, EventBuillder_1.buildOrderStatusEvent)(EventState_1.EventState.SUCCESS, merchantOrderId, PaymentFlowType_1.PaymentFlowType.PG, url, EventType_1.EventType.ORDER_STATUS_SUCCESS));
+                return response;
+            }
+            catch (error) {
+                this.eventPublisher.send((0, EventBuillder_1.buildOrderStatusEvent)(EventState_1.EventState.FAILED, merchantOrderId, PaymentFlowType_1.PaymentFlowType.PG, url, EventType_1.EventType.ORDER_STATUS_FAILED, error));
+                throw error;
+            }
+        });
+        /**
+         * Initiate a refund of an order which is in completed state
+         *
+         * @param refundRequest Request required to initiate the order. It is build using RefundRequest.builder()
+         * @return Promise<RefundResponse> which contains the details about the refund
+         */
+        this.refund = (refundRequest) => __awaiter(this, void 0, void 0, function* () {
+            const url = Constants_1.CustomCheckoutConstants.REFUND_API;
+            try {
+                const response = yield this.requestViaAuthRefresh(HttpMethodType_1.HttpMethodType.POST, url, RefundResponse_1.RefundResponse, this.headers, refundRequest);
+                this.eventPublisher.send((0, EventBuillder_1.buildRefundEvent)(EventState_1.EventState.SUCCESS, refundRequest, url, PaymentFlowType_1.PaymentFlowType.PG, EventType_1.EventType.REFUND_SUCCESS));
+                return response;
+            }
+            catch (error) {
+                this.eventPublisher.send((0, EventBuillder_1.buildRefundEvent)(EventState_1.EventState.FAILED, refundRequest, url, PaymentFlowType_1.PaymentFlowType.PG, EventType_1.EventType.REFUND_FAILED, error));
+                throw error;
+            }
+        });
+        /**
+         * Gets the status of refund
+         *
+         * @param refundId Generated by merchant at the time of initiating the refund
+         * @return Promise<RefundStatusResponse> which contains the status about the refund
+         */
+        this.getRefundStatus = (refundId) => __awaiter(this, void 0, void 0, function* () {
+            const url = Constants_1.CustomCheckoutConstants.REFUND_STATUS_API.replace('{REFUND_ID}', refundId);
+            try {
+                const response = yield this.requestViaAuthRefresh(HttpMethodType_1.HttpMethodType.GET, url, RefundStatusResponse_1.RefundStatusResponse, this.headers);
+                this.eventPublisher.send((0, EventBuillder_1.buildRefundStatusEvent)(EventState_1.EventState.SUCCESS, EventType_1.EventType.REFUND_STATUS_SUCCESS, refundId, url, PaymentFlowType_1.PaymentFlowType.PG));
+                return response;
+            }
+            catch (error) {
+                this.eventPublisher.send((0, EventBuillder_1.buildRefundStatusEvent)(EventState_1.EventState.FAILED, EventType_1.EventType.REFUND_STATUS_FAILED, refundId, url, PaymentFlowType_1.PaymentFlowType.PG));
+                throw error;
+            }
+        });
+        /**
+         * Gets the status of a transaction attempted
+         *
+         * @param transactionId Transaction attempt id generated by PhonePe
+         * @return Promise<OrderStatusResponse> which contains the details about that specific transactionId
+         */
+        this.getTransactionStatus = (transactionId) => __awaiter(this, void 0, void 0, function* () {
+            const url = Constants_1.CustomCheckoutConstants.TRANSACTION_STATUS_API.replace('{TRANSACTION_ID}', transactionId);
+            try {
+                const response = yield this.requestViaAuthRefresh(HttpMethodType_1.HttpMethodType.GET, url, OrderStatusResponse_1.OrderStatusResponse, this.headers);
+                this.eventPublisher.send((0, EventBuillder_1.buildTransactionStatusEvent)(EventState_1.EventState.SUCCESS, EventType_1.EventType.TRANSACTION_STATUS_SUCCESS, transactionId, url, PaymentFlowType_1.PaymentFlowType.PG));
+                return response;
+            }
+            catch (error) {
+                this.eventPublisher.send((0, EventBuillder_1.buildTransactionStatusEvent)(EventState_1.EventState.FAILED, EventType_1.EventType.TRANSACTION_STATUS_FAILED, transactionId, url, PaymentFlowType_1.PaymentFlowType.PG, error));
+                throw error;
+            }
+        });
+        /**
+         * Create order token for SDK integrated order requests
+         *
+         * @param sdkRequest Request object build using CreateSdkOrderRequest.builder()
+         * @return Promise<CreateSdkOrderResponse> which contains token details to be consumed by the UI
+         */
+        this.createSdkOrder = (sdkRequest) => __awaiter(this, void 0, void 0, function* () {
+            const url = Constants_1.CustomCheckoutConstants.CREATE_ORDER_API;
+            try {
+                const response = yield this.requestViaAuthRefresh(HttpMethodType_1.HttpMethodType.POST, url, CreateSdkOrderResponse_1.CreateSdkOrderResponse, this.headers, sdkRequest);
+                this.eventPublisher.send((0, EventBuillder_1.buildCreateSdkOrderEvent)(EventState_1.EventState.SUCCESS, EventType_1.EventType.CREATE_SDK_ORDER_SUCCESS, sdkRequest, url, PaymentFlowType_1.PaymentFlowType.PG));
+                return response;
+            }
+            catch (error) {
+                this.eventPublisher.send((0, EventBuillder_1.buildCreateSdkOrderEvent)(EventState_1.EventState.SUCCESS, EventType_1.EventType.CREATE_SDK_ORDER_SUCCESS, sdkRequest, url, PaymentFlowType_1.PaymentFlowType.PG));
+                throw error;
+            }
+        });
+        /**
+         * Validate if the callback is valid
+         *
+         * @param username      username set by the merchant on the dashboard
+         * @param password      password set by the merchant on the dashboard
+         * @param authorization String data under `authorization` key of response headers
+         * @param responseBody  Callback response body
+         * @return CallbackResponse Deserialized callback body
+         * @throws PhonePeException when callback is not valid
+         */
+        this.validateCallback = (username, password, authorization, responseBody) => {
+            if (!CommonUtils_1.CommonUtils.isCallbackValid(username, password, authorization)) {
+                throw new Exceptions_1.PhonePeException('Invalid Callback', 417);
+            }
+            const parsedBody = JSON.parse(responseBody);
+            return (0, class_transformer_1.plainToClass)(CallbackResponse_1.CallbackResponse, parsedBody);
+        };
+        this.prepareHeaders = () => {
+            return {
+                [Headers_1.Headers.CONTENT_TYPE]: Headers_1.Headers.APPLICATION_JSON,
+                [Headers_1.Headers.SOURCE]: Headers_1.Headers.INTEGRATION,
+                [Headers_1.Headers.SOURCE_VERSION]: Headers_1.Headers.API_VERSION,
+                [Headers_1.Headers.SOURCE_PLATFORM]: Headers_1.Headers.SDK_TYPE,
+                [Headers_1.Headers.SOURCE_PLATFORM_VERSION]: Headers_1.Headers.SDK_VERSION,
+            };
+        };
+        this.eventPublisher.send((0, EventBuillder_1.buildInitClientEvent)(EventType_1.EventType.CUSTOM_CHECKOUT_CLIENT_INITIALIZED, PaymentFlowType_1.PaymentFlowType.PG));
+        this.headers = this.prepareHeaders();
+    }
+}
+exports.CustomCheckoutClient = CustomCheckoutClient;
+/**
+ * Generates a CustomCheckout Client for interacting with the PhonePe APIs
+ *
+ * @param clientId      Unique clientId assigned to merchant by PhonePe
+ * @param clientSecret  Secret provided by PhonePe
+ * @param clientVersion The client version used for secure transactions
+ * @param env           Set to `Env.SANDBOX` for the SANDBOX environment  or `Env.PRODUCTION` for the production
+ *                      environment.
+ * @param shouldPublishEvents When true, events are sent to PhonePe providing smoother experience
+ * @return CustomCheckoutClient object for interacting with the PhonePe APIs
+ */
+CustomCheckoutClient.getInstance = (clientId, clientSecret, clientVersion, env, shouldPublishEvents = true) => {
+    shouldPublishEvents = shouldPublishEvents && env == Env_1.Env.PRODUCTION;
+    if (CustomCheckoutClient._client == undefined) {
+        CustomCheckoutClient._client = new CustomCheckoutClient(clientId, clientSecret, clientVersion, env, shouldPublishEvents);
+        return CustomCheckoutClient._client;
+    }
+    const requestedClientSHA = CommonUtils_1.CommonUtils.calculateSha256({
+        clientId: clientId,
+        clientSecret: clientSecret,
+        clientVersion: clientVersion,
+        env: env,
+        shouldPublishEvents: shouldPublishEvents,
+        paymentFlowType: PaymentFlowType_1.PaymentFlowType.PG,
+    });
+    const cachedClientSHA = CommonUtils_1.CommonUtils.calculateSha256({
+        clientId: CustomCheckoutClient._client.merchantConfig.clientId,
+        clientSecret: CustomCheckoutClient._client.merchantConfig.clientSecret,
+        clientVersion: CustomCheckoutClient._client.merchantConfig.clientVersion,
+        env: CustomCheckoutClient._client.env,
+        shouldPublishEvents: CustomCheckoutClient._client.shouldPublishEvents,
+        paymentFlowType: PaymentFlowType_1.PaymentFlowType.PG,
+    });
+    if (requestedClientSHA == cachedClientSHA)
+        return CustomCheckoutClient._client;
+    throw new Exceptions_1.PhonePeException(Constants_2.Constants.CLIENT_EXCEPTION(CustomCheckoutClient._client.constructor.name));
+};

package/dist/src/payments/v2/StandardCheckoutClient.d.ts

@@ -0,0 +1,86 @@
+import { BaseClient } from '../../common/BaseClient';
+import { Env } from '../../Env';
+import { StandardCheckoutPayRequest } from './models/request/StandardCheckoutPayRequest';
+import { OrderStatusResponse } from '../../common/models/response/OrderStatusResponse';
+import { StandardCheckoutPayResponse } from './models/response/StandardCheckoutPayResponse';
+import { RefundRequest } from '../../common/models/request/RefundRequest';
+import { RefundResponse } from '../../common/models/response/RefundResponse';
+import { RefundStatusResponse } from '../../common/models/response/RefundStatusResponse';
+import { CallbackResponse } from '../../common/models/response/CallbackResponse';
+import { CreateSdkOrderRequest } from './models/request/CreateSdkOrderRequest';
+import { CreateSdkOrderResponse } from './models/response/CreateSdkOrderResponse';
+export declare class StandardCheckoutClient extends BaseClient {
+    private static _client;
+    private headers;
+    private constructor();
+    /**
+     * Generates a StandardCheckout Client for interacting with the PhonePe APIs
+     *
+     * @param clientId      Unique clientId assigned to merchant by PhonePe
+     * @param clientSecret  Secret provided by PhonePe
+     * @param clientVersion The client version used for secure transactions
+     * @param env           Set to `Env.SANDBOX` for the SANDBOX environment  or `Env.PRODUCTION` for the production
+     *                      environment.
+     * @param shouldPublishEvents When true, events are sent to PhonePe providing smoother experience
+     * @return StandardCheckoutClient object for interacting with the PhonePe APIs
+     */
+    static getInstance: (clientId: string, clientSecret: string, clientVersion: number, env: Env, shouldPublishEvents?: boolean) => StandardCheckoutClient;
+    /**
+     * Initiate a pay order for Standard Checkout
+     *
+     * @param payRequest Request required to initiate the order. It is build using StandardCheckoutPayRequest.builder()
+     * @return Promise<StandardCheckoutPayResponse> which contains the url for payment gateway
+     */
+    pay: (payRequest: StandardCheckoutPayRequest) => Promise<StandardCheckoutPayResponse>;
+    /**
+     * Gets the status of the order
+     *
+     * @param merchantOrderId Generated by the merchant at the time of initiating the order
+     * @param details         true -> order status has all attempt details under paymentDetails list
+     * false -> order status has only latest attempt details under paymentDetails list
+     * @return Promise<OrderStatusResponse> which contains the details about the order
+     */
+    getOrderStatus: (merchantOrderId: string, details?: boolean) => Promise<OrderStatusResponse>;
+    /**
+     * Initiate a refund of an order which is in completed state
+     *
+     * @param refundRequest Request required to initiate the order. It is build using RefundRequest.builder()
+     * @return Promise<RefundResponse> which contains the details about the refund
+     */
+    refund: (refundRequest: RefundRequest) => Promise<RefundResponse>;
+    /**
+     * Gets the status of refund
+     *
+     * @param refundId Generated by merchant at the time of initiating the refund
+     * @return Promise<RefundStatusResponse> which contains the status about the refund
+     */
+    getRefundStatus: (refundId: string) => Promise<RefundStatusResponse>;
+    /**
+     * Gets the status of a transaction attempted
+     *
+     * @param transactionId Transaction attempt id generated by PhonePe
+     * @return Promise<OrderStatusResponse> which contains the details about that specific transactionId
+     */
+    getTransactionStatus: (transactionId: string) => Promise<OrderStatusResponse>;
+    /**
+     * Create order token for SDK integrated order requests
+     *
+     * @param sdkRequest Request object build using CreateSdkOrderRequest.builder()
+     * @return Promise<CreateSdkOrderResponse> which contains token details to be consumed by the UI
+     */
+    createSdkOrder: (sdkRequest: CreateSdkOrderRequest) => Promise<CreateSdkOrderResponse>;
+    /**
+     * Validate if the callback is valid
+     *
+     * @param username      username set by the merchant on the dashboard
+     * @param password      password set by the merchant on the dashboard
+     * @param authorization String data under `authorization` key of response headers
+     * @param responseBody  Callback response body
+     * @return CallbackResponse Deserialized callback body
+     * @throws PhonePeException when callback is not valid
+     */
+    validateCallback: (username: string, password: string, authorization: string, responseBody: string) => CallbackResponse;
+    prepareHeaders: () => {
+        [x: string]: string;
+    };
+}

package/dist/src/payments/v2/StandardCheckoutClient.js

@@ -0,0 +1,227 @@
+"use strict";
+/*
+ *  Copyright (c) 2025 Original Author(s), PhonePe India Pvt. Ltd.
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StandardCheckoutClient = void 0;
+const BaseClient_1 = require("../../common/BaseClient");
+const CommonUtils_1 = require("../../common/CommonUtils");
+const Exceptions_1 = require("../../common/exception/Exceptions");
+const HttpMethodType_1 = require("../../common/http/HttpMethodType");
+const Env_1 = require("../../Env");
+const OrderStatusResponse_1 = require("../../common/models/response/OrderStatusResponse");
+const StandardCheckoutPayResponse_1 = require("./models/response/StandardCheckoutPayResponse");
+const Constants_1 = require("./standardcheckout/Constants");
+const RefundResponse_1 = require("../../common/models/response/RefundResponse");
+const RefundStatusResponse_1 = require("../../common/models/response/RefundStatusResponse");
+const class_transformer_1 = require("class-transformer");
+const CallbackResponse_1 = require("../../common/models/response/CallbackResponse");
+const PaymentFlowType_1 = require("../../common/models/PaymentFlowType");
+const CreateSdkOrderResponse_1 = require("./models/response/CreateSdkOrderResponse");
+const Constants_2 = require("../../common/exception/Constants");
+const Headers_1 = require("../../common/constants/Headers");
+const EventType_1 = require("../../common/events/models/enums/EventType");
+const EventState_1 = require("../../common/events/models/enums/EventState");
+const EventBuillder_1 = require("../../common/events/builders/EventBuillder");
+class StandardCheckoutClient extends BaseClient_1.BaseClient {
+    constructor(clientId, clientSecret, clientVersion, env, shouldPublishEvents) {
+        super(clientId, clientSecret, clientVersion, env, shouldPublishEvents);
+        /**
+         * Initiate a pay order for Standard Checkout
+         *
+         * @param payRequest Request required to initiate the order. It is build using StandardCheckoutPayRequest.builder()
+         * @return Promise<StandardCheckoutPayResponse> which contains the url for payment gateway
+         */
+        this.pay = (payRequest) => __awaiter(this, void 0, void 0, function* () {
+            const url = Constants_1.StandardCheckoutContants.PAY_API;
+            try {
+                const response = yield this.requestViaAuthRefresh(HttpMethodType_1.HttpMethodType.POST, url, StandardCheckoutPayResponse_1.StandardCheckoutPayResponse, this.headers, payRequest);
+                this.eventPublisher.send((0, EventBuillder_1.buildStandardCheckoutPayEvent)(EventState_1.EventState.SUCCESS, EventType_1.EventType.PAY_SUCCESS, payRequest, url));
+                return response;
+            }
+            catch (error) {
+                this.eventPublisher.send((0, EventBuillder_1.buildStandardCheckoutPayEvent)(EventState_1.EventState.FAILED, EventType_1.EventType.PAY_FAILED, payRequest, url, error));
+                throw error;
+            }
+        });
+        /**
+         * Gets the status of the order
+         *
+         * @param merchantOrderId Generated by the merchant at the time of initiating the order
+         * @param details         true -> order status has all attempt details under paymentDetails list
+         * false -> order status has only latest attempt details under paymentDetails list
+         * @return Promise<OrderStatusResponse> which contains the details about the order
+         */
+        this.getOrderStatus = (merchantOrderId, details = false) => __awaiter(this, void 0, void 0, function* () {
+            const url = Constants_1.StandardCheckoutContants.ORDER_STATUS_API.replace('{ORDER_ID}', merchantOrderId);
+            try {
+                const response = yield this.requestViaAuthRefresh(HttpMethodType_1.HttpMethodType.GET, url, OrderStatusResponse_1.OrderStatusResponse, this.headers, {}, { [Constants_1.StandardCheckoutContants.ORDER_DETAILS]: details.toString() });
+                this.eventPublisher.send((0, EventBuillder_1.buildOrderStatusEvent)(EventState_1.EventState.SUCCESS, merchantOrderId, PaymentFlowType_1.PaymentFlowType.PG_CHECKOUT, url, EventType_1.EventType.ORDER_STATUS_SUCCESS));
+                return response;
+            }
+            catch (error) {
+                this.eventPublisher.send((0, EventBuillder_1.buildOrderStatusEvent)(EventState_1.EventState.FAILED, merchantOrderId, PaymentFlowType_1.PaymentFlowType.PG_CHECKOUT, url, EventType_1.EventType.ORDER_STATUS_FAILED, error));
+                throw error;
+            }
+        });
+        /**
+         * Initiate a refund of an order which is in completed state
+         *
+         * @param refundRequest Request required to initiate the order. It is build using RefundRequest.builder()
+         * @return Promise<RefundResponse> which contains the details about the refund
+         */
+        this.refund = (refundRequest) => __awaiter(this, void 0, void 0, function* () {
+            const url = Constants_1.StandardCheckoutContants.REFUND_API;
+            try {
+                const response = yield this.requestViaAuthRefresh(HttpMethodType_1.HttpMethodType.POST, url, RefundResponse_1.RefundResponse, this.headers, refundRequest);
+                this.eventPublisher.send((0, EventBuillder_1.buildRefundEvent)(EventState_1.EventState.SUCCESS, refundRequest, url, PaymentFlowType_1.PaymentFlowType.PG_CHECKOUT, EventType_1.EventType.REFUND_SUCCESS));
+                return response;
+            }
+            catch (error) {
+                this.eventPublisher.send((0, EventBuillder_1.buildRefundEvent)(EventState_1.EventState.FAILED, refundRequest, url, PaymentFlowType_1.PaymentFlowType.PG_CHECKOUT, EventType_1.EventType.REFUND_FAILED, error));
+                throw error;
+            }
+        });
+        /**
+         * Gets the status of refund
+         *
+         * @param refundId Generated by merchant at the time of initiating the refund
+         * @return Promise<RefundStatusResponse> which contains the status about the refund
+         */
+        this.getRefundStatus = (refundId) => __awaiter(this, void 0, void 0, function* () {
+            const url = Constants_1.StandardCheckoutContants.REFUND_STATUS_API.replace('{REFUND_ID}', refundId);
+            try {
+                const response = yield this.requestViaAuthRefresh(HttpMethodType_1.HttpMethodType.GET, url, RefundStatusResponse_1.RefundStatusResponse, this.headers);
+                this.eventPublisher.send((0, EventBuillder_1.buildRefundStatusEvent)(EventState_1.EventState.SUCCESS, EventType_1.EventType.REFUND_STATUS_SUCCESS, refundId, url, PaymentFlowType_1.PaymentFlowType.PG_CHECKOUT));
+                return response;
+            }
+            catch (error) {
+                this.eventPublisher.send((0, EventBuillder_1.buildRefundStatusEvent)(EventState_1.EventState.FAILED, EventType_1.EventType.REFUND_STATUS_FAILED, refundId, url, PaymentFlowType_1.PaymentFlowType.PG_CHECKOUT));
+                throw error;
+            }
+        });
+        /**
+         * Gets the status of a transaction attempted
+         *
+         * @param transactionId Transaction attempt id generated by PhonePe
+         * @return Promise<OrderStatusResponse> which contains the details about that specific transactionId
+         */
+        this.getTransactionStatus = (transactionId) => __awaiter(this, void 0, void 0, function* () {
+            const url = Constants_1.StandardCheckoutContants.TRANSACTION_STATUS_API.replace('{TRANSACTION_ID}', transactionId);
+            try {
+                const response = yield this.requestViaAuthRefresh(HttpMethodType_1.HttpMethodType.GET, url, OrderStatusResponse_1.OrderStatusResponse, this.headers);
+                this.eventPublisher.send((0, EventBuillder_1.buildTransactionStatusEvent)(EventState_1.EventState.SUCCESS, EventType_1.EventType.TRANSACTION_STATUS_SUCCESS, transactionId, url, PaymentFlowType_1.PaymentFlowType.PG_CHECKOUT));
+                return response;
+            }
+            catch (error) {
+                this.eventPublisher.send((0, EventBuillder_1.buildTransactionStatusEvent)(EventState_1.EventState.FAILED, EventType_1.EventType.TRANSACTION_STATUS_FAILED, transactionId, url, PaymentFlowType_1.PaymentFlowType.PG_CHECKOUT));
+                throw error;
+            }
+        });
+        /**
+         * Create order token for SDK integrated order requests
+         *
+         * @param sdkRequest Request object build using CreateSdkOrderRequest.builder()
+         * @return Promise<CreateSdkOrderResponse> which contains token details to be consumed by the UI
+         */
+        this.createSdkOrder = (sdkRequest) => __awaiter(this, void 0, void 0, function* () {
+            const url = Constants_1.StandardCheckoutContants.CREATE_ORDER_API;
+            try {
+                const response = yield this.requestViaAuthRefresh(HttpMethodType_1.HttpMethodType.POST, url, CreateSdkOrderResponse_1.CreateSdkOrderResponse, this.headers, sdkRequest);
+                this.eventPublisher.send((0, EventBuillder_1.buildCreateSdkOrderEvent)(EventState_1.EventState.SUCCESS, EventType_1.EventType.CREATE_SDK_ORDER_SUCCESS, sdkRequest, url, PaymentFlowType_1.PaymentFlowType.PG_CHECKOUT));
+                return response;
+            }
+            catch (error) {
+                this.eventPublisher.send((0, EventBuillder_1.buildCreateSdkOrderEvent)(EventState_1.EventState.FAILED, EventType_1.EventType.CREATE_SDK_ORDER_FAILED, sdkRequest, url, PaymentFlowType_1.PaymentFlowType.PG_CHECKOUT));
+                throw error;
+            }
+        });
+        /**
+         * Validate if the callback is valid
+         *
+         * @param username      username set by the merchant on the dashboard
+         * @param password      password set by the merchant on the dashboard
+         * @param authorization String data under `authorization` key of response headers
+         * @param responseBody  Callback response body
+         * @return CallbackResponse Deserialized callback body
+         * @throws PhonePeException when callback is not valid
+         */
+        this.validateCallback = (username, password, authorization, responseBody) => {
+            if (!CommonUtils_1.CommonUtils.isCallbackValid(username, password, authorization)) {
+                throw new Exceptions_1.PhonePeException('Invalid Callback', 417);
+            }
+            const parsedBody = JSON.parse(responseBody);
+            return (0, class_transformer_1.plainToClass)(CallbackResponse_1.CallbackResponse, parsedBody);
+        };
+        this.prepareHeaders = () => {
+            return {
+                [Headers_1.Headers.CONTENT_TYPE]: Headers_1.Headers.APPLICATION_JSON,
+                [Headers_1.Headers.SOURCE]: Headers_1.Headers.INTEGRATION,
+                [Headers_1.Headers.SOURCE_VERSION]: Headers_1.Headers.API_VERSION,
+                [Headers_1.Headers.SOURCE_PLATFORM]: Headers_1.Headers.SDK_TYPE,
+                [Headers_1.Headers.SOURCE_PLATFORM_VERSION]: Headers_1.Headers.SDK_VERSION,
+            };
+        };
+        this.eventPublisher.send((0, EventBuillder_1.buildInitClientEvent)(EventType_1.EventType.STANDARD_CHECKOUT_CLIENT_INITIALIZED, PaymentFlowType_1.PaymentFlowType.PG_CHECKOUT));
+        this.headers = this.prepareHeaders();
+    }
+}
+exports.StandardCheckoutClient = StandardCheckoutClient;
+/**
+ * Generates a StandardCheckout Client for interacting with the PhonePe APIs
+ *
+ * @param clientId      Unique clientId assigned to merchant by PhonePe
+ * @param clientSecret  Secret provided by PhonePe
+ * @param clientVersion The client version used for secure transactions
+ * @param env           Set to `Env.SANDBOX` for the SANDBOX environment  or `Env.PRODUCTION` for the production
+ *                      environment.
+ * @param shouldPublishEvents When true, events are sent to PhonePe providing smoother experience
+ * @return StandardCheckoutClient object for interacting with the PhonePe APIs
+ */
+StandardCheckoutClient.getInstance = (clientId, clientSecret, clientVersion, env, shouldPublishEvents = true) => {
+    shouldPublishEvents = shouldPublishEvents && env == Env_1.Env.PRODUCTION;
+    if (StandardCheckoutClient._client == undefined) {
+        StandardCheckoutClient._client = new StandardCheckoutClient(clientId, clientSecret, clientVersion, env, shouldPublishEvents);
+        return StandardCheckoutClient._client;
+    }
+    const requestedClientSHA = CommonUtils_1.CommonUtils.calculateSha256({
+        clientId: clientId,
+        clientSecret: clientSecret,
+        clientVersion: clientVersion,
+        env: env,
+        shouldPublishEvents: shouldPublishEvents,
+        paymentFlowType: PaymentFlowType_1.PaymentFlowType.PG_CHECKOUT,
+    });
+    const cachedClientSHA = CommonUtils_1.CommonUtils.calculateSha256({
+        clientId: StandardCheckoutClient._client.merchantConfig.clientId,
+        clientSecret: StandardCheckoutClient._client.merchantConfig.clientSecret,
+        clientVersion: StandardCheckoutClient._client.merchantConfig.clientVersion,
+        env: StandardCheckoutClient._client.env,
+        shouldPublishEvents: StandardCheckoutClient._client.shouldPublishEvents,
+        paymentFlowType: PaymentFlowType_1.PaymentFlowType.PG_CHECKOUT,
+    });
+    if (requestedClientSHA == cachedClientSHA)
+        return StandardCheckoutClient._client;
+    throw new Exceptions_1.PhonePeException(Constants_2.Constants.CLIENT_EXCEPTION(StandardCheckoutClient._client.constructor.name));
+};

package/dist/src/payments/v2/customcheckout/Constants.d.ts

@@ -0,0 +1,9 @@
+export declare class CustomCheckoutConstants {
+    static readonly PAY_API: string;
+    static readonly ORDER_STATUS_API: string;
+    static readonly ORDER_DETAILS: string;
+    static readonly REFUND_API: string;
+    static readonly REFUND_STATUS_API: string;
+    static readonly TRANSACTION_STATUS_API: string;
+    static readonly CREATE_ORDER_API: string;
+}

package/dist/src/payments/v2/customcheckout/Constants.js

@@ -0,0 +1,28 @@
+"use strict";
+/*
+ *  Copyright (c) 2025 Original Author(s), PhonePe India Pvt. Ltd.
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomCheckoutConstants = void 0;
+class CustomCheckoutConstants {
+}
+exports.CustomCheckoutConstants = CustomCheckoutConstants;
+CustomCheckoutConstants.PAY_API = '/payments/v2/pay';
+CustomCheckoutConstants.ORDER_STATUS_API = '/payments/v2/order/{ORDER_ID}/status';
+CustomCheckoutConstants.ORDER_DETAILS = 'details';
+CustomCheckoutConstants.REFUND_API = '/payments/v2/refund';
+CustomCheckoutConstants.REFUND_STATUS_API = '/payments/v2/refund/{REFUND_ID}/status';
+CustomCheckoutConstants.TRANSACTION_STATUS_API = '/payments/v2/transaction/{TRANSACTION_ID}/status';
+CustomCheckoutConstants.CREATE_ORDER_API = '/payments/v2/sdk/order';

package/dist/src/payments/v2/index.d.ts

@@ -0,0 +1,3 @@
+export * from './CustomCheckoutClient';
+export * from './StandardCheckoutClient';
+export * from './models';

package/dist/src/payments/v2/index.js

@@ -0,0 +1,34 @@
+"use strict";
+/*
+ *  Copyright (c) 2025 Original Author(s), PhonePe India Pvt. Ltd.
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./CustomCheckoutClient"), exports);
+__exportStar(require("./StandardCheckoutClient"), exports);
+__exportStar(require("./models"), exports);

package/dist/src/payments/v2/models/index.d.ts

@@ -0,0 +1,2 @@
+export * from './request';
+export * from './response';