Implements NewebPay refund functionality for credit cards and e-wallets. Use when building refund processing, transaction cancellation, or return payment features for 藍新金流.
你的任務是在用戶的專案中實作藍新金流退款功能。
用戶輸入: $ARGUMENTS
詢問用戶:
退款類型:需要處理什麼類型的退款?
退款情境:
確認專案已設定 NewebPay 環境變數:
NEWEBPAY_MERCHANT_IDNEWEBPAY_HASH_KEYNEWEBPAY_HASH_IV根據退款類型建立對應的功能。
信用卡退款核心功能:
refundCreditCard(orderNo, amount) - 信用卡退款電子錢包退款核心功能:
refundEWallet(tradeNo, orderNo, amount) - 電子錢包退款建議整合方式:
POST /api/orders/:orderNo/refund| 環境 | URL |
|---|---|
| 測試 | https://ccore.newebpay.com/API/CreditCard/Close |
| 正式 | https://core.newebpay.com/API/CreditCard/Close |
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
| RespondType | String | ✓ | JSON |
| Version | String | ✓ | 1.1 |
| Amt | Number | ✓ | 退款金額 |
| MerchantOrderNo | String | ✓ | 原訂單編號 |
| TimeStamp | Number | ✓ | Unix timestamp |
| IndexType | Number | ✓ | 1 (使用訂單編號) |
| CloseType | Number | ✓ | 2 (退款) |
| 環境 | URL |
|---|---|
| 測試 | https://ccore.newebpay.com/API/EWallet/Refund |
| 正式 | https://core.newebpay.com/API/EWallet/Refund |
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
| RespondType | String | ✓ | JSON |
| Version | String | ✓ | 1.0 |
| TimeStamp | Number | ✓ | Unix timestamp |
| TradeNo | String | ✓ | 藍新交易序號 |
| MerchantOrderNo | String | ✓ | 原訂單編號 |
| Amt | Number | ✓ | 退款金額 |
| 代碼 | 說明 | 解決方式 |
|---|---|---|
| CRE10001 | 無此交易紀錄 | 確認訂單編號/交易序號正確 |
| CRE10002 | 已退款或取消 | 交易已被處理過 |
| CRE10003 | 退款金額錯誤 | 退款金額不可大於原交易金額 |
| CRE10004 | 超過可退款期限 | 信用卡一般為 180 天內 |