Skills newebpay-refund

install

source · Clone the upstream repo

git clone https://github.com/Oelshafei1/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/Oelshafei1/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/plugins/newebpay/skills/newebpay-refund" ~/.claude/skills/oelshafei1-skills-newebpay-refund && rm -rf "$T"

manifest: plugins/newebpay/skills/newebpay-refund/SKILL.md

source content

藍新金流退款任務

你的任務是在用戶的專案中實作藍新金流退款功能。

Step 1: 確認退款類型

用戶輸入:

$ARGUMENTS

詢問用戶：

退款類型：需要處理什麼類型的退款？
- 信用卡退款 (CreditCard/Close API)
- 電子錢包退款 - LINE Pay, 台灣 Pay 等 (EWallet/Refund API)
- 兩者都需要
退款情境：
- 全額退款
- 部分退款
- 自動退款（與訂單系統整合）

Step 2: 確認環境

確認專案已設定 NewebPay 環境變數：

```
NEWEBPAY_MERCHANT_ID
```
```
NEWEBPAY_HASH_KEY
```
```
NEWEBPAY_HASH_IV
```

Step 3: 建立退款模組

根據退款類型建立對應的功能。

信用卡退款核心功能:

```
refundCreditCard(orderNo, amount)
```
- 信用卡退款

電子錢包退款核心功能:

```
refundEWallet(tradeNo, orderNo, amount)
```
- 電子錢包退款

Step 4: 整合到應用

建議整合方式：

管理後台: 訂單詳情頁加入退款按鈕
API 端點:
```
POST /api/orders/:orderNo/refund
```
退款記錄: 建立退款記錄表追蹤

信用卡退款

API 端點

環境	URL
測試	`https://ccore.newebpay.com/API/CreditCard/Close`
正式	`https://core.newebpay.com/API/CreditCard/Close`

PostData_ 內容

參數	類型	必填	說明
RespondType	String	✓	`JSON`
Version	String	✓	`1.1`
Amt	Number	✓	退款金額
MerchantOrderNo	String	✓	原訂單編號
TimeStamp	Number	✓	Unix timestamp
IndexType	Number	✓	`1` (使用訂單編號)
CloseType	Number	✓	`2` (退款)

電子錢包退款

API 端點

環境	URL
測試	`https://ccore.newebpay.com/API/EWallet/Refund`
正式	`https://core.newebpay.com/API/EWallet/Refund`

PostData_ 內容

參數	類型	必填	說明
RespondType	String	✓	`JSON`
Version	String	✓	`1.0`
TimeStamp	Number	✓	Unix timestamp
TradeNo	String	✓	藍新交易序號
MerchantOrderNo	String	✓	原訂單編號
Amt	Number	✓	退款金額

詳細參考文件

程式碼範例 (PHP/Node.js)

常見錯誤

代碼	說明	解決方式
CRE10001	無此交易紀錄	確認訂單編號/交易序號正確
CRE10002	已退款或取消	交易已被處理過
CRE10003	退款金額錯誤	退款金額不可大於原交易金額
CRE10004	超過可退款期限	信用卡一般為 180 天內

注意事項

退款期限: 信用卡一般為交易後 180 天內
部分退款: 可退款金額 ≤ 原交易金額
退款次數: 同一筆交易可多次部分退款
電子錢包: 需使用藍新交易序號 (TradeNo)