Skip to content

Taiwan Pay Refund

Description

Taiwan Pay退款。

Resource

POST /v1/payment/taiwan/refund/{order_id}

Authorization

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

Path Parameters

Name Type Description
order_id string 訂單編號

Request Body Parameters

Name Type Description
shop_id string 分店編號

Request

POST /v1/payment/taiwan/pay/00003021091100011

{
    "shop_id" :"000030"
}

Response-華南版

{
    "respDesc": "交易成功處理",
    "txnDir": "RS",
    "orgAmt": "2000",
    "orgTerminalId": "k1",
    "orgEndpointCode": "00000001",
    "sign": "783175b8dd85addd56499e7db4a3ad0a64bef484fce801cce2eef698864e0c7e",
    "orgOrderNumber": "00003021091100011",
    "terminalId": "K1",
    "isOrderRefund": "",
    "storeId": "008244360740001",
    "storeReMsgType": "",
    "txnDateTime": "20210911155717",
    "orgCurrency": "901",
    "storeRefundNO": "",
    "txnSeqno": "20210911155623224442",
    "respCode": "4001"
}

Response Body Parameters-華南版

Name Type Description
respDesc string 交易資訊
txnDir string 交易方向(RQ:Request 店家端填入 RS:Response 銀行端填入)
orgAmt string 沖正/退款金額 (含小數兩位例如:10010000)
orgTerminalId string (原)終端號(機號)
orgEndpointCode string 華銀所核發之端末代號
sign string 店家端與銀行端 Mac 驗證值
orgOrderNumber string 訂單編號
terminalId string 終端號(機號)
isOrderRefund string 是否採用訂單編號進行退款
storeId string 華銀所核發之收款方編號
storeReMsgType string 部份退款類別
txnDateTime string 交易日期時間
orgCurrency string (原)交易幣別
storeRefundNO string 部份退款序號
txnSeqno string 銀行端交易序號
respCode string 交易代號,4001:交易成功、9999:處理中、Other:其他資訊

Response-財金版

{
    "mti": "0210",
    "cardNumber": "4612630156100200",
    "processingCode": "002543",
    "amt": "000000934000",
    "systemDateTime": "1025112153",
    "traceNumber": "112105",
    "acqBank": "005",
    "srrn": "943003933902",
    "respCode": "4001",
    "terminalId": "10016338",
    "merchantId": "005276932381001",
    "orderNumber": "P2022102500005",
    "verifyCode": "B12E974A228EB0B8EACDC2D5779AF983AAF9280471D4E8FCB12BC7D5B7B3DD2A"
}

Response Body Parameters-財金版

Name Type Description
mti string 交易類型
cardNumber string 卡(帳)號,若條碼內含卡(帳)號資訊,則成功交易回應條碼內之卡(帳)號
processingCode string 處理代碼
amt string 交易金額
systemDateTime string 系統日期時間
traceNumber string 端末交易序號
acqBank string 收單行代碼
srrn string 系統追蹤號
respCode string 回應碼:
  • 4001: 成功
  • 其他: 失敗
terminalId string 端末代號
merchantId string 特店代號
orderNumber string 訂單編號
verifyCode string 驗證碼