# Newebpay Refund

> >

- **Type:** Skill
- **Install:** `agentstack add skill-paid-tw-skills-newebpay-refund`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [paid-tw](https://agentstack.voostack.com/s/paid-tw)
- **Installs:** 0
- **Category:** [Finance & Payments](https://agentstack.voostack.com/c/finance-and-payments)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [paid-tw](https://github.com/paid-tw)
- **Source:** https://github.com/paid-tw/skills/tree/main/plugins/newebpay/skills/newebpay-refund

## Install

```sh
agentstack add skill-paid-tw-skills-newebpay-refund
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 藍新金流退款任務

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

## Step 1: 確認退款類型

用戶輸入: `$ARGUMENTS`

詢問用戶：

1. **退款類型**：需要處理什麼類型的退款？
   - 信用卡退款 (CreditCard/Close API)
   - 電子錢包退款 - LINE Pay, 台灣 Pay 等 (EWallet/Refund API)
   - 兩者都需要

2. **退款情境**：
   - 全額退款
   - 部分退款
   - 自動退款（與訂單系統整合）

## 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)](references/code-examples.md)

---

## 常見錯誤

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

## 注意事項

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

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [paid-tw](https://github.com/paid-tw)
- **Source:** [paid-tw/skills](https://github.com/paid-tw/skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-paid-tw-skills-newebpay-refund
- Seller: https://agentstack.voostack.com/s/paid-tw
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.