Skip to content

Integrate I Cash QRCode Refund

Description

I Cash Pay 條碼退款。
I Cash Pay 金流參數：平台編號、特店業者編號、商店編號
情境：

  • 依廠商金流參數設定進行付款：金流參數為必填、門市代碼不需要填
  • 依全通路金流參數設定進行付款：門市代碼為必填、金流參數不需要填

Resource

POST /v1/payment/integrate/refund

Authorization

採用 OAuth 2.0 Bearer Token，詳細使用流程請參考 Auth Login。

Request Body Parameters

Name Type Description
type string 付款方式，請輸入 I_CASH_QRCODE_PAY
request Request 請求參數
store_id string 門市代碼
(optional)
is_test boolean 是否為測試環境
  • 在全通路正式環境預設為false
  • 在全通路測試環境預設為true
(optional)

Request Body Parameters - Request

Name Type Description
PlatformID string 平台編號
(optional)
MerchantID string 特店業者編號
(optional)
OMerchantTradeNo string 原訂單編號
TransactionID string 原愛金卡交易序號
StoreID string 商店編號
(optional)
StoreName string 商店名稱
MerchantTradeNo string 退貨訂單編號
RefundTotalAmount integer 請求退貨金額
RefundItemAmt integer 一般交易退貨金額
RefundUtilityAmt integer 代收交易退貨金額
RefundCommAmt integer 代售交易退貨金額
MerchantTradeDate string 交易退貨日期
yyyy/MM/dd HH:mm:ss

Request

{
  "type": "I_CASH_QRCODE_PAY",
  "request": {
    "PlatformID": "10523647",
    "MerchantID": "10523650",
    "OMerchantTradeNo": "202305160934510005",
    "TransactionID": "20230516101049195830",
    "StoreID": "002",
    "StoreName": "002",
    "MerchantTradeNo": "202305160934510006",
    "MerchantTradeDate": "2023/05/16 10:17:00",
    "RefundTotalAmount": 100,
    "RefundItemAmt": 100,
    "RefundUtilityAmt": 0,
    "RefundCommAmt": 0
  },
  "store_id": "0",
  "is_test": false
}

Response Body Parameters

Name Type Description
RtnCode integer 回傳代碼，0001為成功
RtnMsg string 回傳訊息或失敗訊息
EncData EncData 相關資訊

Response Body Parameters - EncData

Name Type Description
PlatformID string 平台編號
MerchantID string 特店業者編號
MerchantTradeNo string 退貨訂單編號
PaymentDate string 退款時間
RefundTotalAmount string 請求退款金額
RefundICPAmount string 實際退款金額
RefundBonusAmt string 退還折抵金額
RemainingTotalAmount string 剩餘可退金額
RemaininggBonusAmt string 剩餘可退折抵金額
OMerchantTradeNo string 原訂單編號
OTotalAmount string 原交易訂單總金額
OICPAmount string 原交易實際付款金額
OBonusAmt string 原交易折抵金額
MMemberID string 特約機構會員 ID
Timestamp string 時間戳記

Response

{
  "RtnCode": 1,
  "RtnMsg": "訊息代碼：0001，成功",
  "EncData": {
    "MerchantID": "10523650",
    "PlatformID": "10523647",
    "TransactionID": "20230516101744009384",
    "PaymentDate": "2023/05/16 10:17:44",
    "RefundTotalAmount": "100",
    "RefundICPAmount": "100.0000",
    "RefundBonusAmt": "0",
    "RemainingTotalAmount": "0",
    "RemaininggBonusAmt": "0",
    "OTotalAmount": "100",
    "OICPAmount": "100",
    "OBonusAmt": "0",
    "MerchantTradeNo": "202305160934510006",
    "OMerchantTradeNo": "202305160934510005",
    "MMemberID": "",
    "Timestamp": "2023/05/16 10:17:44"
  }
}