cb-pay-merchant-api 1.0.0

package/README.md

@@ -0,0 +1,101 @@
+# CBPay Merchant MMQR Unofficial API Integration Package
+
+An unofficial, personal-use TypeScript API integration package for connecting CBPay Merchant's MMQR functionalities into Node.js applications.
+It provides a simple class-based wrapper around the CBPay REST API, handling authentication, token management, dynamic QR generation, status checking, and refunds.
+
+> **Disclaimer:** This is an unofficial, community-driven integration package intended for personal reuse. It is not affiliated with, endorsed by, or maintained by CB Bank.
+
+## Features
+
+* Automatic token generation and management
+* Dynamic QR Code generation (`requestQR`)
+* Transaction status validation (`checkQR`)
+* Payment refunds (`refund`)
+* Strongly typed requests and responses
+
+## Installation
+
+```bash
+npm install cb-pay-merchant-api
+```
+
+## Initialization
+
+Initialize the instance by providing your merchant credentials. The integration kit will automatically handle fetching and attaching the required authorization tokens for subsequent API calls.
+
+```typescript
+import { CBPayMerchantApi } from 'cb-pay-merchant-api';
+
+const cbpay = CBPayMerchantApi({
+  baseUrl: '[https://api.uat.cbbank.com](https://api.uat.cbbank.com)', // Contact CB Pay Team
+  sourceId: 'YOUR_SOURCE_ID',
+  merchantId: 'YOUR_MERCHANT_ID',
+  terminalId: 'YOUR_TERMINAL_ID',
+  userId: 'YOUR_USER_ID',
+  password: 'YOUR_PASSWORD'
+});
+```
+
+------------------
+
+## API Reference
+
+#### 1. Request Dynamic QR (requestQR)
+```typescript
+const qrResponse = await cbpay.requestQR({
+  transCurrency: 'MMK',
+  transAmount: 15000,
+  purposeOfTransaction: 'Purchase Order #8821',
+  referenceNo: 'PO-8821'
+});
+console.log(qrResponse.qrCodeInfo);
+```
+
+#### Parameters (requestQR):
+| Property | Type | Required | Description |
+| :--- | :--- | :---: | :--- |
+| `transCurrency` | `string` | **Yes** | Currency code |
+| `transAmount` | `number` | **Yes** | Transaction amount |
+| `referenceNo` | `string` | **Yes** | Your unique order or reference number |
+| `purposeOfTransaction` | `string` | **Yes** | Description of the payment |
+
+------------------
+
+
+#### 2. Check QR Status
+```typescript
+const statusResponse = await cbpay.checkQR({
+  qrReferenceNo: 'QR-REF-FROM-RESPONSE'
+});
+
+if (statusResponse.returnCode === '000') {
+  console.log(statusResponse.transactionId);
+}
+```
+
+#### Parameters (checkQR):
+| Property | Type | Required | Description |
+| :--- | :--- | :---: | :--- |
+| `qrReferenceNo` | `string` | **Yes** | The qrReferenceNo received from the requestQR response |
+
+------------------
+
+
+#### 3. Refund Transaction (refund)
+
+```typescript
+const refundResponse = await cbpay.refund({
+  transactionId: 'TXN-123456789',
+  refundCurrency: 'MMK',
+  refundAmount: 15000,
+  isPartialRedund: false
+});
+```
+
+#### Parameters (requestQR):
+| Property | Type | Required | Description |
+| :--- | :--- | :---: | :--- |
+| `transactionId` | `string` | **Yes** | The original transaction ID |
+| `refundAmount` | `number` | **Yes** | Amount to refund |
+| `refundCurrency` | `string` | **Yes** | Currency code |
+| `isPartialRedund` | `boolean` | **Yes** | Set to true for partial refunds |

package/dist/cjs/index.d.ts

@@ -0,0 +1,55 @@
+import {CheckQrRequestOption, CheckQrResponse, CreateQrRequestOption, CreateQrResponse, RefundRequestOption, RefundResponse} from './types';
+/**
+ * @Options
+ * @Options
+ * @Options
+ */
+export interface InstanceOptions {
+    baseUrl: string;
+    sourceId: string;
+    merchantId: string;
+    terminalId: string;
+    userId: string;
+    password: string;
+}
+/**
+ * @CBPayMerchantApi
+ * @CBPayMerchantApi
+ * @CBPayMerchantApi
+ * @param {InstanceOptions} options
+ * @returns {CBPayMerchantClass} A status message string.
+ */
+export declare function CBPayMerchantApi(options: InstanceOptions): CBPayMerchantClass;
+/**
+ * @CBPayMerchantClass
+ * @CBPayMerchantClass
+ * @CBPayMerchantClass
+ */
+declare class CBPayMerchantClass {
+    #private;
+    constructor(options: InstanceOptions);
+    /**
+     * getToken
+     * @returns {Promise<GetTokenResponse>}
+     */
+    private getToken;
+    /**
+     * requestQR
+     * @param {CreateQrRequestOption} options
+     * @returns {Promise<CreateQrResponse>}
+     */
+    requestQR(options: CreateQrRequestOption): Promise<CreateQrResponse>;
+    /**
+     * checkQR
+     * @param {CheckQrRequestOption} options
+     * @returns {Promise<CheckQrResponse>}
+     */
+    checkQR(options: CheckQrRequestOption): Promise<CheckQrResponse>;
+    /**
+     * refund
+     * @param {RefundRequestOption} options
+     * @returns {Promise<RefundResponse>}
+     */
+    refund(options: RefundRequestOption): Promise<RefundResponse>;
+}
+export { };

package/dist/cjs/index.js

@@ -0,0 +1,177 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _CBPayMerchantClass_baseUrl, _CBPayMerchantClass_sourceId, _CBPayMerchantClass_merchantId, _CBPayMerchantClass_terminalId, _CBPayMerchantClass_userId, _CBPayMerchantClass_password, _CBPayMerchantClass_bToken;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CBPayMerchantApi = CBPayMerchantApi;
+/**
+ * @CBPayMerchantApi
+ * @CBPayMerchantApi
+ * @CBPayMerchantApi
+ * @param {InstanceOptions} options
+ * @returns {CBPayMerchantClass} A status message string.
+ */
+function CBPayMerchantApi(options) {
+    return new CBPayMerchantClass({
+        baseUrl: options.baseUrl,
+        sourceId: options.sourceId,
+        merchantId: options.merchantId,
+        terminalId: options.terminalId,
+        userId: options.userId,
+        password: options.password,
+    });
+}
+/**
+ * @CBPayMerchantClass
+ * @CBPayMerchantClass
+ * @CBPayMerchantClass
+ */
+class CBPayMerchantClass {
+    constructor(options) {
+        _CBPayMerchantClass_baseUrl.set(this, void 0);
+        _CBPayMerchantClass_sourceId.set(this, void 0);
+        _CBPayMerchantClass_merchantId.set(this, void 0);
+        _CBPayMerchantClass_terminalId.set(this, void 0);
+        _CBPayMerchantClass_userId.set(this, void 0);
+        _CBPayMerchantClass_password.set(this, void 0);
+        _CBPayMerchantClass_bToken.set(this, void 0);
+        __classPrivateFieldSet(this, _CBPayMerchantClass_baseUrl, options.baseUrl, "f");
+        __classPrivateFieldSet(this, _CBPayMerchantClass_sourceId, options.sourceId, "f");
+        __classPrivateFieldSet(this, _CBPayMerchantClass_merchantId, options.merchantId, "f");
+        __classPrivateFieldSet(this, _CBPayMerchantClass_terminalId, options.terminalId, "f");
+        __classPrivateFieldSet(this, _CBPayMerchantClass_userId, options.userId, "f");
+        __classPrivateFieldSet(this, _CBPayMerchantClass_password, options.password, "f");
+    }
+    /**
+     * getToken
+     * @returns {Promise<GetTokenResponse>}
+     */
+    async getToken() {
+        try {
+            const config = {
+                headers: {
+                    'Content-Type': 'application/json'
+                }
+            };
+            const payload = {
+                userId: __classPrivateFieldGet(this, _CBPayMerchantClass_userId, "f"),
+                password: __classPrivateFieldGet(this, _CBPayMerchantClass_password, "f"),
+            };
+            const response = await fetch(`${__classPrivateFieldGet(this, _CBPayMerchantClass_baseUrl, "f")}/auth/token`, {
+                method: 'POST',
+                headers: config.headers,
+                body: JSON.stringify(payload)
+            });
+            const originResponse = (await response.json());
+            __classPrivateFieldSet(this, _CBPayMerchantClass_bToken, originResponse.token, "f");
+            return originResponse;
+        }
+        catch (error) {
+            console.error(error);
+        }
+    }
+    /**
+     * requestQR
+     * @param {CreateQrRequestOption} options
+     * @returns {Promise<CreateQrResponse>}
+     */
+    async requestQR(options) {
+        try {
+            await this.getToken(); // Get Replay Prevention Token
+            const config = {
+                headers: {
+                    'Content-Type': 'application/json'
+                }
+            };
+            const payload = {
+                transCurrency: options.transCurrency,
+                transAmount: options.transAmount,
+                purposeOfTransaction: options.purposeOfTransaction,
+                referenceNo: options.referenceNo,
+                token: __classPrivateFieldGet(this, _CBPayMerchantClass_bToken, "f"),
+                sourceId: __classPrivateFieldGet(this, _CBPayMerchantClass_sourceId, "f"),
+                merchantId: __classPrivateFieldGet(this, _CBPayMerchantClass_merchantId, "f"),
+                terminalId: __classPrivateFieldGet(this, _CBPayMerchantClass_terminalId, "f"),
+            };
+            const response = await fetch(`${__classPrivateFieldGet(this, _CBPayMerchantClass_baseUrl, "f")}/dynamicqr`, {
+                method: 'POST',
+                headers: config.headers,
+                body: JSON.stringify(payload)
+            });
+            return (await response.json());
+        }
+        catch (error) {
+            console.error(error);
+        }
+    }
+    /**
+     * checkQR
+     * @param {CheckQrRequestOption} options
+     * @returns {Promise<CheckQrResponse>}
+     */
+    async checkQR(options) {
+        try {
+            await this.getToken(); // Get Replay Prevention Token
+            const config = {
+                headers: {
+                    'Content-Type': 'application/json'
+                }
+            };
+            const payload = {
+                token: __classPrivateFieldGet(this, _CBPayMerchantClass_bToken, "f"),
+                sourceId: __classPrivateFieldGet(this, _CBPayMerchantClass_sourceId, "f")
+            };
+            const response = await fetch(`${__classPrivateFieldGet(this, _CBPayMerchantClass_baseUrl, "f")}/dynamicqr/${options.qrReferenceNo}/status`, {
+                method: 'PUT',
+                headers: config.headers,
+                body: JSON.stringify(payload)
+            });
+            return (await response.json());
+        }
+        catch (error) {
+            console.error(error);
+        }
+    }
+    /**
+     * refund
+     * @param {RefundRequestOption} options
+     * @returns {Promise<RefundResponse>}
+     */
+    async refund(options) {
+        try {
+            await this.getToken(); // Get Replay Prevention Token
+            const config = {
+                headers: {
+                    'Content-Type': 'application/json'
+                }
+            };
+            const payload = {
+                token: __classPrivateFieldGet(this, _CBPayMerchantClass_bToken, "f"),
+                sourceId: __classPrivateFieldGet(this, _CBPayMerchantClass_sourceId, "f"),
+                transactionId: options.transactionId,
+                refundCurrency: options.refundCurrency,
+                refundAmount: options.refundAmount,
+                isPartialRedund: options.isPartialRedund,
+            };
+            const response = await fetch(`${__classPrivateFieldGet(this, _CBPayMerchantClass_baseUrl, "f")}/payment/refund`, {
+                method: 'POST',
+                headers: config.headers,
+                body: JSON.stringify(payload)
+            });
+            return (await response.json());
+        }
+        catch (error) {
+            console.error(error);
+        }
+    }
+}
+_CBPayMerchantClass_baseUrl = new WeakMap(), _CBPayMerchantClass_sourceId = new WeakMap(), _CBPayMerchantClass_merchantId = new WeakMap(), _CBPayMerchantClass_terminalId = new WeakMap(), _CBPayMerchantClass_userId = new WeakMap(), _CBPayMerchantClass_password = new WeakMap(), _CBPayMerchantClass_bToken = new WeakMap();

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

@@ -0,0 +1,86 @@
+export interface GetTokenRequest {
+    userId: string;
+    password: string;
+}
+export interface GetTokenResponse {
+    token: string;
+    returnCode: string;
+    message: string;
+    expiredDateTime: string;
+}
+export interface CreateQrRequestOption {
+    transCurrency: string;
+    transAmount: number;
+    purposeOfTransaction?: string;
+    referenceNo: string;
+}
+export interface CreateQrRequest extends CreateQrRequestOption {
+    token: string;
+    sourceId: string;
+    merchantId: string;
+    terminalId: string;
+}
+export interface CreateQrResponse {
+    returnCode: string;
+    message: string;
+    referenceNo: string;
+    qrCodeInfo: string;
+    qrReferenceNo: string;
+    qrIssuedDateTime: string;
+    qrExpiredDateTime: string;
+}
+export interface CheckQrRequestOption {
+    qrReferenceNo: string;
+}
+export interface CheckQrRequest {
+    token: string;
+    sourceId: string;
+}
+export interface CheckQrResponse {
+    referenceNo: string;
+    returnCode: string;
+    transactionId: string;
+    transCurrency: string;
+    transDateTime: string;
+    transAmount: number;
+    qrReferenceNo: string;
+    institutionId: string;
+    institutionName: string;
+    merchantId: string;
+    message: string;
+    remark: string;
+}
+export interface RefundRequestOption {
+    transactionId: string;
+    refundCurrency: string;
+    refundAmount: number;
+    isPartialRedund: boolean;
+}
+export interface RefundRequest extends RefundRequestOption {
+    token: string;
+    sourceId: string;
+}
+export interface RefundResponse {
+    transactionId: string;
+    returnCode: string;
+    message: string;
+}
+export interface CallbackRequest {
+    apiKey: string;
+    referenceNo: string;
+    transactionId: string;
+    transCurrency: string;
+    transAmount: number;
+    transDateTime: string;
+    transStatusCode: string;
+    transStatusDescription: string;
+    qrReferenceNo: string;
+    institutionId: string;
+    institutionName: string;
+    merchantId: string;
+}
+export interface CallbackResponse {
+    qrReferenceNo: string;
+    returnCode: string;
+    message: string;
+}

package/dist/cjs/types/index.js

@@ -0,0 +1,4 @@
+"use strict";
+// --------- Request Token -----------
+// --------- Request Token -----------
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/esm/index.d.ts

@@ -0,0 +1,55 @@
+import { CheckQrRequestOption, CheckQrResponse, CreateQrRequestOption, CreateQrResponse, RefundRequestOption, RefundResponse } from './types';
+/**
+ * @Options
+ * @Options
+ * @Options
+ */
+export interface InstanceOptions {
+    baseUrl: string;
+    sourceId: string;
+    merchantId: string;
+    terminalId: string;
+    userId: string;
+    password: string;
+}
+/**
+ * @CBPayMerchantApi
+ * @CBPayMerchantApi
+ * @CBPayMerchantApi
+ * @param {InstanceOptions} options
+ * @returns {CBPayMerchantClass} A status message string.
+ */
+export declare function CBPayMerchantApi(options: InstanceOptions): CBPayMerchantClass;
+/**
+ * @CBPayMerchantClass
+ * @CBPayMerchantClass
+ * @CBPayMerchantClass
+ */
+declare class CBPayMerchantClass {
+    #private;
+    constructor(options: InstanceOptions);
+    /**
+     * getToken
+     * @returns {Promise<GetTokenResponse>}
+     */
+    private getToken;
+    /**
+     * requestQR
+     * @param {CreateQrRequestOption} options
+     * @returns {Promise<CreateQrResponse>}
+     */
+    requestQR(options: CreateQrRequestOption): Promise<CreateQrResponse>;
+    /**
+     * checkQR
+     * @param {CheckQrRequestOption} options
+     * @returns {Promise<CheckQrResponse>}
+     */
+    checkQR(options: CheckQrRequestOption): Promise<CheckQrResponse>;
+    /**
+     * refund
+     * @param {RefundRequestOption} options
+     * @returns {Promise<RefundResponse>}
+     */
+    refund(options: RefundRequestOption): Promise<RefundResponse>;
+}
+export {};

package/dist/esm/index.js

@@ -0,0 +1,174 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _CBPayMerchantClass_baseUrl, _CBPayMerchantClass_sourceId, _CBPayMerchantClass_merchantId, _CBPayMerchantClass_terminalId, _CBPayMerchantClass_userId, _CBPayMerchantClass_password, _CBPayMerchantClass_bToken;
+/**
+ * @CBPayMerchantApi
+ * @CBPayMerchantApi
+ * @CBPayMerchantApi
+ * @param {InstanceOptions} options
+ * @returns {CBPayMerchantClass} A status message string.
+ */
+export function CBPayMerchantApi(options) {
+    return new CBPayMerchantClass({
+        baseUrl: options.baseUrl,
+        sourceId: options.sourceId,
+        merchantId: options.merchantId,
+        terminalId: options.terminalId,
+        userId: options.userId,
+        password: options.password,
+    });
+}
+/**
+ * @CBPayMerchantClass
+ * @CBPayMerchantClass
+ * @CBPayMerchantClass
+ */
+class CBPayMerchantClass {
+    constructor(options) {
+        _CBPayMerchantClass_baseUrl.set(this, void 0);
+        _CBPayMerchantClass_sourceId.set(this, void 0);
+        _CBPayMerchantClass_merchantId.set(this, void 0);
+        _CBPayMerchantClass_terminalId.set(this, void 0);
+        _CBPayMerchantClass_userId.set(this, void 0);
+        _CBPayMerchantClass_password.set(this, void 0);
+        _CBPayMerchantClass_bToken.set(this, void 0);
+        __classPrivateFieldSet(this, _CBPayMerchantClass_baseUrl, options.baseUrl, "f");
+        __classPrivateFieldSet(this, _CBPayMerchantClass_sourceId, options.sourceId, "f");
+        __classPrivateFieldSet(this, _CBPayMerchantClass_merchantId, options.merchantId, "f");
+        __classPrivateFieldSet(this, _CBPayMerchantClass_terminalId, options.terminalId, "f");
+        __classPrivateFieldSet(this, _CBPayMerchantClass_userId, options.userId, "f");
+        __classPrivateFieldSet(this, _CBPayMerchantClass_password, options.password, "f");
+    }
+    /**
+     * getToken
+     * @returns {Promise<GetTokenResponse>}
+     */
+    async getToken() {
+        try {
+            const config = {
+                headers: {
+                    'Content-Type': 'application/json'
+                }
+            };
+            const payload = {
+                userId: __classPrivateFieldGet(this, _CBPayMerchantClass_userId, "f"),
+                password: __classPrivateFieldGet(this, _CBPayMerchantClass_password, "f"),
+            };
+            const response = await fetch(`${__classPrivateFieldGet(this, _CBPayMerchantClass_baseUrl, "f")}/auth/token`, {
+                method: 'POST',
+                headers: config.headers,
+                body: JSON.stringify(payload)
+            });
+            const originResponse = (await response.json());
+            __classPrivateFieldSet(this, _CBPayMerchantClass_bToken, originResponse.token, "f");
+            return originResponse;
+        }
+        catch (error) {
+            console.error(error);
+        }
+    }
+    /**
+     * requestQR
+     * @param {CreateQrRequestOption} options
+     * @returns {Promise<CreateQrResponse>}
+     */
+    async requestQR(options) {
+        try {
+            await this.getToken(); // Get Replay Prevention Token
+            const config = {
+                headers: {
+                    'Content-Type': 'application/json'
+                }
+            };
+            const payload = {
+                transCurrency: options.transCurrency,
+                transAmount: options.transAmount,
+                purposeOfTransaction: options.purposeOfTransaction,
+                referenceNo: options.referenceNo,
+                token: __classPrivateFieldGet(this, _CBPayMerchantClass_bToken, "f"),
+                sourceId: __classPrivateFieldGet(this, _CBPayMerchantClass_sourceId, "f"),
+                merchantId: __classPrivateFieldGet(this, _CBPayMerchantClass_merchantId, "f"),
+                terminalId: __classPrivateFieldGet(this, _CBPayMerchantClass_terminalId, "f"),
+            };
+            const response = await fetch(`${__classPrivateFieldGet(this, _CBPayMerchantClass_baseUrl, "f")}/dynamicqr`, {
+                method: 'POST',
+                headers: config.headers,
+                body: JSON.stringify(payload)
+            });
+            return (await response.json());
+        }
+        catch (error) {
+            console.error(error);
+        }
+    }
+    /**
+     * checkQR
+     * @param {CheckQrRequestOption} options
+     * @returns {Promise<CheckQrResponse>}
+     */
+    async checkQR(options) {
+        try {
+            await this.getToken(); // Get Replay Prevention Token
+            const config = {
+                headers: {
+                    'Content-Type': 'application/json'
+                }
+            };
+            const payload = {
+                token: __classPrivateFieldGet(this, _CBPayMerchantClass_bToken, "f"),
+                sourceId: __classPrivateFieldGet(this, _CBPayMerchantClass_sourceId, "f")
+            };
+            const response = await fetch(`${__classPrivateFieldGet(this, _CBPayMerchantClass_baseUrl, "f")}/dynamicqr/${options.qrReferenceNo}/status`, {
+                method: 'PUT',
+                headers: config.headers,
+                body: JSON.stringify(payload)
+            });
+            return (await response.json());
+        }
+        catch (error) {
+            console.error(error);
+        }
+    }
+    /**
+     * refund
+     * @param {RefundRequestOption} options
+     * @returns {Promise<RefundResponse>}
+     */
+    async refund(options) {
+        try {
+            await this.getToken(); // Get Replay Prevention Token
+            const config = {
+                headers: {
+                    'Content-Type': 'application/json'
+                }
+            };
+            const payload = {
+                token: __classPrivateFieldGet(this, _CBPayMerchantClass_bToken, "f"),
+                sourceId: __classPrivateFieldGet(this, _CBPayMerchantClass_sourceId, "f"),
+                transactionId: options.transactionId,
+                refundCurrency: options.refundCurrency,
+                refundAmount: options.refundAmount,
+                isPartialRedund: options.isPartialRedund,
+            };
+            const response = await fetch(`${__classPrivateFieldGet(this, _CBPayMerchantClass_baseUrl, "f")}/payment/refund`, {
+                method: 'POST',
+                headers: config.headers,
+                body: JSON.stringify(payload)
+            });
+            return (await response.json());
+        }
+        catch (error) {
+            console.error(error);
+        }
+    }
+}
+_CBPayMerchantClass_baseUrl = new WeakMap(), _CBPayMerchantClass_sourceId = new WeakMap(), _CBPayMerchantClass_merchantId = new WeakMap(), _CBPayMerchantClass_terminalId = new WeakMap(), _CBPayMerchantClass_userId = new WeakMap(), _CBPayMerchantClass_password = new WeakMap(), _CBPayMerchantClass_bToken = new WeakMap();

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

@@ -0,0 +1,86 @@
+export interface GetTokenRequest {
+    userId: string;
+    password: string;
+}
+export interface GetTokenResponse {
+    token: string;
+    returnCode: string;
+    message: string;
+    expiredDateTime: string;
+}
+export interface CreateQrRequestOption {
+    transCurrency: string;
+    transAmount: number;
+    purposeOfTransaction?: string;
+    referenceNo: string;
+}
+export interface CreateQrRequest extends CreateQrRequestOption {
+    token: string;
+    sourceId: string;
+    merchantId: string;
+    terminalId: string;
+}
+export interface CreateQrResponse {
+    returnCode: string;
+    message: string;
+    referenceNo: string;
+    qrCodeInfo: string;
+    qrReferenceNo: string;
+    qrIssuedDateTime: string;
+    qrExpiredDateTime: string;
+}
+export interface CheckQrRequestOption {
+    qrReferenceNo: string;
+}
+export interface CheckQrRequest {
+    token: string;
+    sourceId: string;
+}
+export interface CheckQrResponse {
+    referenceNo: string;
+    returnCode: string;
+    transactionId: string;
+    transCurrency: string;
+    transDateTime: string;
+    transAmount: number;
+    qrReferenceNo: string;
+    institutionId: string;
+    institutionName: string;
+    merchantId: string;
+    message: string;
+    remark: string;
+}
+export interface RefundRequestOption {
+    transactionId: string;
+    refundCurrency: string;
+    refundAmount: number;
+    isPartialRedund: boolean;
+}
+export interface RefundRequest extends RefundRequestOption {
+    token: string;
+    sourceId: string;
+}
+export interface RefundResponse {
+    transactionId: string;
+    returnCode: string;
+    message: string;
+}
+export interface CallbackRequest {
+    apiKey: string;
+    referenceNo: string;
+    transactionId: string;
+    transCurrency: string;
+    transAmount: number;
+    transDateTime: string;
+    transStatusCode: string;
+    transStatusDescription: string;
+    qrReferenceNo: string;
+    institutionId: string;
+    institutionName: string;
+    merchantId: string;
+}
+export interface CallbackResponse {
+    qrReferenceNo: string;
+    returnCode: string;
+    message: string;
+}

package/dist/esm/types/index.js

@@ -0,0 +1,3 @@
+// --------- Request Token -----------
+// --------- Request Token -----------
+export {};

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "cb-pay-merchant-api",
+  "version": "1.0.0",
+  "description": "MMQR, CB Pay - Integration Package",
+  "keywords": [
+    "MMQR",
+    "CB Pay"
+  ],
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "types": "./dist/esm/index.d.ts"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nawing/CB-Pay-Merchant-Api.git"
+  },
+  "bugs": {
+    "url": "https://github.com/nawing/CB-Pay-Merchant-Api/issues"
+  },
+  "homepage": "https://github.com/nawing/CB-Pay-Merchant-Api#readme",
+  "scripts": {
+    "build": "npm run clean && tsc && tsc -p tsconfig.cjs.json",
+    "clean": "rm -rf dist",
+    "dev": "tsc --watch"
+  },
+  "devDependencies": {
+    "@types/node": "^24.12.3",
+    "typescript": "^5.3.3"
+  },
+  "author": "Naw Ing",
+  "license": "ISC",
+  "dependencies": {
+    "dotenv": "^17.2.2"
+  }
+}

package/src/index.ts

@@ -0,0 +1,178 @@
+import {CheckQrRequest, CheckQrRequestOption, CheckQrResponse, CreateQrRequest, CreateQrRequestOption, CreateQrResponse, GetTokenRequest, GetTokenResponse, RefundRequest, RefundRequestOption, RefundResponse} from './types';
+
+/**
+ * @Options
+ * @Options
+ * @Options
+ */
+export interface InstanceOptions {
+  baseUrl: string;
+  sourceId: string;
+  merchantId: string;
+  terminalId: string;
+  userId: string;
+  password: string;
+}
+
+/**
+ * @CBPayMerchantApi
+ * @CBPayMerchantApi
+ * @CBPayMerchantApi
+ * @param {InstanceOptions} options
+ * @returns {CBPayMerchantClass} A status message string.
+ */
+export function CBPayMerchantApi(options: InstanceOptions): CBPayMerchantClass {
+  return new CBPayMerchantClass({
+    baseUrl: options.baseUrl,
+    sourceId: options.sourceId,
+    merchantId: options.merchantId,
+    terminalId: options.terminalId,
+    userId: options.userId,
+    password: options.password,
+  })
+}
+
+/**
+ * @CBPayMerchantClass
+ * @CBPayMerchantClass
+ * @CBPayMerchantClass
+ */
+class CBPayMerchantClass {
+
+  readonly #baseUrl: string;
+  readonly #sourceId: string;
+  readonly #merchantId: string;
+  readonly #terminalId: string;
+  readonly #userId: string;
+  readonly #password: string;
+
+  #bToken: string;
+
+  constructor(options: InstanceOptions) {
+    this.#baseUrl = options.baseUrl;
+    this.#sourceId = options.sourceId;
+    this.#merchantId = options.merchantId;
+    this.#terminalId = options.terminalId;
+    this.#userId = options.userId;
+    this.#password = options.password;
+  }
+
+  /**
+   * getToken
+   * @returns {Promise<GetTokenResponse>}
+   */
+  private async getToken(): Promise<GetTokenResponse> {
+    try {
+      const config = {
+        headers: {
+          'Content-Type': 'application/json'
+        }
+      };
+      const payload: GetTokenRequest = {
+        userId: this.#userId,
+        password: this.#password,
+      }
+      const response = await fetch(`${this.#baseUrl}/auth/token`, {
+        method: 'POST',
+        headers: config.headers,
+        body: JSON.stringify(payload)
+      });
+      const originResponse = (await response.json()) as GetTokenResponse;
+      this.#bToken = originResponse.token;
+      return originResponse;
+    } catch (error) {
+      console.error(error)
+    }
+  }
+  /**
+   * requestQR
+   * @param {CreateQrRequestOption} options
+   * @returns {Promise<CreateQrResponse>}
+   */
+  public async requestQR(options: CreateQrRequestOption): Promise<CreateQrResponse> {
+    try {
+      await this.getToken(); // Get Replay Prevention Token
+      const config = {
+        headers: {
+          'Content-Type': 'application/json'
+        }
+      };
+      const payload: CreateQrRequest = {
+        transCurrency: options.transCurrency,
+        transAmount: options.transAmount,
+        purposeOfTransaction: options.purposeOfTransaction,
+        referenceNo: options.referenceNo,
+        token: this.#bToken,
+        sourceId: this.#sourceId,
+        merchantId: this.#merchantId,
+        terminalId: this.#terminalId,
+      }
+      const response = await fetch(`${this.#baseUrl}/dynamicqr`, {
+        method: 'POST',
+        headers: config.headers,
+        body: JSON.stringify(payload)
+      });
+      return (await response.json()) as CreateQrResponse;
+    } catch (error) {
+      console.error(error)
+    }
+  }
+  /**
+   * checkQR
+   * @param {CheckQrRequestOption} options
+   * @returns {Promise<CheckQrResponse>}
+   */
+  public async checkQR(options: CheckQrRequestOption): Promise<CheckQrResponse> {
+    try {
+      await this.getToken(); // Get Replay Prevention Token
+      const config = {
+        headers: {
+          'Content-Type': 'application/json'
+        }
+      };
+      const payload: CheckQrRequest = {
+        token: this.#bToken,
+        sourceId: this.#sourceId
+      }
+      const response = await fetch(`${this.#baseUrl}/dynamicqr/${options.qrReferenceNo}/status`, {
+        method: 'PUT',
+        headers: config.headers,
+        body: JSON.stringify(payload)
+      });
+      return (await response.json()) as CheckQrResponse;
+    } catch (error) {
+      console.error(error)
+    }
+  }
+  /**
+   * refund
+   * @param {RefundRequestOption} options
+   * @returns {Promise<RefundResponse>}
+   */
+  public async refund(options: RefundRequestOption): Promise<RefundResponse> {
+    try {
+      await this.getToken(); // Get Replay Prevention Token
+      const config = {
+        headers: {
+          'Content-Type': 'application/json'
+        }
+      };
+      const payload: RefundRequest = {
+        token: this.#bToken,
+        sourceId: this.#sourceId,
+        transactionId: options.transactionId,
+        refundCurrency: options.refundCurrency,
+        refundAmount: options.refundAmount,
+        isPartialRedund: options.isPartialRedund,
+      }
+      const response = await fetch(`${this.#baseUrl}/payment/refund`, {
+        method: 'POST',
+        headers: config.headers,
+        body: JSON.stringify(payload)
+      });
+      return (await response.json()) as RefundResponse;
+    } catch (error) {
+      console.error(error)
+    }
+  }
+}

package/src/types/index.ts

@@ -0,0 +1,105 @@
+// --------- Request Token -----------
+// --------- Request Token -----------
+
+export interface GetTokenRequest {
+  userId: string;
+  password: string;
+}
+export interface GetTokenResponse {
+  token: string;
+  returnCode: string; // integer in string
+  message: string;
+  expiredDateTime: string; // timestamp in string
+}
+
+// --------- Create QR -----------
+// --------- Create QR -----------
+
+export interface CreateQrRequestOption {
+  transCurrency: string;
+  transAmount: number;
+  purposeOfTransaction?: string;
+  referenceNo: string;
+}
+export interface CreateQrRequest extends CreateQrRequestOption {
+  token: string;
+  sourceId: string;
+  merchantId: string;
+  terminalId: string;
+}
+export interface CreateQrResponse {
+  returnCode: string; // integer in string
+  message: string;
+  referenceNo: string;
+  qrCodeInfo: string;
+  qrReferenceNo: string;
+  qrIssuedDateTime: string;
+  qrExpiredDateTime: string;
+}
+
+// --------- Check Status -----------
+// --------- Check Status -----------
+
+export interface CheckQrRequestOption {
+  qrReferenceNo: string;
+}
+export interface CheckQrRequest {
+  token: string;
+  sourceId: string;
+}
+export interface CheckQrResponse {
+  referenceNo: string;
+  returnCode: string;
+  transactionId: string;
+  transCurrency: string;
+  transDateTime: string;
+  transAmount: number;
+  qrReferenceNo: string;
+  institutionId: string;
+  institutionName: string;
+  merchantId: string;
+  message: string;
+  remark: string;
+}
+
+// --------- Refund -----------
+// --------- Refund -----------
+
+export interface RefundRequestOption {
+  transactionId: string;
+  refundCurrency: string;
+  refundAmount: number;
+  isPartialRedund: boolean;
+}
+export interface RefundRequest extends RefundRequestOption {
+  token: string;
+  sourceId: string;
+}
+export interface RefundResponse {
+  transactionId: string;
+  returnCode: string;
+  message: string;
+}
+
+// --------- Callback -----------
+// --------- Callback -----------
+
+export interface CallbackRequest {
+  apiKey: string;
+  referenceNo: string;
+  transactionId: string;
+  transCurrency: string;
+  transAmount: number;
+  transDateTime: string;
+  transStatusCode: string;
+  transStatusDescription: string;
+  qrReferenceNo: string;
+  institutionId: string;
+  institutionName: string;
+  merchantId: string;
+}
+export interface CallbackResponse {
+  qrReferenceNo: string;
+  returnCode: string;
+  message: string;
+}

package/test/test.js

@@ -0,0 +1,42 @@
+const { CBPayMerchantApi } = require("../dist/cjs/index");
+const dovenv = require("dotenv");
+dovenv.config()
+const { performance } = require("perf_hooks")
+
+const CBPay = CBPayMerchantApi({
+  baseUrl: process.env.BASE_URL,
+  sourceId: process.env.SOURCE_ID,
+  merchantId: process.env.MERCHANT_ID,
+  terminalId: process.env.TERMINAL_ID,
+  userId: process.env.USER_ID,
+  password: process.env.PASSWORD,
+});
+
+
+/**
+ * @start
+ * @start
+ * @start
+ */
+const start = async () => {
+  const startTime = performance.now();
+  try {
+    const qrResponse = await CBPay.requestQR({
+      transAmount: 5000,
+      transCurrency: 'MMK',
+      referenceNo: 'TEST-' + new Date().getTime(),
+      // purposeOfTransaction: 'MMK',
+    })
+    console.log(qrResponse)
+    const end3Time = performance.now();
+    const latency3Ms = (end3Time - startTime).toFixed(3);
+    console.log(`\n--- Successful ---`);
+    console.log(`**Network Latency: ${latency3Ms} ms**`);
+  } catch (error) {
+    console.error(error)
+  }
+}
+
+
+
+start()

package/tsconfig.cjs.json

@@ -0,0 +1,7 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "module": "CommonJS",
+    "outDir": "dist/cjs"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ES2020",
+    "declaration": true,
+    "outDir": "dist/esm",
+    "strict": false,
+    "moduleResolution": "Node",
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "types": [
+      "node"
+    ]
+  },
+  "include": [
+    "src"
+  ]
+}