付款 API

位置：https://pos.jkopay.com/{系統方名稱}/Payment

請求參數

參數名稱	資料型態	最大長度	必要	說明
MerchantID	String	10	Y	特店代碼，請依街口提供的測試／正式商店代碼更新
StoreID	String	20	Y	商店編號
StoreName	String	100	Y	商店名稱，請帶入半形字元
GatewayTradeNo	String	20	Y	銀行端交易序號。若無，請放空值
MerchantTradeNo	String	60	Y	商店端交易序號（付款流水號） 需為唯一值，不可重複
PosID	String	20	Y	POS 機號
PosTradeTime	String	19	Y	POS 端交易日期時間，格式：yyyy/MM/dd HH:mm:ss
CardToken	String	18	Y	支付條碼 格式：2碼固定值”22″ + 16碼亂數字串
TradeAmount	int		Y	實際消費金額
UnRedeem	int		Y	不可折抵金額。若無請放 0
Remark	String	1000	Y	備註。若無，請放空值
Extra1	String	512	Y	保留欄位一。若無，請放空值
Extra2	String	512	Y	保留欄位二。若無，請放空值
Extra3	String	512	Y	街口端回傳信用卡資訊，請放空值
SendTime	String	14	Y	交易發送日期時間，格式：yyyyMMddHHmmss
Sign	String	64	Y	簽章值，請參照【1.1交易簽章規則】章節。 須為全小寫

範例如下：

{
  "CardToken": "22J111111111111111",
  "Extra1": "",
  "Extra2": "",
  "Extra3": "",
  "GatewayTradeNo": "",
  "MerchantID": "9999999",
  "MerchantTradeNo": "2020009041651",
  "PosID": "1",
  "PosTradeTime": "2020/08/01 10:05:11",
  "Remark": "",
  "SendTime": "20200801100511",
  "StoreID": "9999999",
  "StoreName": "街口測試",
  "TradeAmount": 10,
  "UnRedeem": 0,
  "Sign":  "626f22697838add43d77954695e3e2dac5f44a4c2ba8a0de405cbbb6175afd2d"
}

---

返回參數

參數名稱	資料型態	最大 長度	必要	說明
MerchantID	String	10	Y	同 request
StoreID	String	20	Y	同 request
GatewayTradeNo	String	20		同 request
MerchantTradeNo	String	60	Y	同 request
PosID	String	20	Y	同 request
TradeNo	String	25	Y	街口端交易序號
TradeTime	String	19	Y	街口端交易日期時間，格式：yyyy/MM/dd HH:mm:ss
StatusCode	String	3	Y	回應碼 000：表示交易成功 請參照【1.2回應碼(StatusCode)】章節。
StatusDesc	String	1000	Y	回應碼說明
IsRep	String	1	Y	是否為重複交易 0：非重複交易 1：重複交易
ActionCode	String	1	Y	建議處理代碼，保留欄位
PaymentType	int		Y	付款方式 1：儲值帳戶 3：銀行帳戶（Account Link） 4：信用卡
TradeAmount	int		Y	同 request
DebitAmount	int		Y	付款方式扣款金額（折抵後金額）
RedeemName	String	10	Y	折抵方式（三擇一），無折抵則回覆空字串 Coin：街口折抵（所有由街口提供之折抵方式：含街口幣與官方街口券等） Store：店家折抵（所有由店家提供之折抵方式：含店家街口券等） Coin, Store：街口折抵 + 店家折抵（使用上述兩種折抵方式）
RedeemAmount	int			街口折抵金額，此欄位為負值
StoreRedeemAmount	int		C	店家折抵金額，此欄位為負值 該筆交易有店家折抵才會回應此欄位
AvailableAmount	int		Y	儲值帳戶餘額，目前此欄位預設為 0
InvoiceVehicle	String	20		手機條碼發票載具資訊
MerMemToken	String	30		第三方合作廠商會員識別資訊
Remark	String	1000		同 request
Extra1	String	512		同 request
Extra2	String	512		同 request
Extra3	String	512		信用卡資訊：當PaymentType = 4（信用卡）時，此欄位才會以 Json 字串回傳卡名及卡號前六後四碼，其餘皆為空 格式：{“CardName”: “XX卡”, “CardNo”: “222222******3333”}

範例如下：

{
    "MerchantID": "9999999",
    "StoreID": "9999999",
    "GatewayTradeNo": "",
    "MerchantTradeNo": "2020009041651",
    "PosID": "1",
    "TradeNo": "J0065220120100700005",
    "IsRep": 0,
    "PaymentType": 1,
    "TradeAmount": 10,
    "DebitAmount": 7,
    "RedeemName": "Coin",
    "RedeemAmount": -3,
    "AvailableAmount": 0,
    "InvoiceVehicle": "/7DX6J02",
    "MerMemToken": "",
    "Remark": "",
    "Extra1": "",
    "Extra2": "",
    "Extra3": "{\"CardName\":\"街口帳戶\",\"CardNo\":\"123459003417190\"}",
    "ActionCode": "0",
    "StatusCode": "000",
    "StatusDesc": "交易成功",
    "TradeTime": "2020/10/07 20:11:51"
}