信用卡授權

Payment

說明

取得信用卡授權, 進行交易

Response中取得的信用卡交易URL, 需要進行發送(https request), 取得回應後, 才能完成該筆交易 (note: 需使用TLS1.2以上安全協議連線)

若使用測試Server，請洽詢intella取得測試信用卡號以進行測試.

Request

Header

欄位	必填	型別	範例	說明
Method	YES	String(5)	20000	支付方式請填20000 (信用卡授權交易)
ServiceType	YES	String	Payment	所選用的Scan2Pay服務代碼
MchId	YES	String	Account0001	由intella所提供的特店帳號
TradeKey	YES	String	sha256...hash	由intella所提供的交易密碼, 此密碼須先經過SHA256加密，再進行Hex編碼。
CreateTime	YES	String(14)	20180101120000	Request建立時間, 格式為yyyyMMddHHmmss

Data

欄位	必填	型別	範例	說明
TimeExpire	NO	String	20180101120000	訂單失效時間, 格式為yyyyMMddHHmmss
DeviceInfo	YES	String	skb0001	終端機編號, 請固定填skb0001
StoreOrderNo	YES	String(20)	PO180101001	訂單編號, 全英數不超過20字元
Body	YES	String	雞排	商品名稱
FeeType	NO	String	TWD	交易幣別, 預設為台幣TWD
TotalFee	YES	Integer	75	交易金額, 正整數, 不能為負值
Detail	NO	String	香酥大雞排	訂單資訊
StoreInfo	NO	String	00001	門市代號
StoreName	NO	String	忠孝店	分店名稱
StoreType	NO	String	直營店	分店類型
DeviceOS	NO	String	2	裝置類型 (1: iOS / 2: Android / 3: Windows / 4: Others)
CardId	YES	String(16)	1234567898764423	信用卡卡號
ExtenNo	YES	String(3)	123	背面三碼
ExpireDate	YES	String(4)	2505	格式為YYMM

訂單編碼(StoreOrderNo)不可超過20字元，且只能使用英文字母和數字，不能使用符號或是特殊字元，以免導致部分支付交易失敗

Response

Header

欄位	型別	範例	說明
StatusCode	String(4)	0000	交易結果代碼
StatusDesc	String	交易成功	交易結果代碼說明
Method	String(5)	10100	支付方式代碼
ServiceType	String	Payment	所選用的Scan2Pay服務代碼
MchId	String	Account0001	特店帳號
ResponseTime	String	20180101120000	交易回應時間, 格式為yyyyMMddHHmmss

Data

欄位	型別	範例	說明
SysOrderNo	String	2018010110074205610	系統訂單編號
StoreOrderNo	String(20)	PO180101001	特店訂單編號
TotalFee	Integer	7500	交易總金額 (註: 金額部分需要除以100)
FeeType	String	TWD	交易幣別
DeviceInfo	String	skb0001	終端機編號
Body	String	雞排	商品名稱
platformRsp	String	https://...	交易URL
serialNumber	String	0

API Example

Request

{
  "Header": {
    "Method": "20000",
    "ServiceType": "Payment",
    "MchId": "myMchId",
    "TradeKey": "9af15b336e6a9619928537df30b2e6a2376569fcf9d7e773eccede65606529a0",
    "CreateTime": "20180715102050"
  },
  "Data": "{\"DeviceInfo\":\"skb0001\",\"StoreOrderNo\":\"PO-20180715-003\",\"Body\":\"Food\",\"TotalFee\":\"1\",\"CardId\":\"4050123300004321\",\"ExtenNo\":\"123\",\"ExpireDate\":\"3012\"}"
}

Response

{
  "Header": {
    "StatusCode": "0000",
    "StatusDesc": "執行成功",
    "Method": "20800",
    "ServiceType": "Payment",
    "MchId": "myMchId",
    "ResponseTime": "20180715102052"
  },
  "Data": {
    "sysOrderNo": "",
    "storeOrderNo": "PO-20180715-003",
    "totalFee": "100",
    "feeType": "TWD",
    "deviceInfo": "DeviceMiles",
    "platformRsp": "https://tspg-t.taishinbank.com.tw/tspgapi/hpp/vweb.aspx?MID=999812666555044&KEY=IspQv2tH8sMXGeGPUYhM1S3HPpP4j5z3PfXar+5bbEwLrEBJtTbzQPZhTVkVAW+Hnx3DZJIbflPqP9PhC/TiceBYxcrdYxRt9HBK4qGG8UfLeYbpfN3lUH41Rx7eJb8dB++3Y82VJbc49TO2jBSmsj/IadqLqpYdZl8W8q+0S4WqG32r0FJDnWxCkMnwhQqCeBPOkHGCTGTTV+/5UqgfDVjQ/VdcSWSHwJCm9P2eysyyp6uPZgtddzG94CbxzquapMMlvDAQqxUWIsk7R+wcjYDPIgAMRsdA==&MAC=ViTrzqfObo3XWaio9Ru50OxkQhAN4k5u6KW7j1nMzm0=&CIPHER=0MSF3mFVQS4TdfcClB2DolTnYEBzS4auzNgzuEBsqsHPDL1GxtyBqmhnReCSzLpFXr4FQ+nErB04f6/NNNFHZjLzv1TxAepaoa+YI5LXP14nUExqXV4UZbT7ie6RVZHeY8anrLEnmXhns2dy0TmZAM6D+8HWN3vwBuKBE8C42bHrlqwf5CipjUhSGBvOaSnxOJR0aPqfiBO0l5syMzvANwZgF67vtJaJMBRVEXqBoMo2/SSUE/tW9qn/YpMKIFYXI2OPZyV5jBmcv13N4iuiFwajINFeHMSYGAo38TZxyMVJNOeqKDfN7+UaXanzpIbBvbB2X5LlsJ1xOVCQvXXZ3fboigqhYacXRP6542PODSa/btcPSi1fpxwOoHRGQr5IvRT+SUGc9gg/RMCG2RxxvJmF6shmBCHA1sHx6KwDw29SP7MA9AcNoIQ5ScMjjGMwMTWAUWjx9Z6NJld/3P87DZBwNfzuPNgUx4SBxR7/wjyh+h0mhJQDcpLRnILGVKbHcKT9ptvxm9qqOlSqKZrZkwepe62P0r+fWCjyIqeFgdDXm/QWEpGrw37o8iKnhYHQ15kQfq7QMD4lmPIip4WB0Neb8g71kgLsElsQQ6Q6n4wZr4TndqCl6+TwOr991udWh2LuAs+TU1SZdxaNVpI6T94kmt+fqth5PTdJd8bpe1zE+6qDYSFCfMsX7FjSiMuZn1LVK8LzxyFMb8opbtO8S4OO6edkAKUbuPG9mnjvTL9f+wBafaTIPJMlQji3mg6XKXC10R9Zxplx+7IB2f5bJCc+R6EQwBl5HSL/fxtGRWiLJdaRTlTfJmNbEk8t8TLJ7iNXx4tZMsnuI1fHi1k=",
    "serialNumber": 0
  }
}