Credit Card Payment

Description

Obtains credit card authorization to process the transaction.

The credit card payment URL which is obtained from “platformRsp” field in Response Data has to be sent as a request via HTTPS and get a response to complete the transaction (note: TLS1.2 or higher version for HTTPS)

To test the Credit card payment, please contact intella for the testing credit card number

Request

Header

Item	Mandatory	Data Type	Sample	Description
Method	YES	String(5)	20000	Fill in 20000 (credit card payment)
ServiceType	YES	String	Payment	Selected Scan2Pay Service type
MchId	YES	String	Account0001	Merchant ID provided by intella
TradeKey	YES	String	sha256...hash	Marchant password provided by intella, this password must be encoded by SHA256
CreateTime	YES	String(14)	20180101120000	Request time, the format is "yyyyMMddHHmmss"

Data

Item	Mandatory	Data Type	Sample	Description
TimeExpire	NO	String	20180101120000	Order expiry time, the format is "yyyyMMddHHmmss"
DeviceInfo	YES	String	skb0001	Terminal number is fixed at “skb0001”
StoreOrderNo	YES	String(20)	PO180101001	Order number, composition shall be an alphanumeric string and no more than 20 characters
Body	YES	String	chickenchop	Product name
FeeType	NO	String	TWD	Transaction currency, defaults to TWD
TotalFee	YES	Integer	75	Positive integer. Can not be a negative value
Detail	NO	String	crispychickenchop	Order detail
StoreInfo	NO	String	00001	Store ID
StoreName	NO	String	ZhongxiaoStore	Store name
StoreType	NO	String	RegularChain	Store type
DeviceOS	NO	String	2	Device type (1:iOS / 2:Android / 3:Windows / 4:Others)
CardId	YES	String(16)	1234567898764423	Credit card number
ExtenNo	YES	String(3)	123	CVV
ExpireDate	YES	String(4)	2505	Format is "YYMM"

To avoid transaction failure, order number (StoreOrderNo) cannot be more than 20 characters, and must be alphabets and/or numbers, any special symbols or characters are unacceptable.

Response

Header

Item	Data Type	Sample	Description
StatusCode	String(4)	0000	Transaction Status Code
StatusDesc	String	Success	Description of transaction status
Method	String(5)	10100	Payment method code
ServiceType	String	Payment	Selected Scan2Pay Service type
MchId	String	Account0001	Merchant ID
ResponseTime	String	20180101120000	Transaction response time, the format is "yyyyMMddHHmmss"

Data

Item	Data Type	Sample	Description
SysOrderNo	String	2018010110074205610	System order number
StoreOrderNo	String(20)	PO180101001	Store order number
TotalFee	Integer	7500	The amount has to be divided by 100
FeeType	String	TWD	Transaction currency, defaults to TWD
DeviceInfo	String	skb0001	Terminal number is fixed at “skb0001”
Body	String	chickenchop	Product name
platformRsp	String	https://...	Payment URL
serialNumber	String	0

API Example

Request

{
  "Header": {
    "Method": "2000",
    "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
  }
}