Scan2Pay
  • Scan2Pay API
  • API通用規則說明
    • API環境
    • API資料傳輸加解密
    • API Request資料格式
    • API Response資料格式
    • SDK
  • API規格說明
    • 消費者主掃
    • 消費者被掃
    • 信用卡授權
    • 悠遊卡操作
      • 取得裝置清單
      • 登入
      • 卡號查詢
      • 餘額查詢
      • 卡片扣款
      • 卡片退款
      • 結帳
      • 重試交易(悠遊卡)
    • 退款
    • 部分退款
    • 單筆交易查詢
    • 多筆交易查詢
    • 新版多筆交易查詢
    • 電子發票查詢
    • 交易訂單取消
  • 交易結果通知
  • 附錄
    • 支付平台代碼表
    • Scan2Pay交易結果代碼表
    • 悠遊卡交易結果代碼表
    • 悠遊卡交易資訊列印
    • 讀卡機設定
    • 發票API
  • Scan2Pay SSO API
  • API規格說明
    • 取得授權
    • 獲取token
    • 確認token
    • 取得用戶資料
Powered by GitBook
On this page
  • 說明
  • Request
  • Header
  • Data
  • Response
  • Header
  • Data
  • API Example
  • Request
  • Response
  1. API規格說明

信用卡授權

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\":\"PO20180715003\",\"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
  }
}
Previous消費者被掃Next悠遊卡操作

Last updated 2 months ago

交易結果代碼