PAYUNi SDK for DiamondHost

這是一個專為 PAYUNi 金流 API (Ver 2.0 / 1.x) 打造的整合工具包，採用 AES-256-GCM 加密與 SHA256 驗證。

📁 目錄結構

• src/: 核心 SDK 代碼 (PayUniSDK.ts)。
• docs/: 深入淺出的運作原理與 API 文件。
• examples/: 依照 付款方式 與 功能 分類之範例代碼。
  • 01-credit-card/: 信用卡跳轉、幕後授權、請款、退款、取消授權。
  • 02-atm-virtual-account/: ATM 虛擬帳號建立。
  • 03-cvs-barcode/: 超商代碼與條碼支付。
  • 04-line-pay/: LINE Pay 整合範例。
  • 05-trade-management/: 交易查詢與 Webhook 通知處理。

🚀 快速開始

1. 初始化 SDK

import { PayUniSDK } from './src/PayUniSDK';

const sdk = new PayUniSDK(
    'YOUR_MER_ID',
    'YOUR_HASH_KEY',
    'YOUR_HASH_IV',
    true // Sandbox 模式
);

2. 獲取範例

所有範例均已分類存放於 examples/ 資料夾中。例如：

• 欲查看信用卡幕後授權，請至 examples/01-credit-card/s2s-authorization.ts。
• 欲查看如何處理 Webhook 通知，請至 examples/05-trade-management/query-and-webhook.ts。

📖 開發者指南

請參閱 docs/ 資料夾中的文件以了解詳細的參數說明：

• 運作原理 (幕後 vs 非幕後)
• 交易建立 (API Create)
• 交易查詢 (API Query)
• 請款與退款 (Capture/Refund)
• 取消授權 (Void)