Taiwan Payment Development Skill

此技能涵蓋台灣金流 API 整合開發，包含綠界科技 (ECPay)、藍新金流 (NewebPay)、統一金流 (PAYUNi) 三家服務商。

快速導覽

智能工具

•scripts/search.py - BM25 搜索引擎（查詢 API、錯誤碼、欄位映射、付款方式）
•scripts/recommend.py - 金流服務商推薦系統
•scripts/test_payment.py - 付款測試工具
•data/ - CSV 數據檔（providers, operations, error-codes, field-mappings, payment-methods, troubleshooting, reasoning）

何時使用此技能

•開發線上金流付款功能
•整合台灣金流服務商 API
•實作信用卡、ATM、超商、電子錢包等付款方式
•處理訂單查詢、退款、定期定額扣款
•處理加密簽章（SHA256、AES-256-CBC、AES-256-GCM）
•解決金流 API 整合問題

智能搜索與推薦

搜索引擎 (search.py)

使用 BM25 算法在資料庫中搜索相關資訊：

bash

# 搜索服務商
python scripts/search.py "ecpay" --domain provider

# 搜索錯誤碼
python scripts/search.py "10100058" --domain error

# 搜索欄位映射
python scripts/search.py "MerchantTradeNo" --domain field

# 搜索付款方式
python scripts/search.py "信用卡" --domain payment_method

# 搜索疑難排解
python scripts/search.py "CheckMacValue 錯誤" --domain troubleshoot

# 全域搜索
python scripts/search.py "金額計算" --domain all

# JSON 輸出
python scripts/search.py "ATM" --format json

搜索域：

域	說明	CSV 檔案
`provider`	服務商比較	providers.csv
`operation`	API 操作端點	operations.csv
`error`	錯誤碼查詢	error-codes.csv
`field`	欄位映射	field-mappings.csv
`payment_method`	付款方式	payment-methods.csv
`troubleshoot`	疑難排解	troubleshooting.csv
`reasoning`	推薦決策規則	reasoning.csv

域自動偵測： 搜索引擎會自動偵測查詢內容並選擇最適合的域：

•錯誤碼格式（如 "10100058"）→ error
•服務商名稱（如 "ECPay"）→ provider
•付款方式（如 "信用卡"、"ATM"）→ payment_method
•API 欄位（如 "MerchantID"）→ field

付款測試工具 (test_payment.py)

快速測試金流服務商連線：

bash

# 測試 ECPay 連線
python scripts/test_payment.py ecpay

# 測試 NewebPay 連線
python scripts/test_payment.py newebpay

# 測試 PAYUNi 連線
python scripts/test_payment.py payuni

# 測試所有服務商
python scripts/test_payment.py all

付款方式說明

信用卡支付

•一次付清: 最常用的付款方式，2-3 天到帳
•信用卡分期: 3/6/12/18/24/30 期，需最低金額 1000 元
•信用卡定期: 週期扣款，適用訂閱制服務
•信用卡紅利: 紅利折抵功能
•銀聯卡: 需另外申請，支援中國銀聯
•美國運通卡: 需另外申請

電子錢包

•Apple Pay: 需申請，適合 iOS 用戶
•Google Pay: 需申請，適合 Android 用戶
•Samsung Pay: 需申請，三星手機專用
•LINE Pay: 需申請，LINE 生態系整合
•玉山 Wallet: 玉山銀行電子錢包
•台灣 Pay: 官方行動支付，最高 49,999 元

ATM 轉帳

•網路 ATM: 即時轉帳，最高 49,999 元，1 天到帳
•ATM 虛擬帳號: 產生專屬繳費帳號，1-3 天到帳，最高 49,999 元

超商支付

•超商代碼: 至四大超商繳費，30-20,000 元，1-3 天到帳
•超商條碼: 產生繳費條碼，20-40,000 元，1-3 天到帳

其他支付方式

•TWQR: 台灣 Pay QR Code 掃碼支付
•BNPL 無卡分期: 先買後付，50-300,000 元
•AFTEE: PAYUNi 專屬先享後付
•iCash: PAYUNi 專屬愛金卡支付
•簡單付支付寶/微信: 跨境支付（中國市場）

三家服務商特性比較

特性	綠界 ECPay	藍新 NewebPay	統一 PAYUNi
加密方式	URL Encode + SHA256	AES-256-CBC + SHA256 雙層	AES-256-GCM + SHA256
API 風格	Form POST	Form POST + AES	RESTful JSON
內容格式	application/x-www-form-urlencoded	application/x-www-form-urlencoded	application/json
測試/正式 URL	不同 URL	不同 URL	不同 URL
市佔率	最高	高	中等
支付方式	11 種（含 BNPL、TWQR）	13 種（含 LINE Pay、Apple Pay）	8 種（含 AFTEE、iCash）
特色功能	完整文檔、SDK、同時支援發票物流	MPG 整合、信用卡記憶、多元電子錢包	RESTful 設計、統一集團背景
適用場景	高交易量電商、傳統產業、PHP 開發	多元支付、會員制、行動 App	新創公司、API 優先、Node.js 開發

ECPay 特性

•優勢: 市佔率最高、穩定性最佳、文檔完整、社群資源豐富、測試帳號可用
•加密: URL Encode + SHA256（參數排序 + HashKey + HashIV）
•傳輸: Form POST，application/x-www-form-urlencoded
•特色: 同時支援金流、發票、物流三合一服務

NewebPay 特性

•優勢: 支援最多支付方式（13 種）、MPG 整合、信用卡記憶功能、完整電子錢包
•加密: AES-256-CBC 加密 TradeInfo，再計算 SHA256 TradeSha
•傳輸: Form POST，雙層加密（AES + SHA256）
•特色: LINE Pay、Apple Pay、Google Pay 原生支援

PAYUNi 特性

•優勢: RESTful JSON API、統一集團背景、AES-GCM 現代加密
•加密: AES-256-GCM 加密 + SHA256 簽章
•傳輸: RESTful JSON，application/json
•特色: AFTEE 先享後付、iCash 愛金卡（獨家）

開發實作步驟

1. 服務實作架構

創建服務時遵循以下結構：

typescript

// lib/services/payment-provider.ts - 介面定義
export interface PaymentService {
    createOrder(userId: string, data: PaymentOrderData): Promise<PaymentOrderResponse>
    queryOrder(userId: string, merchantTradeNo: string): Promise<PaymentQueryResponse>
    refundOrder(userId: string, tradeNo: string, amount: number): Promise<PaymentRefundResponse>
    createPeriodic(userId: string, data: PeriodicPaymentData): Promise<PeriodicResponse>
}

// lib/services/{provider}-payment-service.ts - 各服務商實作
export class ECPayPaymentService implements PaymentService {
    private generateCheckMacValue(params: Record<string, any>, hashKey: string, hashIV: string): string {
        // SHA256 簽章實作
    }

    async createOrder(userId: string, data: PaymentOrderData) {
        // 1. 取得使用者設定
        // 2. 準備 API 資料
        // 3. 計算 CheckMacValue
        // 4. 生成表單 HTML
        // 5. 回傳標準格式
    }
}

2. 加密實作

綠界 (ECPay) - SHA256 簽章：

typescript

import crypto from 'crypto'

function generateECPayCheckMacValue(params: Record<string, any>, hashKey: string, hashIV: string): string {
    // 1. 移除 CheckMacValue 本身
    const { CheckMacValue, ...cleanParams } = params

    // 2. 依照 key 排序（字母順序）
    const sortedKeys = Object.keys(cleanParams).sort()

    // 3. 組合參數字串: key1=value1&key2=value2
    const paramString = sortedKeys
        .map(key => `${key}=${cleanParams[key]}`)
        .join('&')

    // 4. 前後加上 HashKey 和 HashIV
    const rawString = `HashKey=${hashKey}&${paramString}&HashIV=${hashIV}`

    // 5. URL Encode (lowercase)
    const encoded = encodeURIComponent(rawString).toLowerCase()

    // 6. SHA256 雜湊
    const hash = crypto.createHash('sha256').update(encoded).digest('hex')

    // 7. 轉大寫
    return hash.toUpperCase()
}

藍新 (NewebPay) - AES-256-CBC 雙層加密：

typescript

function encryptNewebPay(data: Record<string, any>, hashKey: string, hashIV: string): {
    TradeInfo: string,
    TradeSha: string
} {
    // 1. 轉換為查詢字串
    const queryString = new URLSearchParams(data).toString()

    // 2. AES-256-CBC 加密
    const cipher = crypto.createCipheriv('aes-256-cbc', hashKey, hashIV)
    cipher.setAutoPadding(true)
    let encrypted = cipher.update(queryString, 'utf8', 'hex')
    encrypted += cipher.final('hex')

    // 3. 計算 SHA256
    const tradeSha = crypto
        .createHash('sha256')
        .update(`HashKey=${hashKey}&${encrypted}&HashIV=${hashIV}`)
        .digest('hex')
        .toUpperCase()

    return {
        TradeInfo: encrypted,
        TradeSha: tradeSha
    }
}

function decryptNewebPay(encryptedData: string, hashKey: string, hashIV: string): Record<string, any> {
    const decipher = crypto.createDecipheriv('aes-256-cbc', hashKey, hashIV)
    decipher.setAutoPadding(true)
    let decrypted = decipher.update(encryptedData, 'hex', 'utf8')
    decrypted += decipher.final('utf8')

    return Object.fromEntries(new URLSearchParams(decrypted))
}

統一 (PAYUNi) - AES-256-GCM 加密：

typescript

function encryptPAYUNi(data: Record<string, any>, hashKey: string, hashIV: string): {
    EncryptInfo: string,
    HashInfo: string
} {
    // 1. JSON 字串化
    const jsonString = JSON.stringify(data)

    // 2. AES-256-GCM 加密
    const cipher = crypto.createCipheriv('aes-256-gcm', hashKey, hashIV)
    let encrypted = cipher.update(jsonString, 'utf8', 'hex')
    encrypted += cipher.final('hex')

    // 3. 取得 Auth Tag (16 bytes)
    const authTag = cipher.getAuthTag().toString('hex')

    // 4. 組合加密資料 (encrypted + tag)
    const encryptInfo = encrypted + authTag

    // 5. SHA256 簽章
    const hashInfo = crypto
        .createHash('sha256')
        .update(`HashKey=${hashKey}&${encryptInfo}&HashIV=${hashIV}`)
        .digest('hex')
        .toUpperCase()

    return {
        EncryptInfo: encryptInfo,
        HashInfo: hashInfo
    }
}

function decryptPAYUNi(encryptedData: string, hashKey: string, hashIV: string): Record<string, any> {
    // 1. 分離加密內容和 Auth Tag (最後 32 個字元 = 16 bytes hex)
    const encryptedContent = encryptedData.slice(0, -32)
    const authTag = Buffer.from(encryptedData.slice(-32), 'hex')

    // 2. AES-256-GCM 解密
    const decipher = crypto.createDecipheriv('aes-256-gcm', hashKey, hashIV)
    decipher.setAuthTag(authTag)
    let decrypted = decipher.update(encryptedContent, 'hex', 'utf8')
    decrypted += decipher.final('utf8')

    return JSON.parse(decrypted)
}

3. 訂單建立流程

關鍵：各服務商都使用 Form POST 導向付款頁

typescript

// 後端產生付款表單
async function createPaymentOrder(provider: string, orderData: OrderData) {
    const service = PaymentServiceFactory.getService(provider)
    const result = await service.createOrder(userId, orderData)

    // 儲存訂單資訊
    await prisma.order.update({
        where: { id: orderId },
        data: {
            merchantTradeNo: result.merchantTradeNo,
            paymentProvider: provider,  // **重要**：儲存使用的服務商
            paymentMethod: orderData.paymentMethod,
            status: 'PENDING'
        }
    })

    // 回傳表單資料
    return {
        type: 'form',
        action: result.formAction,
        method: result.formMethod,
        params: result.formParams
    }
}

// 前端提交表單
function submitPaymentForm(formData: PaymentFormData) {
    const form = document.createElement('form')
    form.method = formData.method
    form.action = formData.action
    form.target = '_self'  // 整頁跳轉

    // 添加隱藏欄位
    Object.entries(formData.params).forEach(([key, value]) => {
        const input = document.createElement('input')
        input.type = 'hidden'
        input.name = key
        input.value = value
        form.appendChild(input)
    })

    document.body.appendChild(form)
    form.submit()
}

4. 付款通知處理

ReturnURL 處理（付款完成後）：

typescript

// app/api/payment/callback/route.ts
export async function POST(request: Request) {
    const formData = await request.formData()
    const params = Object.fromEntries(formData)

    // 1. 偵測服務商（根據欄位判斷）
    const provider = detectProvider(params)
    const service = PaymentServiceFactory.getService(provider)

    // 2. 驗證簽章
    const isValid = service.verifyCallback(params)
    if (!isValid) {
        return new Response('0|CheckMacValue Error', { status: 400 })
    }

    // 3. 更新訂單狀態
    const merchantTradeNo = params.MerchantTradeNo || params.MerchantOrderNo
    await prisma.order.update({
        where: { merchantTradeNo },
        data: {
            status: params.RtnCode === '1' ? 'PAID' : 'FAILED',
            paidAt: new Date(),
            tradeNo: params.TradeNo,  // **重要**：儲存金流商訂單號（退款時需要）
            paymentDetails: params
        }
    })

    // 4. 回應固定格式
    return new Response('1|OK')  // ECPay/NewebPay 要求
}

5. 查詢訂單

typescript

async function queryPaymentOrder(merchantTradeNo: string) {
    // 1. 查詢訂單取得服務商
    const order = await prisma.order.findUnique({
        where: { merchantTradeNo }
    })

    // 2. 使用訂單記錄的服務商查詢
    const service = PaymentServiceFactory.getService(order.paymentProvider)
    const result = await service.queryOrder(order.userId, merchantTradeNo)

    return result
}

6. 退款處理

typescript

async function refundPaymentOrder(merchantTradeNo: string, refundAmount: number) {
    const order = await prisma.order.findUnique({
        where: { merchantTradeNo }
    })

    // **重要**：使用開立時的服務商和 TradeNo
    const service = PaymentServiceFactory.getService(order.paymentProvider)
    const result = await service.refundOrder(
        order.userId,
        order.tradeNo,  // 金流商訂單號
        refundAmount
    )

    // 更新訂單狀態
    await prisma.order.update({
        where: { merchantTradeNo },
        data: {
            status: 'REFUNDED',
            refundAmount,
            refundedAt: new Date()
        }
    })

    return result
}

常見問題排除

問題 1: CheckMacValue 驗證失敗

錯誤訊息： ECPay 回傳 10100058，NewebPay 回傳 CheckValue Error

常見原因：

•參數排序錯誤（必須按照字母順序）
•URL Encode 不正確（ECPay 需要 lowercase）
•編碼問題（UTF-8）
•忘記移除 CheckMacValue 本身

解決方案：

typescript

// * 正確
function generateCheckMacValue(params: Record<string, any>, hashKey: string, hashIV: string) {
    // 1. 移除 CheckMacValue
    const { CheckMacValue, ...cleanParams } = params

    // 2. 排序
    const sortedKeys = Object.keys(cleanParams).sort()

    // 3. 組合字串
    const paramString = sortedKeys.map(k => `${k}=${cleanParams[k]}`).join('&')

    // 4. 加上 HashKey/HashIV
    const rawString = `HashKey=${hashKey}&${paramString}&HashIV=${hashIV}`

    // 5. URL Encode (lowercase for ECPay)
    const encoded = encodeURIComponent(rawString).toLowerCase()

    // 6. SHA256
    return crypto.createHash('sha256').update(encoded).digest('hex').toUpperCase()
}

// * 錯誤：未排序
const paramString = Object.entries(params).map(([k, v]) => `${k}=${v}`).join('&')

// * 錯誤：URL Encode 使用 uppercase
const encoded = encodeURIComponent(rawString)  // 應該用 toLowerCase()

問題 2: 訂單編號重複

錯誤訊息： ECPay 10100003，NewebPay/PAYUNi 訂單已存在

原因： 使用相同的 MerchantTradeNo

解決方案：

typescript

// * 建議：加入時間戳保證唯一性
function generateMerchantTradeNo(prefix: string = 'ORD') {
    const timestamp = Date.now()
    const random = Math.random().toString(36).substring(2, 8).toUpperCase()
    return `${prefix}${timestamp}${random}`.substring(0, 20)  // ECPay 限制 20 字元
}

// 範例輸出: ORD1706512345A7B2

問題 3: 金額計算錯誤

錯誤訊息： 回傳金額驗算錯誤

常見原因：

•金額包含小數
•金額為負數或 0
•商品金額總和不等於訂單金額

解決方案：

typescript

// * 確保金額為正整數
function validateAmount(amount: number): number {
    if (amount <= 0) {
        throw new Error('金額必須大於 0')
    }
    return Math.round(amount)  // 移除小數
}

// * 驗證商品金額總和
function validateItemsAmount(items: Item[], totalAmount: number) {
    const itemsSum = items.reduce((sum, item) => sum + (item.price * item.quantity), 0)
    if (Math.round(itemsSum) !== Math.round(totalAmount)) {
        throw new Error(`商品金額總和 ${itemsSum} 不等於訂單金額 ${totalAmount}`)
    }
}

問題 4: 收不到付款通知

原因：

•ReturnURL 不是 HTTPS
•防火牆阻擋
•回應格式錯誤

解決方案：

typescript

// * 確認 ReturnURL 使用 HTTPS
const returnURL = 'https://yourdomain.com/api/payment/callback'  // 必須 HTTPS

// * 正確回應格式
export async function POST(request: Request) {
    // ... 處理邏輯

    // ECPay/NewebPay 需要回應 "1|OK"
    return new Response('1|OK', {
        status: 200,
        headers: { 'Content-Type': 'text/plain' }
    })
}

// * 錯誤：JSON 回應
return Response.json({ success: true })  // 不正確

問題 5: 測試卡無法付款

原因： 使用真實卡號或測試卡格式錯誤

解決方案：

code

# ECPay 測試卡
卡號: 4311-9522-2222-2222
有效期: 任意未來月年
CVV: 任意 3 碼

# NewebPay 測試卡
卡號: 4000-2211-1111-1111
有效期: 任意未來月年
CVV: 任意 3 碼

# PAYUNi 測試卡
請至後台查詢官方測試卡號

問題 6: AES 加密失敗

NewebPay AES-256-CBC 加密錯誤：

typescript

// * 確認 Key/IV 長度
const hashKey = 'your32BytesHashKeyHere123456'  // 必須 32 bytes
const hashIV = 'your16BytesIV123'              // 必須 16 bytes

// * 使用正確的 padding
const cipher = crypto.createCipheriv('aes-256-cbc', hashKey, hashIV)
cipher.setAutoPadding(true)  // PKCS7 padding

PAYUNi AES-256-GCM 加密錯誤：

typescript

// * 記得附加 Auth Tag
const cipher = crypto.createCipheriv('aes-256-gcm', hashKey, hashIV)
let encrypted = cipher.update(jsonString, 'utf8', 'hex')
encrypted += cipher.final('hex')
const authTag = cipher.getAuthTag().toString('hex')  // **重要**
const encryptInfo = encrypted + authTag  // 總長度 = encrypted + 32 chars (16 bytes hex)

問題 7: ATM 虛擬帳號未產生

原因：

•未設定 ChoosePayment=ATM
•ExpireDate 格式錯誤
•ExpireDate 超過範圍（3-60 天）

解決方案：

typescript

// * ECPay ATM 設定
const params = {
    ChoosePayment: 'ATM',
    ExpireDate: 3,  // 3-60 天
    PaymentInfoURL: 'https://yourdomain.com/api/payment/atm-info',  // 接收帳號通知
    // ...
}

// * NewebPay ATM 設定
const params = {
    VACC: 1,  // 啟用 ATM
    ExpireDate: '2024-12-31',  // yyyy-MM-dd 格式
    // ...
}

問題 8: 定期定額建立失敗

原因： 週期參數不完整

解決方案：

typescript

// * ECPay 定期定額
const periodicParams = {
    PeriodAmount: 1000,      // 扣款金額
    PeriodType: 'M',         // D=日, M=月, Y=年
    Frequency: 1,            // 頻率（每 1 個週期）
    ExecTimes: 12,           // 執行次數（12 次）
    PeriodReturnURL: 'https://yourdomain.com/api/payment/periodic-callback',
    // ...
}

// * NewebPay 定期定額
const periodicParams = {
    PeriodAmt: 1000,
    PeriodType: 'M',
    PeriodPoint: '01',       // 每月 1 號扣款
    PeriodTimes: 12,
    // ...
}

問題 9: 跨域問題

錯誤： 前端導向付款頁失敗

原因： 使用 AJAX 或 Fetch，受 CORS 限制

解決方案：

typescript

// * 錯誤：使用 AJAX
fetch(paymentUrl, { method: 'POST', body: formData })  // 會被 CORS 阻擋

// * 正確：使用 Form POST 整頁跳轉
function submitPaymentForm(action: string, params: Record<string, string>) {
    const form = document.createElement('form')
    form.method = 'POST'
    form.action = action
    form.target = '_self'  // 整頁跳轉

    Object.entries(params).forEach(([key, value]) => {
        const input = document.createElement('input')
        input.type = 'hidden'
        input.name = key
        input.value = value
        form.appendChild(input)
    })

    document.body.appendChild(form)
    form.submit()  // 直接提交
}

問題 10: 商店代號錯誤

錯誤訊息： 回傳商店不存在

原因：

•MerchantID 錯誤
•測試/正式環境混用

解決方案：

typescript

// * 使用環境變數區分
const config = {
    merchantID: process.env.NODE_ENV === 'production'
        ? process.env.ECPAY_MERCHANT_ID_PROD
        : process.env.ECPAY_MERCHANT_ID_TEST,
    apiUrl: process.env.NODE_ENV === 'production'
        ? 'https://payment.ecpay.com.tw/Cashier/AioCheckOut/V5'
        : 'https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5'
}

測試帳號

綠界測試環境

code

MerchantID: 3002607
HashKey: pwFHCqoQZGmho4w6
HashIV: EkRm7iFT261dpevs
測試 URL: https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5
測試卡號: 4311-9522-2222-2222
後台: https://vendor-stage.ecpay.com.tw/

藍新測試環境

code

MerchantID: 請至後台申請
HashKey: 請至後台申請（32 bytes）
HashIV: 請至後台申請（16 bytes）
測試 URL: https://ccore.newebpay.com/MPG/mpg_gateway
測試卡號: 4000-2211-1111-1111
後台: https://cwww.newebpay.com/

統一測試環境

code

MerchantID: 請至後台申請
HashKey: 請至後台申請
HashIV: 請至後台申請
測試 URL: https://sandbox-api.payuni.com.tw/api/upp
後台: https://sandbox.payuni.com.tw/

開發檢查清單

使用此清單確保實作完整：

基礎設定

• 實作 PaymentService 介面
• 實作各服務商加密機制（SHA256 / AES-CBC / AES-GCM）
• 設定環境變數（測試/正式）
• 配置 ReturnURL（HTTPS）
• 配置 OrderResultURL（付款完成導向頁）

訂單處理

• 儲存 paymentProvider 欄位（查詢/退款時需要）
• 儲存 merchantTradeNo（唯一訂單編號）
• 儲存 tradeNo（金流商訂單號，退款時需要）
• 金額驗證（正整數、最小金額）
• 商品金額總和驗證

付款方式

• 支援信用卡一次付清
• 支援 ATM 虛擬帳號（可選）
• 支援超商代碼/條碼（可選）
• 支援電子錢包（可選）
• 支援信用卡分期（可選）
• 支援定期定額（可選）

回呼處理

• 驗證 CheckMacValue / TradeSha / HashInfo
• 更新訂單狀態
• 回應 "1|OK" 格式
• 防止重複通知處理（冪等性）

查詢退款

• 實作訂單查詢 API
• 實作退款 API
• 處理部分退款邏輯
• 檢查退款期限

錯誤處理

• 實作錯誤處理與 logger
• 記錄完整請求/回應（除敏感資訊）
• 處理加密錯誤
• 處理網路逾時

測試驗證

新增服務商步驟

•在 lib/services/ 建立 {provider}-payment-service.ts
•實作 PaymentService 介面的所有方法
•在 PaymentServiceFactory 註冊新服務商
•在 prisma/schema.prisma 的 PaymentProvider enum 新增選項
•執行 prisma migrate 或 prisma db push
•更新前端設定頁面
•撰寫單元測試
•更新文檔

參考資料

詳細 API 規格請查看 references/ 目錄：

官方文檔：

•ECPay: https://developers.ecpay.com.tw/
•NewebPay: https://www.newebpay.com/website/Page/content/download_api
•PAYUNi: https://www.payuni.com.tw/docs/

最後更新：2026/01/29

Taiwan Payment Development Skill

快速導覽

相關文件

智能工具

何時使用此技能

智能搜索與推薦

搜索引擎 (search.py)

推薦系統 (recommend.py)

付款測試工具 (test_payment.py)

付款方式說明

信用卡支付

電子錢包

ATM 轉帳

超商支付

其他支付方式

三家服務商特性比較

ECPay 特性

NewebPay 特性

PAYUNi 特性

開發實作步驟

1. 服務實作架構

2. 加密實作

3. 訂單建立流程

4. 付款通知處理

5. 查詢訂單

6. 退款處理

常見問題排除

問題 1: CheckMacValue 驗證失敗

問題 2: 訂單編號重複

問題 3: 金額計算錯誤

問題 4: 收不到付款通知

問題 5: 測試卡無法付款

問題 6: AES 加密失敗

問題 7: ATM 虛擬帳號未產生

問題 8: 定期定額建立失敗

問題 9: 跨域問題

問題 10: 商店代號錯誤

測試帳號

綠界測試環境

藍新測試環境

統一測試環境

開發檢查清單

基礎設定

訂單處理

付款方式

回呼處理

查詢退款

錯誤處理

測試驗證

新增服務商步驟

參考資料