aba-payway 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,207 @@
+# aba-payway
+
+Type-safe TypeScript SDK for [ABA PayWay](https://www.payway.com.kh/) — Cambodia's #1 payment gateway.
+
+> **Unofficial community SDK.** Not affiliated with ABA Bank.
+
+## Features
+
+- Zero runtime dependencies — uses Node.js built-in `crypto` and native `fetch`
+- Full TypeScript support with strict types
+- Dual ESM + CJS output
+- Simple, clean API with camelCase interface
+- Works with Node.js, Bun, Next.js, Express, Hono, and any JS runtime with `fetch`
+
+## Installation
+
+```bash
+# bun
+bun add aba-payway
+
+# npm
+npm install aba-payway
+
+# pnpm
+pnpm add aba-payway
+```
+
+## Quick Start
+
+```typescript
+import { PayWay } from 'aba-payway'
+
+const payway = new PayWay({
+  merchantId: 'your_merchant_id',
+  apiKey: 'your_api_key',
+})
+
+// Generate checkout params (synchronous — no API call)
+const params = payway.createTransaction({
+  transactionId: 'order-001',
+  amount: 10.00,
+  items: 'Product A',
+  returnUrl: 'https://yoursite.com/callback',
+})
+
+// Send `params` to your frontend, populate ABA's hidden form,
+// and call AbaPayway.checkout() to open the payment dialog.
+// See examples/server.ts for a complete working example.
+```
+
+## API Reference
+
+### `new PayWay(config)`
+
+| Parameter | Type | Required | Default | Description |
+|---|---|---|---|---|
+| `merchantId` | `string` | Yes | — | Your ABA PayWay merchant ID |
+| `apiKey` | `string` | Yes | — | Your ABA PayWay API key |
+| `production` | `boolean` | No | `false` | Use production environment |
+
+### `payway.createTransaction(options)`
+
+Generate checkout parameters for a payment. **Synchronous** — computes the HMAC hash and returns form params without making any API calls.
+
+Returns `CheckoutParams` — snake_case form parameters to submit via ABA's checkout JS SDK.
+
+| Parameter | Type | Required | Description |
+|---|---|---|---|
+| `transactionId` | `string` | Yes | Unique transaction ID (max 20 chars) |
+| `amount` | `number` | Yes | Purchase amount |
+| `currency` | `'USD' \| 'KHR'` | No | Default: `'USD'` |
+| `paymentOption` | `PaymentOption` | No | `cards`, `abapay_khqr`, `abapay_khqr_deeplink`, `alipay`, `wechat`, `google_pay` |
+| `firstName` | `string` | No | Buyer's first name |
+| `lastName` | `string` | No | Buyer's last name |
+| `email` | `string` | No | Buyer's email |
+| `phone` | `string` | No | Buyer's phone |
+| `items` | `string \| ItemEntry[]` | No | Item description — string or `{ name, quantity, price }[]` |
+| `returnUrl` | `string` | No | Callback URL for payment completion |
+| `cancelUrl` | `string` | No | Redirect URL when user closes payment |
+| `continueSuccessUrl` | `string` | No | Redirect URL after success |
+| `type` | `'purchase' \| 'pre-auth'` | No | Default: `'purchase'` |
+| `shipping` | `number` | No | Shipping fee |
+| `viewType` | `string` | No | `'hosted_view'` or `'popup'` |
+| `lifetime` | `number` | No | Payment lifetime in minutes (3–43200) |
+| `skipSuccessPage` | `number` | No | `0` (don't skip) or `1` (skip) |
+| `payout` | `string` | No | Payout details (JSON string) |
+| `returnDeeplink` | `string` | No | Mobile app deeplink |
+| `googlePayToken` | `string` | No | Required if `paymentOption` is `'google_pay'` |
+
+> `items`, `returnUrl`, `returnDeeplink`, and `payout` are automatically base64-encoded by the SDK.
+
+### `payway.checkTransaction(transactionId)`
+
+Check the status of a transaction.
+
+```typescript
+const result = await payway.checkTransaction('order-001')
+console.log(result.status.code)          // '00' = success
+console.log(result.data.payment_status)  // 'APPROVED' | 'DECLINED' | 'PENDING' | ...
+```
+
+### `payway.listTransactions(options?)`
+
+List transactions with optional filters. Max 3-day date range.
+
+```typescript
+const list = await payway.listTransactions({
+  fromDate: '2025-03-01 00:00:00',
+  toDate: '2025-03-03 23:59:59',
+  status: 'APPROVED',
+  page: 1,
+  pagination: 20,
+})
+```
+
+| Parameter | Type | Description |
+|---|---|---|
+| `fromDate` | `string` | Start date: `'YYYY-MM-DD HH:mm:ss'` |
+| `toDate` | `string` | End date: `'YYYY-MM-DD HH:mm:ss'` |
+| `fromAmount` | `number` | Minimum amount filter |
+| `toAmount` | `number` | Maximum amount filter |
+| `status` | `string` | Comma-separated: `APPROVED`, `DECLINED`, `PENDING`, `PRE-AUTH`, `CANCELLED`, `REFUNDED` |
+| `page` | `number` | Page number (default: `1`) |
+| `pagination` | `number` | Records per page (default: `40`, max: `1000`) |
+
+## Error Handling
+
+```typescript
+import { PayWay, PayWayAPIError, PayWayConfigError } from 'aba-payway'
+```
+
+| Error Class | When Thrown |
+|---|---|
+| `PayWayConfigError` | Missing or invalid constructor config |
+| `PayWayAPIError` | ABA API returns non-2xx response (has `statusCode` and `responseBody` properties) |
+| `PayWayError` | Base error class |
+| `PayWayHashError` | Hash generation failure |
+
+## Framework Examples
+
+### Next.js (App Router)
+
+```typescript
+// app/api/pay/route.ts
+import { PayWay } from 'aba-payway'
+
+const payway = new PayWay({
+  merchantId: process.env.PAYWAY_MERCHANT_ID!,
+  apiKey: process.env.PAYWAY_API_KEY!,
+  production: process.env.NODE_ENV === 'production',
+})
+
+export async function POST(request: Request) {
+  const { orderId, amount } = await request.json()
+
+  const params = payway.createTransaction({
+    transactionId: orderId,
+    amount,
+    items: 'Order payment',
+    returnUrl: `${process.env.NEXT_PUBLIC_URL}/api/pay/callback`,
+  })
+
+  return Response.json(params)
+}
+```
+
+### Express
+
+```typescript
+import express from 'express'
+import { PayWay } from 'aba-payway'
+
+const app = express()
+app.use(express.json())
+
+const payway = new PayWay({
+  merchantId: process.env.PAYWAY_MERCHANT_ID!,
+  apiKey: process.env.PAYWAY_API_KEY!,
+})
+
+app.post('/pay', (req, res) => {
+  const params = payway.createTransaction({
+    transactionId: req.body.orderId,
+    amount: req.body.amount,
+    items: 'Order payment',
+    returnUrl: 'https://yoursite.com/callback',
+  })
+  res.json(params)
+})
+```
+
+## Sandbox Test Cards
+
+| Card | Number | Expiry | CVV | Result |
+|---|---|---|---|---|
+| Mastercard | `5156 8399 3770 6777` | `01/30` | `993` | Approved |
+| Visa | `4286 0900 0000 0206` | `04/30` | `777` | Approved |
+| Mastercard | `5156 8302 7256 1029` | `04/30` | `777` | Declined |
+| Visa | `4156 8399 3770 6777` | `01/30` | `993` | Declined |
+
+## Documentation
+
+For the full ABA PayWay API documentation, see [aba-payway-docs](https://github.com/Joselay/aba-payway-docs).
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,303 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ENDPOINTS: () => ENDPOINTS,
+  PRODUCTION_BASE_URL: () => PRODUCTION_BASE_URL,
+  PayWay: () => PayWay,
+  PayWayAPIError: () => PayWayAPIError,
+  PayWayConfigError: () => PayWayConfigError,
+  PayWayError: () => PayWayError,
+  PayWayHashError: () => PayWayHashError,
+  SANDBOX_BASE_URL: () => SANDBOX_BASE_URL,
+  buildFormData: () => buildFormData,
+  createHash: () => createHash,
+  formatAmount: () => formatAmount,
+  formatRequestTime: () => formatRequestTime,
+  toBase64: () => toBase64
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/constants.ts
+var SANDBOX_BASE_URL = "https://checkout-sandbox.payway.com.kh";
+var PRODUCTION_BASE_URL = "https://checkout.payway.com.kh";
+var ENDPOINTS = {
+  purchase: "/api/payment-gateway/v1/payments/purchase",
+  checkTransaction: "/api/payment-gateway/v1/payments/check-transaction-2",
+  transactionList: "/api/payment-gateway/v1/payments/transaction-list-2"
+};
+
+// src/errors.ts
+var PayWayError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "PayWayError";
+  }
+};
+var PayWayAPIError = class extends PayWayError {
+  statusCode;
+  responseBody;
+  constructor(message, statusCode, responseBody) {
+    super(message);
+    this.name = "PayWayAPIError";
+    this.statusCode = statusCode;
+    this.responseBody = responseBody;
+  }
+};
+var PayWayConfigError = class extends PayWayError {
+  constructor(message) {
+    super(message);
+    this.name = "PayWayConfigError";
+  }
+};
+var PayWayHashError = class extends PayWayError {
+  constructor(message) {
+    super(message);
+    this.name = "PayWayHashError";
+  }
+};
+
+// src/hash.ts
+var import_node_crypto = require("crypto");
+function createHash(values, apiKey) {
+  const message = values.join("");
+  const hmac = (0, import_node_crypto.createHmac)("sha512", apiKey);
+  hmac.update(message);
+  return hmac.digest("base64");
+}
+
+// src/utils.ts
+function formatRequestTime(date = /* @__PURE__ */ new Date()) {
+  const year = date.getUTCFullYear().toString();
+  const month = (date.getUTCMonth() + 1).toString().padStart(2, "0");
+  const day = date.getUTCDate().toString().padStart(2, "0");
+  const hours = date.getUTCHours().toString().padStart(2, "0");
+  const minutes = date.getUTCMinutes().toString().padStart(2, "0");
+  const seconds = date.getUTCSeconds().toString().padStart(2, "0");
+  return `${year}${month}${day}${hours}${minutes}${seconds}`;
+}
+function buildFormData(params) {
+  const formData = new FormData();
+  for (const [key, value] of Object.entries(params)) {
+    if (value !== void 0 && value !== null && value !== "") {
+      formData.append(key, value);
+    }
+  }
+  return formData;
+}
+function formatAmount(amount, currency = "USD") {
+  if (currency.toUpperCase() === "KHR") {
+    return Math.round(amount).toString();
+  }
+  return amount.toFixed(2);
+}
+function toBase64(value) {
+  return Buffer.from(value).toString("base64");
+}
+
+// src/client.ts
+var PayWay = class {
+  merchantId;
+  apiKey;
+  baseUrl;
+  constructor(config) {
+    if (!config.merchantId) {
+      throw new PayWayConfigError("merchantId is required");
+    }
+    if (!config.apiKey) {
+      throw new PayWayConfigError("apiKey is required");
+    }
+    this.merchantId = config.merchantId;
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.production ? PRODUCTION_BASE_URL : SANDBOX_BASE_URL;
+  }
+  /**
+   * Generate checkout parameters for a transaction.
+   * Returns form params to be submitted from the browser via ABA's checkout JS SDK.
+   */
+  createTransaction(options) {
+    const reqTime = formatRequestTime();
+    const currency = options.currency ?? "USD";
+    const amount = formatAmount(options.amount, currency);
+    const type = options.type ?? "purchase";
+    let items;
+    if (Array.isArray(options.items)) {
+      items = toBase64(JSON.stringify(options.items));
+    } else if (options.items) {
+      items = toBase64(options.items);
+    } else {
+      items = "";
+    }
+    const returnUrl = options.returnUrl ? toBase64(options.returnUrl) : "";
+    const returnDeeplink = options.returnDeeplink ? toBase64(options.returnDeeplink) : "";
+    const payout = options.payout ? toBase64(options.payout) : "";
+    const shipping = options.shipping !== void 0 ? formatAmount(options.shipping, currency) : "";
+    const hashValues = [
+      reqTime,
+      this.merchantId,
+      options.transactionId,
+      amount,
+      items,
+      shipping,
+      options.firstName ?? "",
+      options.lastName ?? "",
+      options.email ?? "",
+      options.phone ?? "",
+      type,
+      options.paymentOption ?? "",
+      returnUrl,
+      options.cancelUrl ?? "",
+      options.continueSuccessUrl ?? "",
+      returnDeeplink,
+      currency,
+      options.customFields ?? "",
+      options.returnParams ?? "",
+      options.viewType ?? "",
+      options.paymentGate?.toString() ?? "",
+      payout,
+      options.lifetime?.toString() ?? "",
+      options.additionalParams ?? "",
+      options.googlePayToken ?? "",
+      options.skipSuccessPage?.toString() ?? ""
+    ];
+    const hash = createHash(hashValues, this.apiKey);
+    return {
+      action: `${this.baseUrl}${ENDPOINTS.purchase}`,
+      hash,
+      tran_id: options.transactionId,
+      amount,
+      items,
+      currency,
+      firstname: options.firstName ?? "",
+      lastname: options.lastName ?? "",
+      email: options.email ?? "",
+      phone: options.phone ?? "",
+      type,
+      payment_option: options.paymentOption ?? "",
+      return_url: returnUrl,
+      cancel_url: options.cancelUrl ?? "",
+      continue_success_url: options.continueSuccessUrl ?? "",
+      return_deeplink: returnDeeplink,
+      return_params: options.returnParams ?? "",
+      shipping,
+      merchant_id: this.merchantId,
+      req_time: reqTime,
+      custom_fields: options.customFields ?? "",
+      payout,
+      lifetime: options.lifetime?.toString() ?? "",
+      additional_params: options.additionalParams ?? "",
+      google_pay_token: options.googlePayToken ?? "",
+      skip_success_page: options.skipSuccessPage?.toString() ?? "",
+      view_type: options.viewType ?? "",
+      payment_gate: options.paymentGate?.toString() ?? ""
+    };
+  }
+  async checkTransaction(transactionId) {
+    const reqTime = formatRequestTime();
+    const hashValues = [reqTime, this.merchantId, transactionId];
+    const hash = createHash(hashValues, this.apiKey);
+    const params = {
+      hash,
+      tran_id: transactionId,
+      req_time: reqTime,
+      merchant_id: this.merchantId
+    };
+    return this.request(
+      ENDPOINTS.checkTransaction,
+      params
+    );
+  }
+  async listTransactions(options = {}) {
+    const reqTime = formatRequestTime();
+    const hashValues = [
+      reqTime,
+      this.merchantId,
+      options.fromDate ?? "",
+      options.toDate ?? "",
+      options.fromAmount?.toString() ?? "",
+      options.toAmount?.toString() ?? "",
+      options.status ?? "",
+      options.page?.toString() ?? "",
+      options.pagination?.toString() ?? ""
+    ];
+    const hash = createHash(hashValues, this.apiKey);
+    const params = {
+      hash,
+      from_date: options.fromDate,
+      to_date: options.toDate,
+      from_amount: options.fromAmount?.toString(),
+      to_amount: options.toAmount?.toString(),
+      status: options.status,
+      page: options.page?.toString(),
+      pagination: options.pagination?.toString(),
+      req_time: reqTime,
+      merchant_id: this.merchantId
+    };
+    return this.request(
+      ENDPOINTS.transactionList,
+      params
+    );
+  }
+  async request(endpoint, params) {
+    const url = `${this.baseUrl}${endpoint}`;
+    const formData = new FormData();
+    for (const [key, value] of Object.entries(params)) {
+      if (value !== void 0 && value !== null && value !== "") {
+        formData.append(key, value);
+      }
+    }
+    const response = await fetch(url, {
+      method: "POST",
+      body: formData
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      let body = text;
+      try {
+        body = JSON.parse(text);
+      } catch {
+      }
+      throw new PayWayAPIError(
+        `PayWay API error: ${response.status} ${response.statusText}`,
+        response.status,
+        body
+      );
+    }
+    return await response.json();
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ENDPOINTS,
+  PRODUCTION_BASE_URL,
+  PayWay,
+  PayWayAPIError,
+  PayWayConfigError,
+  PayWayError,
+  PayWayHashError,
+  SANDBOX_BASE_URL,
+  buildFormData,
+  createHash,
+  formatAmount,
+  formatRequestTime,
+  toBase64
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/constants.ts","../src/errors.ts","../src/hash.ts","../src/utils.ts","../src/client.ts"],"sourcesContent":["export { PayWay } from \"./client.ts\";\nexport {\n\tENDPOINTS,\n\tPRODUCTION_BASE_URL,\n\tSANDBOX_BASE_URL,\n} from \"./constants.ts\";\nexport {\n\tPayWayAPIError,\n\tPayWayConfigError,\n\tPayWayError,\n\tPayWayHashError,\n} from \"./errors.ts\";\nexport { createHash } from \"./hash.ts\";\nexport type {\n\tCheckoutParams,\n\tCheckTransactionData,\n\tCheckTransactionOptions,\n\tCreateTransactionOptions,\n\tCurrency,\n\tItemEntry,\n\tListTransactionsData,\n\tListTransactionsOptions,\n\tListTransactionsResponse,\n\tPaymentOption,\n\tPayWayConfig,\n\tPayWayResponse,\n\tPayWayResponseStatus,\n\tTransactionListItem,\n\tTransactionStatus,\n\tTransactionType,\n} from \"./types.ts\";\nexport {\n\tbuildFormData,\n\tformatAmount,\n\tformatRequestTime,\n\ttoBase64,\n} from \"./utils.ts\";\n","export const SANDBOX_BASE_URL = \"https://checkout-sandbox.payway.com.kh\";\nexport const PRODUCTION_BASE_URL = \"https://checkout.payway.com.kh\";\n\nexport const ENDPOINTS = {\n\tpurchase: \"/api/payment-gateway/v1/payments/purchase\",\n\tcheckTransaction: \"/api/payment-gateway/v1/payments/check-transaction-2\",\n\ttransactionList: \"/api/payment-gateway/v1/payments/transaction-list-2\",\n} as const;\n","export class PayWayError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"PayWayError\";\n\t}\n}\n\nexport class PayWayAPIError extends PayWayError {\n\tpublic readonly statusCode: number;\n\tpublic readonly responseBody: unknown;\n\n\tconstructor(message: string, statusCode: number, responseBody?: unknown) {\n\t\tsuper(message);\n\t\tthis.name = \"PayWayAPIError\";\n\t\tthis.statusCode = statusCode;\n\t\tthis.responseBody = responseBody;\n\t}\n}\n\nexport class PayWayConfigError extends PayWayError {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"PayWayConfigError\";\n\t}\n}\n\nexport class PayWayHashError extends PayWayError {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"PayWayHashError\";\n\t}\n}\n","import { createHmac } from \"node:crypto\";\n\nexport function createHash(values: string[], apiKey: string): string {\n\tconst message = values.join(\"\");\n\tconst hmac = createHmac(\"sha512\", apiKey);\n\thmac.update(message);\n\treturn hmac.digest(\"base64\");\n}\n","export function formatRequestTime(date: Date = new Date()): string {\n\tconst year = date.getUTCFullYear().toString();\n\tconst month = (date.getUTCMonth() + 1).toString().padStart(2, \"0\");\n\tconst day = date.getUTCDate().toString().padStart(2, \"0\");\n\tconst hours = date.getUTCHours().toString().padStart(2, \"0\");\n\tconst minutes = date.getUTCMinutes().toString().padStart(2, \"0\");\n\tconst seconds = date.getUTCSeconds().toString().padStart(2, \"0\");\n\treturn `${year}${month}${day}${hours}${minutes}${seconds}`;\n}\n\nexport function buildFormData(\n\tparams: Record<string, string | undefined>,\n): FormData {\n\tconst formData = new FormData();\n\tfor (const [key, value] of Object.entries(params)) {\n\t\tif (value !== undefined && value !== null && value !== \"\") {\n\t\t\tformData.append(key, value);\n\t\t}\n\t}\n\treturn formData;\n}\n\nexport function formatAmount(amount: number, currency = \"USD\"): string {\n\tif (currency.toUpperCase() === \"KHR\") {\n\t\treturn Math.round(amount).toString();\n\t}\n\treturn amount.toFixed(2);\n}\n\nexport function toBase64(value: string): string {\n\treturn Buffer.from(value).toString(\"base64\");\n}\n","import {\n\tENDPOINTS,\n\tPRODUCTION_BASE_URL,\n\tSANDBOX_BASE_URL,\n} from \"./constants.ts\";\nimport { PayWayAPIError, PayWayConfigError } from \"./errors.ts\";\nimport { createHash } from \"./hash.ts\";\nimport type {\n\tCheckoutParams,\n\tCheckTransactionData,\n\tCreateTransactionOptions,\n\tListTransactionsOptions,\n\tListTransactionsResponse,\n\tPayWayConfig,\n\tPayWayResponse,\n} from \"./types.ts\";\nimport { formatAmount, formatRequestTime, toBase64 } from \"./utils.ts\";\n\nexport class PayWay {\n\tprivate readonly merchantId: string;\n\tprivate readonly apiKey: string;\n\tprivate readonly baseUrl: string;\n\n\tconstructor(config: PayWayConfig) {\n\t\tif (!config.merchantId) {\n\t\t\tthrow new PayWayConfigError(\"merchantId is required\");\n\t\t}\n\t\tif (!config.apiKey) {\n\t\t\tthrow new PayWayConfigError(\"apiKey is required\");\n\t\t}\n\n\t\tthis.merchantId = config.merchantId;\n\t\tthis.apiKey = config.apiKey;\n\t\tthis.baseUrl = config.production ? PRODUCTION_BASE_URL : SANDBOX_BASE_URL;\n\t}\n\n\t/**\n\t * Generate checkout parameters for a transaction.\n\t * Returns form params to be submitted from the browser via ABA's checkout JS SDK.\n\t */\n\tcreateTransaction(options: CreateTransactionOptions): CheckoutParams {\n\t\tconst reqTime = formatRequestTime();\n\t\tconst currency = options.currency ?? \"USD\";\n\t\tconst amount = formatAmount(options.amount, currency);\n\t\tconst type = options.type ?? \"purchase\";\n\n\t\t// Items: if array, JSON-stringify and base64-encode; if string, base64-encode as-is\n\t\tlet items: string;\n\t\tif (Array.isArray(options.items)) {\n\t\t\titems = toBase64(JSON.stringify(options.items));\n\t\t} else if (options.items) {\n\t\t\titems = toBase64(options.items);\n\t\t} else {\n\t\t\titems = \"\";\n\t\t}\n\n\t\t// Return URL and return deeplink must be base64-encoded per ABA docs\n\t\tconst returnUrl = options.returnUrl ? toBase64(options.returnUrl) : \"\";\n\t\tconst returnDeeplink = options.returnDeeplink\n\t\t\t? toBase64(options.returnDeeplink)\n\t\t\t: \"\";\n\n\t\t// Payout must be base64-encoded JSON string per ABA docs\n\t\tconst payout = options.payout ? toBase64(options.payout) : \"\";\n\n\t\tconst shipping =\n\t\t\toptions.shipping !== undefined\n\t\t\t\t? formatAmount(options.shipping, currency)\n\t\t\t\t: \"\";\n\n\t\t// Hash field order must match ABA's expected order exactly\n\t\tconst hashValues = [\n\t\t\treqTime,\n\t\t\tthis.merchantId,\n\t\t\toptions.transactionId,\n\t\t\tamount,\n\t\t\titems,\n\t\t\tshipping,\n\t\t\toptions.firstName ?? \"\",\n\t\t\toptions.lastName ?? \"\",\n\t\t\toptions.email ?? \"\",\n\t\t\toptions.phone ?? \"\",\n\t\t\ttype,\n\t\t\toptions.paymentOption ?? \"\",\n\t\t\treturnUrl,\n\t\t\toptions.cancelUrl ?? \"\",\n\t\t\toptions.continueSuccessUrl ?? \"\",\n\t\t\treturnDeeplink,\n\t\t\tcurrency,\n\t\t\toptions.customFields ?? \"\",\n\t\t\toptions.returnParams ?? \"\",\n\t\t\toptions.viewType ?? \"\",\n\t\t\toptions.paymentGate?.toString() ?? \"\",\n\t\t\tpayout,\n\t\t\toptions.lifetime?.toString() ?? \"\",\n\t\t\toptions.additionalParams ?? \"\",\n\t\t\toptions.googlePayToken ?? \"\",\n\t\t\toptions.skipSuccessPage?.toString() ?? \"\",\n\t\t];\n\n\t\tconst hash = createHash(hashValues, this.apiKey);\n\n\t\treturn {\n\t\t\taction: `${this.baseUrl}${ENDPOINTS.purchase}`,\n\t\t\thash,\n\t\t\ttran_id: options.transactionId,\n\t\t\tamount,\n\t\t\titems,\n\t\t\tcurrency,\n\t\t\tfirstname: options.firstName ?? \"\",\n\t\t\tlastname: options.lastName ?? \"\",\n\t\t\temail: options.email ?? \"\",\n\t\t\tphone: options.phone ?? \"\",\n\t\t\ttype,\n\t\t\tpayment_option: options.paymentOption ?? \"\",\n\t\t\treturn_url: returnUrl,\n\t\t\tcancel_url: options.cancelUrl ?? \"\",\n\t\t\tcontinue_success_url: options.continueSuccessUrl ?? \"\",\n\t\t\treturn_deeplink: returnDeeplink,\n\t\t\treturn_params: options.returnParams ?? \"\",\n\t\t\tshipping,\n\t\t\tmerchant_id: this.merchantId,\n\t\t\treq_time: reqTime,\n\t\t\tcustom_fields: options.customFields ?? \"\",\n\t\t\tpayout,\n\t\t\tlifetime: options.lifetime?.toString() ?? \"\",\n\t\t\tadditional_params: options.additionalParams ?? \"\",\n\t\t\tgoogle_pay_token: options.googlePayToken ?? \"\",\n\t\t\tskip_success_page: options.skipSuccessPage?.toString() ?? \"\",\n\t\t\tview_type: options.viewType ?? \"\",\n\t\t\tpayment_gate: options.paymentGate?.toString() ?? \"\",\n\t\t};\n\t}\n\n\tasync checkTransaction(\n\t\ttransactionId: string,\n\t): Promise<PayWayResponse<CheckTransactionData>> {\n\t\tconst reqTime = formatRequestTime();\n\n\t\tconst hashValues = [reqTime, this.merchantId, transactionId];\n\t\tconst hash = createHash(hashValues, this.apiKey);\n\n\t\tconst params: Record<string, string | undefined> = {\n\t\t\thash,\n\t\t\ttran_id: transactionId,\n\t\t\treq_time: reqTime,\n\t\t\tmerchant_id: this.merchantId,\n\t\t};\n\n\t\treturn this.request<PayWayResponse<CheckTransactionData>>(\n\t\t\tENDPOINTS.checkTransaction,\n\t\t\tparams,\n\t\t);\n\t}\n\n\tasync listTransactions(\n\t\toptions: ListTransactionsOptions = {},\n\t): Promise<ListTransactionsResponse> {\n\t\tconst reqTime = formatRequestTime();\n\n\t\tconst hashValues = [\n\t\t\treqTime,\n\t\t\tthis.merchantId,\n\t\t\toptions.fromDate ?? \"\",\n\t\t\toptions.toDate ?? \"\",\n\t\t\toptions.fromAmount?.toString() ?? \"\",\n\t\t\toptions.toAmount?.toString() ?? \"\",\n\t\t\toptions.status ?? \"\",\n\t\t\toptions.page?.toString() ?? \"\",\n\t\t\toptions.pagination?.toString() ?? \"\",\n\t\t];\n\t\tconst hash = createHash(hashValues, this.apiKey);\n\n\t\tconst params: Record<string, string | undefined> = {\n\t\t\thash,\n\t\t\tfrom_date: options.fromDate,\n\t\t\tto_date: options.toDate,\n\t\t\tfrom_amount: options.fromAmount?.toString(),\n\t\t\tto_amount: options.toAmount?.toString(),\n\t\t\tstatus: options.status,\n\t\t\tpage: options.page?.toString(),\n\t\t\tpagination: options.pagination?.toString(),\n\t\t\treq_time: reqTime,\n\t\t\tmerchant_id: this.merchantId,\n\t\t};\n\n\t\treturn this.request<ListTransactionsResponse>(\n\t\t\tENDPOINTS.transactionList,\n\t\t\tparams,\n\t\t);\n\t}\n\n\tprivate async request<T>(\n\t\tendpoint: string,\n\t\tparams: Record<string, string | undefined>,\n\t): Promise<T> {\n\t\tconst url = `${this.baseUrl}${endpoint}`;\n\t\tconst formData = new FormData();\n\t\tfor (const [key, value] of Object.entries(params)) {\n\t\t\tif (value !== undefined && value !== null && value !== \"\") {\n\t\t\t\tformData.append(key, value);\n\t\t\t}\n\t\t}\n\n\t\tconst response = await fetch(url, {\n\t\t\tmethod: \"POST\",\n\t\t\tbody: formData,\n\t\t});\n\n\t\tif (!response.ok) {\n\t\t\tconst text = await response.text();\n\t\t\tlet body: unknown = text;\n\t\t\ttry {\n\t\t\t\tbody = JSON.parse(text);\n\t\t\t} catch {\n\t\t\t\t// keep as text\n\t\t\t}\n\t\t\tthrow new PayWayAPIError(\n\t\t\t\t`PayWay API error: ${response.status} ${response.statusText}`,\n\t\t\t\tresponse.status,\n\t\t\t\tbody,\n\t\t\t);\n\t\t}\n\n\t\treturn (await response.json()) as T;\n\t}\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,187 @@
+interface PayWayConfig {
+    merchantId: string;
+    apiKey: string;
+    production?: boolean;
+}
+type PaymentOption = "cards" | "abapay_khqr" | "abapay_khqr_deeplink" | "alipay" | "wechat" | "google_pay";
+type Currency = "USD" | "KHR";
+type TransactionType = "purchase" | "pre-auth";
+type TransactionStatus = "APPROVED" | "DECLINED" | "PENDING" | "PRE-AUTH" | "CANCELLED" | "REFUNDED";
+interface CreateTransactionOptions {
+    transactionId: string;
+    amount: number;
+    currency?: Currency;
+    paymentOption?: PaymentOption;
+    firstName?: string;
+    lastName?: string;
+    email?: string;
+    phone?: string;
+    /** Items as a string, or an array of objects (will be JSON-stringified and base64-encoded) */
+    items?: string | ItemEntry[];
+    returnUrl?: string;
+    cancelUrl?: string;
+    continueSuccessUrl?: string;
+    returnDeeplink?: string;
+    returnParams?: string;
+    shipping?: number;
+    type?: TransactionType;
+    customFields?: string;
+    payout?: string;
+    lifetime?: number;
+    additionalParams?: string;
+    googlePayToken?: string;
+    skipSuccessPage?: number;
+    viewType?: string;
+    paymentGate?: number;
+}
+interface ItemEntry {
+    name: string;
+    quantity: string;
+    price: string;
+}
+/** Form parameters returned by createTransaction, to be submitted from the browser */
+interface CheckoutParams {
+    action: string;
+    hash: string;
+    tran_id: string;
+    amount: string;
+    items: string;
+    currency: Currency;
+    firstname: string;
+    lastname: string;
+    email: string;
+    phone: string;
+    type: TransactionType;
+    payment_option: PaymentOption | "";
+    return_url: string;
+    cancel_url: string;
+    continue_success_url: string;
+    return_deeplink: string;
+    return_params: string;
+    shipping: string;
+    merchant_id: string;
+    req_time: string;
+    custom_fields: string;
+    payout: string;
+    lifetime: string;
+    additional_params: string;
+    google_pay_token: string;
+    skip_success_page: string;
+    view_type: string;
+    payment_gate: string;
+}
+interface CheckTransactionOptions {
+    transactionId: string;
+}
+interface ListTransactionsOptions {
+    fromDate?: string;
+    toDate?: string;
+    fromAmount?: number;
+    toAmount?: number;
+    status?: string;
+    page?: number;
+    pagination?: number;
+}
+interface PayWayResponse<T> {
+    status: PayWayResponseStatus;
+    description?: string;
+    data?: T;
+}
+interface PayWayResponseStatus {
+    code: string;
+    message?: string;
+    tran_id?: string;
+}
+interface CheckTransactionData {
+    payment_status_code: number;
+    total_amount: number;
+    original_amount: number;
+    refund_amount: number;
+    discount_amount: number;
+    payment_amount: number;
+    payment_currency: string;
+    apv: string;
+    payment_status: string;
+    transaction_date: string;
+}
+interface TransactionListItem {
+    transaction_id: string;
+    transaction_date: string;
+    apv: string;
+    payment_status: string;
+    payment_status_code: number;
+    original_amount: number;
+    original_currency: string;
+    total_amount: number;
+    discount_amount: number;
+    refund_amount: number;
+    payment_amount: number;
+    payment_currency: string;
+    first_name: string;
+    last_name: string;
+    email: string;
+    phone: string;
+    bank_ref: string;
+    payer_account: string;
+    bank_name: string;
+    card_source: string;
+    payment_type: string;
+}
+interface ListTransactionsData {
+    data: TransactionListItem[];
+    page: string;
+    pagination: string;
+}
+interface ListTransactionsResponse {
+    data: TransactionListItem[];
+    page: string;
+    pagination: string;
+    status: PayWayResponseStatus;
+}
+
+declare class PayWay {
+    private readonly merchantId;
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(config: PayWayConfig);
+    /**
+     * Generate checkout parameters for a transaction.
+     * Returns form params to be submitted from the browser via ABA's checkout JS SDK.
+     */
+    createTransaction(options: CreateTransactionOptions): CheckoutParams;
+    checkTransaction(transactionId: string): Promise<PayWayResponse<CheckTransactionData>>;
+    listTransactions(options?: ListTransactionsOptions): Promise<ListTransactionsResponse>;
+    private request;
+}
+
+declare const SANDBOX_BASE_URL = "https://checkout-sandbox.payway.com.kh";
+declare const PRODUCTION_BASE_URL = "https://checkout.payway.com.kh";
+declare const ENDPOINTS: {
+    readonly purchase: "/api/payment-gateway/v1/payments/purchase";
+    readonly checkTransaction: "/api/payment-gateway/v1/payments/check-transaction-2";
+    readonly transactionList: "/api/payment-gateway/v1/payments/transaction-list-2";
+};
+
+declare class PayWayError extends Error {
+    constructor(message: string);
+}
+declare class PayWayAPIError extends PayWayError {
+    readonly statusCode: number;
+    readonly responseBody: unknown;
+    constructor(message: string, statusCode: number, responseBody?: unknown);
+}
+declare class PayWayConfigError extends PayWayError {
+    constructor(message: string);
+}
+declare class PayWayHashError extends PayWayError {
+    constructor(message: string);
+}
+
+declare function createHash(values: string[], apiKey: string): string;
+
+declare function formatRequestTime(date?: Date): string;
+declare function buildFormData(params: Record<string, string | undefined>): FormData;
+declare function formatAmount(amount: number, currency?: string): string;
+declare function toBase64(value: string): string;
+
+export { type CheckTransactionData, type CheckTransactionOptions, type CheckoutParams, type CreateTransactionOptions, type Currency, ENDPOINTS, type ItemEntry, type ListTransactionsData, type ListTransactionsOptions, type ListTransactionsResponse, PRODUCTION_BASE_URL, PayWay, PayWayAPIError, type PayWayConfig, PayWayConfigError, PayWayError, PayWayHashError, type PayWayResponse, type PayWayResponseStatus, type PaymentOption, SANDBOX_BASE_URL, type TransactionListItem, type TransactionStatus, type TransactionType, buildFormData, createHash, formatAmount, formatRequestTime, toBase64 };

package/dist/index.d.ts

@@ -0,0 +1,187 @@
+interface PayWayConfig {
+    merchantId: string;
+    apiKey: string;
+    production?: boolean;
+}
+type PaymentOption = "cards" | "abapay_khqr" | "abapay_khqr_deeplink" | "alipay" | "wechat" | "google_pay";
+type Currency = "USD" | "KHR";
+type TransactionType = "purchase" | "pre-auth";
+type TransactionStatus = "APPROVED" | "DECLINED" | "PENDING" | "PRE-AUTH" | "CANCELLED" | "REFUNDED";
+interface CreateTransactionOptions {
+    transactionId: string;
+    amount: number;
+    currency?: Currency;
+    paymentOption?: PaymentOption;
+    firstName?: string;
+    lastName?: string;
+    email?: string;
+    phone?: string;
+    /** Items as a string, or an array of objects (will be JSON-stringified and base64-encoded) */
+    items?: string | ItemEntry[];
+    returnUrl?: string;
+    cancelUrl?: string;
+    continueSuccessUrl?: string;
+    returnDeeplink?: string;
+    returnParams?: string;
+    shipping?: number;
+    type?: TransactionType;
+    customFields?: string;
+    payout?: string;
+    lifetime?: number;
+    additionalParams?: string;
+    googlePayToken?: string;
+    skipSuccessPage?: number;
+    viewType?: string;
+    paymentGate?: number;
+}
+interface ItemEntry {
+    name: string;
+    quantity: string;
+    price: string;
+}
+/** Form parameters returned by createTransaction, to be submitted from the browser */
+interface CheckoutParams {
+    action: string;
+    hash: string;
+    tran_id: string;
+    amount: string;
+    items: string;
+    currency: Currency;
+    firstname: string;
+    lastname: string;
+    email: string;
+    phone: string;
+    type: TransactionType;
+    payment_option: PaymentOption | "";
+    return_url: string;
+    cancel_url: string;
+    continue_success_url: string;
+    return_deeplink: string;
+    return_params: string;
+    shipping: string;
+    merchant_id: string;
+    req_time: string;
+    custom_fields: string;
+    payout: string;
+    lifetime: string;
+    additional_params: string;
+    google_pay_token: string;
+    skip_success_page: string;
+    view_type: string;
+    payment_gate: string;
+}
+interface CheckTransactionOptions {
+    transactionId: string;
+}
+interface ListTransactionsOptions {
+    fromDate?: string;
+    toDate?: string;
+    fromAmount?: number;
+    toAmount?: number;
+    status?: string;
+    page?: number;
+    pagination?: number;
+}
+interface PayWayResponse<T> {
+    status: PayWayResponseStatus;
+    description?: string;
+    data?: T;
+}
+interface PayWayResponseStatus {
+    code: string;
+    message?: string;
+    tran_id?: string;
+}
+interface CheckTransactionData {
+    payment_status_code: number;
+    total_amount: number;
+    original_amount: number;
+    refund_amount: number;
+    discount_amount: number;
+    payment_amount: number;
+    payment_currency: string;
+    apv: string;
+    payment_status: string;
+    transaction_date: string;
+}
+interface TransactionListItem {
+    transaction_id: string;
+    transaction_date: string;
+    apv: string;
+    payment_status: string;
+    payment_status_code: number;
+    original_amount: number;
+    original_currency: string;
+    total_amount: number;
+    discount_amount: number;
+    refund_amount: number;
+    payment_amount: number;
+    payment_currency: string;
+    first_name: string;
+    last_name: string;
+    email: string;
+    phone: string;
+    bank_ref: string;
+    payer_account: string;
+    bank_name: string;
+    card_source: string;
+    payment_type: string;
+}
+interface ListTransactionsData {
+    data: TransactionListItem[];
+    page: string;
+    pagination: string;
+}
+interface ListTransactionsResponse {
+    data: TransactionListItem[];
+    page: string;
+    pagination: string;
+    status: PayWayResponseStatus;
+}
+
+declare class PayWay {
+    private readonly merchantId;
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(config: PayWayConfig);
+    /**
+     * Generate checkout parameters for a transaction.
+     * Returns form params to be submitted from the browser via ABA's checkout JS SDK.
+     */
+    createTransaction(options: CreateTransactionOptions): CheckoutParams;
+    checkTransaction(transactionId: string): Promise<PayWayResponse<CheckTransactionData>>;
+    listTransactions(options?: ListTransactionsOptions): Promise<ListTransactionsResponse>;
+    private request;
+}
+
+declare const SANDBOX_BASE_URL = "https://checkout-sandbox.payway.com.kh";
+declare const PRODUCTION_BASE_URL = "https://checkout.payway.com.kh";
+declare const ENDPOINTS: {
+    readonly purchase: "/api/payment-gateway/v1/payments/purchase";
+    readonly checkTransaction: "/api/payment-gateway/v1/payments/check-transaction-2";
+    readonly transactionList: "/api/payment-gateway/v1/payments/transaction-list-2";
+};
+
+declare class PayWayError extends Error {
+    constructor(message: string);
+}
+declare class PayWayAPIError extends PayWayError {
+    readonly statusCode: number;
+    readonly responseBody: unknown;
+    constructor(message: string, statusCode: number, responseBody?: unknown);
+}
+declare class PayWayConfigError extends PayWayError {
+    constructor(message: string);
+}
+declare class PayWayHashError extends PayWayError {
+    constructor(message: string);
+}
+
+declare function createHash(values: string[], apiKey: string): string;
+
+declare function formatRequestTime(date?: Date): string;
+declare function buildFormData(params: Record<string, string | undefined>): FormData;
+declare function formatAmount(amount: number, currency?: string): string;
+declare function toBase64(value: string): string;
+
+export { type CheckTransactionData, type CheckTransactionOptions, type CheckoutParams, type CreateTransactionOptions, type Currency, ENDPOINTS, type ItemEntry, type ListTransactionsData, type ListTransactionsOptions, type ListTransactionsResponse, PRODUCTION_BASE_URL, PayWay, PayWayAPIError, type PayWayConfig, PayWayConfigError, PayWayError, PayWayHashError, type PayWayResponse, type PayWayResponseStatus, type PaymentOption, SANDBOX_BASE_URL, type TransactionListItem, type TransactionStatus, type TransactionType, buildFormData, createHash, formatAmount, formatRequestTime, toBase64 };

package/dist/index.js

@@ -0,0 +1,264 @@
+// src/constants.ts
+var SANDBOX_BASE_URL = "https://checkout-sandbox.payway.com.kh";
+var PRODUCTION_BASE_URL = "https://checkout.payway.com.kh";
+var ENDPOINTS = {
+  purchase: "/api/payment-gateway/v1/payments/purchase",
+  checkTransaction: "/api/payment-gateway/v1/payments/check-transaction-2",
+  transactionList: "/api/payment-gateway/v1/payments/transaction-list-2"
+};
+
+// src/errors.ts
+var PayWayError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "PayWayError";
+  }
+};
+var PayWayAPIError = class extends PayWayError {
+  statusCode;
+  responseBody;
+  constructor(message, statusCode, responseBody) {
+    super(message);
+    this.name = "PayWayAPIError";
+    this.statusCode = statusCode;
+    this.responseBody = responseBody;
+  }
+};
+var PayWayConfigError = class extends PayWayError {
+  constructor(message) {
+    super(message);
+    this.name = "PayWayConfigError";
+  }
+};
+var PayWayHashError = class extends PayWayError {
+  constructor(message) {
+    super(message);
+    this.name = "PayWayHashError";
+  }
+};
+
+// src/hash.ts
+import { createHmac } from "crypto";
+function createHash(values, apiKey) {
+  const message = values.join("");
+  const hmac = createHmac("sha512", apiKey);
+  hmac.update(message);
+  return hmac.digest("base64");
+}
+
+// src/utils.ts
+function formatRequestTime(date = /* @__PURE__ */ new Date()) {
+  const year = date.getUTCFullYear().toString();
+  const month = (date.getUTCMonth() + 1).toString().padStart(2, "0");
+  const day = date.getUTCDate().toString().padStart(2, "0");
+  const hours = date.getUTCHours().toString().padStart(2, "0");
+  const minutes = date.getUTCMinutes().toString().padStart(2, "0");
+  const seconds = date.getUTCSeconds().toString().padStart(2, "0");
+  return `${year}${month}${day}${hours}${minutes}${seconds}`;
+}
+function buildFormData(params) {
+  const formData = new FormData();
+  for (const [key, value] of Object.entries(params)) {
+    if (value !== void 0 && value !== null && value !== "") {
+      formData.append(key, value);
+    }
+  }
+  return formData;
+}
+function formatAmount(amount, currency = "USD") {
+  if (currency.toUpperCase() === "KHR") {
+    return Math.round(amount).toString();
+  }
+  return amount.toFixed(2);
+}
+function toBase64(value) {
+  return Buffer.from(value).toString("base64");
+}
+
+// src/client.ts
+var PayWay = class {
+  merchantId;
+  apiKey;
+  baseUrl;
+  constructor(config) {
+    if (!config.merchantId) {
+      throw new PayWayConfigError("merchantId is required");
+    }
+    if (!config.apiKey) {
+      throw new PayWayConfigError("apiKey is required");
+    }
+    this.merchantId = config.merchantId;
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.production ? PRODUCTION_BASE_URL : SANDBOX_BASE_URL;
+  }
+  /**
+   * Generate checkout parameters for a transaction.
+   * Returns form params to be submitted from the browser via ABA's checkout JS SDK.
+   */
+  createTransaction(options) {
+    const reqTime = formatRequestTime();
+    const currency = options.currency ?? "USD";
+    const amount = formatAmount(options.amount, currency);
+    const type = options.type ?? "purchase";
+    let items;
+    if (Array.isArray(options.items)) {
+      items = toBase64(JSON.stringify(options.items));
+    } else if (options.items) {
+      items = toBase64(options.items);
+    } else {
+      items = "";
+    }
+    const returnUrl = options.returnUrl ? toBase64(options.returnUrl) : "";
+    const returnDeeplink = options.returnDeeplink ? toBase64(options.returnDeeplink) : "";
+    const payout = options.payout ? toBase64(options.payout) : "";
+    const shipping = options.shipping !== void 0 ? formatAmount(options.shipping, currency) : "";
+    const hashValues = [
+      reqTime,
+      this.merchantId,
+      options.transactionId,
+      amount,
+      items,
+      shipping,
+      options.firstName ?? "",
+      options.lastName ?? "",
+      options.email ?? "",
+      options.phone ?? "",
+      type,
+      options.paymentOption ?? "",
+      returnUrl,
+      options.cancelUrl ?? "",
+      options.continueSuccessUrl ?? "",
+      returnDeeplink,
+      currency,
+      options.customFields ?? "",
+      options.returnParams ?? "",
+      options.viewType ?? "",
+      options.paymentGate?.toString() ?? "",
+      payout,
+      options.lifetime?.toString() ?? "",
+      options.additionalParams ?? "",
+      options.googlePayToken ?? "",
+      options.skipSuccessPage?.toString() ?? ""
+    ];
+    const hash = createHash(hashValues, this.apiKey);
+    return {
+      action: `${this.baseUrl}${ENDPOINTS.purchase}`,
+      hash,
+      tran_id: options.transactionId,
+      amount,
+      items,
+      currency,
+      firstname: options.firstName ?? "",
+      lastname: options.lastName ?? "",
+      email: options.email ?? "",
+      phone: options.phone ?? "",
+      type,
+      payment_option: options.paymentOption ?? "",
+      return_url: returnUrl,
+      cancel_url: options.cancelUrl ?? "",
+      continue_success_url: options.continueSuccessUrl ?? "",
+      return_deeplink: returnDeeplink,
+      return_params: options.returnParams ?? "",
+      shipping,
+      merchant_id: this.merchantId,
+      req_time: reqTime,
+      custom_fields: options.customFields ?? "",
+      payout,
+      lifetime: options.lifetime?.toString() ?? "",
+      additional_params: options.additionalParams ?? "",
+      google_pay_token: options.googlePayToken ?? "",
+      skip_success_page: options.skipSuccessPage?.toString() ?? "",
+      view_type: options.viewType ?? "",
+      payment_gate: options.paymentGate?.toString() ?? ""
+    };
+  }
+  async checkTransaction(transactionId) {
+    const reqTime = formatRequestTime();
+    const hashValues = [reqTime, this.merchantId, transactionId];
+    const hash = createHash(hashValues, this.apiKey);
+    const params = {
+      hash,
+      tran_id: transactionId,
+      req_time: reqTime,
+      merchant_id: this.merchantId
+    };
+    return this.request(
+      ENDPOINTS.checkTransaction,
+      params
+    );
+  }
+  async listTransactions(options = {}) {
+    const reqTime = formatRequestTime();
+    const hashValues = [
+      reqTime,
+      this.merchantId,
+      options.fromDate ?? "",
+      options.toDate ?? "",
+      options.fromAmount?.toString() ?? "",
+      options.toAmount?.toString() ?? "",
+      options.status ?? "",
+      options.page?.toString() ?? "",
+      options.pagination?.toString() ?? ""
+    ];
+    const hash = createHash(hashValues, this.apiKey);
+    const params = {
+      hash,
+      from_date: options.fromDate,
+      to_date: options.toDate,
+      from_amount: options.fromAmount?.toString(),
+      to_amount: options.toAmount?.toString(),
+      status: options.status,
+      page: options.page?.toString(),
+      pagination: options.pagination?.toString(),
+      req_time: reqTime,
+      merchant_id: this.merchantId
+    };
+    return this.request(
+      ENDPOINTS.transactionList,
+      params
+    );
+  }
+  async request(endpoint, params) {
+    const url = `${this.baseUrl}${endpoint}`;
+    const formData = new FormData();
+    for (const [key, value] of Object.entries(params)) {
+      if (value !== void 0 && value !== null && value !== "") {
+        formData.append(key, value);
+      }
+    }
+    const response = await fetch(url, {
+      method: "POST",
+      body: formData
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      let body = text;
+      try {
+        body = JSON.parse(text);
+      } catch {
+      }
+      throw new PayWayAPIError(
+        `PayWay API error: ${response.status} ${response.statusText}`,
+        response.status,
+        body
+      );
+    }
+    return await response.json();
+  }
+};
+export {
+  ENDPOINTS,
+  PRODUCTION_BASE_URL,
+  PayWay,
+  PayWayAPIError,
+  PayWayConfigError,
+  PayWayError,
+  PayWayHashError,
+  SANDBOX_BASE_URL,
+  buildFormData,
+  createHash,
+  formatAmount,
+  formatRequestTime,
+  toBase64
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.ts","../src/errors.ts","../src/hash.ts","../src/utils.ts","../src/client.ts"],"sourcesContent":["export const SANDBOX_BASE_URL = \"https://checkout-sandbox.payway.com.kh\";\nexport const PRODUCTION_BASE_URL = \"https://checkout.payway.com.kh\";\n\nexport const ENDPOINTS = {\n\tpurchase: \"/api/payment-gateway/v1/payments/purchase\",\n\tcheckTransaction: \"/api/payment-gateway/v1/payments/check-transaction-2\",\n\ttransactionList: \"/api/payment-gateway/v1/payments/transaction-list-2\",\n} as const;\n","export class PayWayError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"PayWayError\";\n\t}\n}\n\nexport class PayWayAPIError extends PayWayError {\n\tpublic readonly statusCode: number;\n\tpublic readonly responseBody: unknown;\n\n\tconstructor(message: string, statusCode: number, responseBody?: unknown) {\n\t\tsuper(message);\n\t\tthis.name = \"PayWayAPIError\";\n\t\tthis.statusCode = statusCode;\n\t\tthis.responseBody = responseBody;\n\t}\n}\n\nexport class PayWayConfigError extends PayWayError {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"PayWayConfigError\";\n\t}\n}\n\nexport class PayWayHashError extends PayWayError {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"PayWayHashError\";\n\t}\n}\n","import { createHmac } from \"node:crypto\";\n\nexport function createHash(values: string[], apiKey: string): string {\n\tconst message = values.join(\"\");\n\tconst hmac = createHmac(\"sha512\", apiKey);\n\thmac.update(message);\n\treturn hmac.digest(\"base64\");\n}\n","export function formatRequestTime(date: Date = new Date()): string {\n\tconst year = date.getUTCFullYear().toString();\n\tconst month = (date.getUTCMonth() + 1).toString().padStart(2, \"0\");\n\tconst day = date.getUTCDate().toString().padStart(2, \"0\");\n\tconst hours = date.getUTCHours().toString().padStart(2, \"0\");\n\tconst minutes = date.getUTCMinutes().toString().padStart(2, \"0\");\n\tconst seconds = date.getUTCSeconds().toString().padStart(2, \"0\");\n\treturn `${year}${month}${day}${hours}${minutes}${seconds}`;\n}\n\nexport function buildFormData(\n\tparams: Record<string, string | undefined>,\n): FormData {\n\tconst formData = new FormData();\n\tfor (const [key, value] of Object.entries(params)) {\n\t\tif (value !== undefined && value !== null && value !== \"\") {\n\t\t\tformData.append(key, value);\n\t\t}\n\t}\n\treturn formData;\n}\n\nexport function formatAmount(amount: number, currency = \"USD\"): string {\n\tif (currency.toUpperCase() === \"KHR\") {\n\t\treturn Math.round(amount).toString();\n\t}\n\treturn amount.toFixed(2);\n}\n\nexport function toBase64(value: string): string {\n\treturn Buffer.from(value).toString(\"base64\");\n}\n","import {\n\tENDPOINTS,\n\tPRODUCTION_BASE_URL,\n\tSANDBOX_BASE_URL,\n} from \"./constants.ts\";\nimport { PayWayAPIError, PayWayConfigError } from \"./errors.ts\";\nimport { createHash } from \"./hash.ts\";\nimport type {\n\tCheckoutParams,\n\tCheckTransactionData,\n\tCreateTransactionOptions,\n\tListTransactionsOptions,\n\tListTransactionsResponse,\n\tPayWayConfig,\n\tPayWayResponse,\n} from \"./types.ts\";\nimport { formatAmount, formatRequestTime, toBase64 } from \"./utils.ts\";\n\nexport class PayWay {\n\tprivate readonly merchantId: string;\n\tprivate readonly apiKey: string;\n\tprivate readonly baseUrl: string;\n\n\tconstructor(config: PayWayConfig) {\n\t\tif (!config.merchantId) {\n\t\t\tthrow new PayWayConfigError(\"merchantId is required\");\n\t\t}\n\t\tif (!config.apiKey) {\n\t\t\tthrow new PayWayConfigError(\"apiKey is required\");\n\t\t}\n\n\t\tthis.merchantId = config.merchantId;\n\t\tthis.apiKey = config.apiKey;\n\t\tthis.baseUrl = config.production ? PRODUCTION_BASE_URL : SANDBOX_BASE_URL;\n\t}\n\n\t/**\n\t * Generate checkout parameters for a transaction.\n\t * Returns form params to be submitted from the browser via ABA's checkout JS SDK.\n\t */\n\tcreateTransaction(options: CreateTransactionOptions): CheckoutParams {\n\t\tconst reqTime = formatRequestTime();\n\t\tconst currency = options.currency ?? \"USD\";\n\t\tconst amount = formatAmount(options.amount, currency);\n\t\tconst type = options.type ?? \"purchase\";\n\n\t\t// Items: if array, JSON-stringify and base64-encode; if string, base64-encode as-is\n\t\tlet items: string;\n\t\tif (Array.isArray(options.items)) {\n\t\t\titems = toBase64(JSON.stringify(options.items));\n\t\t} else if (options.items) {\n\t\t\titems = toBase64(options.items);\n\t\t} else {\n\t\t\titems = \"\";\n\t\t}\n\n\t\t// Return URL and return deeplink must be base64-encoded per ABA docs\n\t\tconst returnUrl = options.returnUrl ? toBase64(options.returnUrl) : \"\";\n\t\tconst returnDeeplink = options.returnDeeplink\n\t\t\t? toBase64(options.returnDeeplink)\n\t\t\t: \"\";\n\n\t\t// Payout must be base64-encoded JSON string per ABA docs\n\t\tconst payout = options.payout ? toBase64(options.payout) : \"\";\n\n\t\tconst shipping =\n\t\t\toptions.shipping !== undefined\n\t\t\t\t? formatAmount(options.shipping, currency)\n\t\t\t\t: \"\";\n\n\t\t// Hash field order must match ABA's expected order exactly\n\t\tconst hashValues = [\n\t\t\treqTime,\n\t\t\tthis.merchantId,\n\t\t\toptions.transactionId,\n\t\t\tamount,\n\t\t\titems,\n\t\t\tshipping,\n\t\t\toptions.firstName ?? \"\",\n\t\t\toptions.lastName ?? \"\",\n\t\t\toptions.email ?? \"\",\n\t\t\toptions.phone ?? \"\",\n\t\t\ttype,\n\t\t\toptions.paymentOption ?? \"\",\n\t\t\treturnUrl,\n\t\t\toptions.cancelUrl ?? \"\",\n\t\t\toptions.continueSuccessUrl ?? \"\",\n\t\t\treturnDeeplink,\n\t\t\tcurrency,\n\t\t\toptions.customFields ?? \"\",\n\t\t\toptions.returnParams ?? \"\",\n\t\t\toptions.viewType ?? \"\",\n\t\t\toptions.paymentGate?.toString() ?? \"\",\n\t\t\tpayout,\n\t\t\toptions.lifetime?.toString() ?? \"\",\n\t\t\toptions.additionalParams ?? \"\",\n\t\t\toptions.googlePayToken ?? \"\",\n\t\t\toptions.skipSuccessPage?.toString() ?? \"\",\n\t\t];\n\n\t\tconst hash = createHash(hashValues, this.apiKey);\n\n\t\treturn {\n\t\t\taction: `${this.baseUrl}${ENDPOINTS.purchase}`,\n\t\t\thash,\n\t\t\ttran_id: options.transactionId,\n\t\t\tamount,\n\t\t\titems,\n\t\t\tcurrency,\n\t\t\tfirstname: options.firstName ?? \"\",\n\t\t\tlastname: options.lastName ?? \"\",\n\t\t\temail: options.email ?? \"\",\n\t\t\tphone: options.phone ?? \"\",\n\t\t\ttype,\n\t\t\tpayment_option: options.paymentOption ?? \"\",\n\t\t\treturn_url: returnUrl,\n\t\t\tcancel_url: options.cancelUrl ?? \"\",\n\t\t\tcontinue_success_url: options.continueSuccessUrl ?? \"\",\n\t\t\treturn_deeplink: returnDeeplink,\n\t\t\treturn_params: options.returnParams ?? \"\",\n\t\t\tshipping,\n\t\t\tmerchant_id: this.merchantId,\n\t\t\treq_time: reqTime,\n\t\t\tcustom_fields: options.customFields ?? \"\",\n\t\t\tpayout,\n\t\t\tlifetime: options.lifetime?.toString() ?? \"\",\n\t\t\tadditional_params: options.additionalParams ?? \"\",\n\t\t\tgoogle_pay_token: options.googlePayToken ?? \"\",\n\t\t\tskip_success_page: options.skipSuccessPage?.toString() ?? \"\",\n\t\t\tview_type: options.viewType ?? \"\",\n\t\t\tpayment_gate: options.paymentGate?.toString() ?? \"\",\n\t\t};\n\t}\n\n\tasync checkTransaction(\n\t\ttransactionId: string,\n\t): Promise<PayWayResponse<CheckTransactionData>> {\n\t\tconst reqTime = formatRequestTime();\n\n\t\tconst hashValues = [reqTime, this.merchantId, transactionId];\n\t\tconst hash = createHash(hashValues, this.apiKey);\n\n\t\tconst params: Record<string, string | undefined> = {\n\t\t\thash,\n\t\t\ttran_id: transactionId,\n\t\t\treq_time: reqTime,\n\t\t\tmerchant_id: this.merchantId,\n\t\t};\n\n\t\treturn this.request<PayWayResponse<CheckTransactionData>>(\n\t\t\tENDPOINTS.checkTransaction,\n\t\t\tparams,\n\t\t);\n\t}\n\n\tasync listTransactions(\n\t\toptions: ListTransactionsOptions = {},\n\t): Promise<ListTransactionsResponse> {\n\t\tconst reqTime = formatRequestTime();\n\n\t\tconst hashValues = [\n\t\t\treqTime,\n\t\t\tthis.merchantId,\n\t\t\toptions.fromDate ?? \"\",\n\t\t\toptions.toDate ?? \"\",\n\t\t\toptions.fromAmount?.toString() ?? \"\",\n\t\t\toptions.toAmount?.toString() ?? \"\",\n\t\t\toptions.status ?? \"\",\n\t\t\toptions.page?.toString() ?? \"\",\n\t\t\toptions.pagination?.toString() ?? \"\",\n\t\t];\n\t\tconst hash = createHash(hashValues, this.apiKey);\n\n\t\tconst params: Record<string, string | undefined> = {\n\t\t\thash,\n\t\t\tfrom_date: options.fromDate,\n\t\t\tto_date: options.toDate,\n\t\t\tfrom_amount: options.fromAmount?.toString(),\n\t\t\tto_amount: options.toAmount?.toString(),\n\t\t\tstatus: options.status,\n\t\t\tpage: options.page?.toString(),\n\t\t\tpagination: options.pagination?.toString(),\n\t\t\treq_time: reqTime,\n\t\t\tmerchant_id: this.merchantId,\n\t\t};\n\n\t\treturn this.request<ListTransactionsResponse>(\n\t\t\tENDPOINTS.transactionList,\n\t\t\tparams,\n\t\t);\n\t}\n\n\tprivate async request<T>(\n\t\tendpoint: string,\n\t\tparams: Record<string, string | undefined>,\n\t): Promise<T> {\n\t\tconst url = `${this.baseUrl}${endpoint}`;\n\t\tconst formData = new FormData();\n\t\tfor (const [key, value] of Object.entries(params)) {\n\t\t\tif (value !== undefined && value !== null && value !== \"\") {\n\t\t\t\tformData.append(key, value);\n\t\t\t}\n\t\t}\n\n\t\tconst response = await fetch(url, {\n\t\t\tmethod: \"POST\",\n\t\t\tbody: formData,\n\t\t});\n\n\t\tif (!response.ok) {\n\t\t\tconst text = await response.text();\n\t\t\tlet body: unknown = text;\n\t\t\ttry {\n\t\t\t\tbody = JSON.parse(text);\n\t\t\t} catch {\n\t\t\t\t// keep as text\n\t\t\t}\n\t\t\tthrow new PayWayAPIError(\n\t\t\t\t`PayWay API error: ${response.status} ${response.statusText}`,\n\t\t\t\tresponse.status,\n\t\t\t\tbody,\n\t\t\t);\n\t\t}\n\n\t\treturn (await response.json()) as T;\n\t}\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,59 @@
+{
+	"name": "aba-payway",
+	"version": "0.1.0",
+	"description": "Type-safe TypeScript SDK for ABA PayWay — Cambodia's #1 payment gateway",
+	"type": "module",
+	"main": "./dist/index.cjs",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"import": {
+				"types": "./dist/index.d.ts",
+				"default": "./dist/index.js"
+			},
+			"require": {
+				"types": "./dist/index.d.cts",
+				"default": "./dist/index.cjs"
+			}
+		}
+	},
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"build": "tsup",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.test.json",
+		"lint": "biome check .",
+		"lint:fix": "biome check --write .",
+		"prepublishOnly": "bun run build"
+	},
+	"keywords": [
+		"aba",
+		"payway",
+		"cambodia",
+		"payment",
+		"payment-gateway",
+		"typescript",
+		"sdk"
+	],
+	"license": "MIT",
+	"author": "Joselay",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/Joselay/aba-payway.git"
+	},
+	"homepage": "https://github.com/Joselay/aba-payway#readme",
+	"bugs": {
+		"url": "https://github.com/Joselay/aba-payway/issues"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.4.4",
+		"@types/bun": "latest",
+		"tsup": "^8.5.1",
+		"typescript": "^5.9.3",
+		"vitest": "^4.0.18"
+	}
+}