Agent skill

newebpay-refund

Implements NewebPay refund functionality for credit cards and e-wallets. Use when building refund processing, transaction cancellation, or return payment features for 藍新金流.

View SKILL.md on GitHub Repository
Stars 236
Forks 18

Install this agent skill to your Project

npx add-skill https://github.com/paid-tw/skills/tree/main/plugins/newebpay/skills/newebpay-refund

SKILL.md

藍新金流退款任務

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

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)

常見錯誤

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

注意事項

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

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

paid-tw/skills

kryptogo-pay-webhook

Implements KryptoGO Payment webhook/callback handling for receiving payment status notifications. Use when building webhook endpoints, handling payment callbacks, or implementing 支付狀態通知 for KryptoGO Payment.

236 18
Explore
paid-tw/skills

kryptogo-pay

Provides KryptoGO Payment integration overview and guides users to the appropriate skill. Use when starting KryptoGO crypto payment integration, setting up environment, or needing general guidance about KryptoGO 穩定幣支付.

236 18
Explore
paid-tw/skills

kryptogo-pay-query

Implements KryptoGO Payment query functionality for checking payment intent status and listing payment intents. Use when building order status checking, transaction verification, or payment confirmation features for KryptoGO 穩定幣支付.

236 18
Explore
paid-tw/skills

kryptogo-pay-transfer

Implements KryptoGO Payment token transfer/withdrawal functionality using the Asset Pro Transfer API. Use when building withdrawal features, sending tokens to users, or implementing 穩定幣提領轉帳 for KryptoGO Payment.

236 18
Explore
paid-tw/skills

kryptogo-pay-checkout

Implements KryptoGO Payment checkout integration including Payment Intent creation, React SDK usePayment hook, and Direct API integration. Use when integrating crypto payment, creating checkout flows, or building KryptoGO 穩定幣收款頁面.

236 18
Explore
paid-tw/skills

payuni-webhook

Implements PAYUNi webhook handling including signature verification, replay attack prevention, and payment status updates. Use when building payment notification endpoints for 統一金流.

236 18
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results