Apple Pay 令牌支付
通過整合 Apple Pay 獲取的付款令牌進行支付。付款服務機構為 mpgs。
相關信息
{domain}/Servlet/JSAPIService.do
https:/VMP/Servlet/JSAPIService.do
| 名稱 | 類型 | 描述 | 要求 |
|---|---|---|---|
| service | String | 接口名稱， service.mpgs.token.ApplePay | |
| user_confirm_key | String(12) | 用戶Key，由 eftPay 提供 | |
| token_id | String | 通過整合 Apple Pay 獲取的付款令牌 | |
| transaction_amount | String(8) | 金額。要求數字，小數位最大長度為2 | |
| out_trade_no | String(28) | 商戶訂單號 | |
| payType | String(6) | 支付類型， Mpgs | |
| buyerType | String(7) | 設備類型ios ， android ， others | |
| subject | String(256) | 交易信息 | |
| wallet | String(20) | 錢包類型， MPGS | |
| body | String(128) | 在需要描述各種商品的情況下，建議積累描述商品的字串 | |
| pay_scene | String | 支付場景，默認請傳 TOKEN_APPLE_PAY | |
| fee_type | String(5) | 貨幣類型， HKD | |
| tid | String(20) | 商戶終端號 | |
| notify_url | String(240) | 通知地址，投產環境只支持 80 和 443 端口，其他端口需要申請 | |
| time | String | 時間，格式： yyyyMMddHHmmss | |
| sign | String(64) | 簽名 |
| 名稱 | 類型 | 描述 | 要求 |
|---|---|---|---|
| return_status | String(3) | 返回狀態碼，代表。注：此參數不可作為交易狀態是否成功的判斷 其他狀態碼見 附錄3 | |
| return_char | String(100) | 返回說明，可能會變化，不能作條件判斷 | |
| time | String | 時間，格式：yyyyMMddHHmmssreturn_status >= 00 時返回 | |
| sign | String(64) | 簽名return_status >= 00 時返回 |
| 名稱 | 類型 | 描述 | 要求 |
|---|---|---|---|
| token_id | String | 通過整合 Apple Pay 獲取的付款令牌 | |
| user_confirm_key | String | 用戶Key，由 eftPay 提供 | |
| trade_no | String(64) | 支付提供方單號 | |
| transaction_id | String(64) | 支付提供方單號 | |
| gmt_payment | String | 交易時間，格式： yyyy-MM-dd HH:mm:ss | |
| trade_type | String(10) | 交易類型SALE | |
| pay_scene | String | 支付場景 | |
| out_trade_no | String(28) | 商戶訂單號 | |
| eft_trade_no | String(28) | 依付得訂單號 | |
| eftpay_trade_no | String(28) | 依付得訂單號 | |
| total_fee | String(8) | 金額 | |
| currency | String(5) | 貨幣類型 | |
| wallet | String(20) | 錢包類型 | |
| trade_status | String(32) | 交易狀態，見 附錄2 | |
| tid | String(20) | 商戶終端號 |
{
"subject": "测试subject",
"body": "测试body",
"user_confirm_key": "S0004152",
"pay_scene": "TOKEN",
"wallet": "MPGS",
"fee_type": "HKD",
"time": "20231010155344",
"token_id": "{\n \"data\" : \"jOlUJcWQObX5jyThzIM1IU……9310b7222\"\n },\n \"version\" : \"EC_v1\"\n}",
"out_trade_no": "20231010155344000000",
"payType": "Mpgs",
"transaction_amount": "1.00",
"service": "service.mpgs.token.ApplePay",
"buyerType": "ios",
"tid": "123",
"sign": "a02c23990336ca547d1f9……ec2b068f77499641bd84b3fa"
}
支付成功
{
"token_id": "",
"user_confirm_key": "S0004152",
"trade_no": "328307172405",
"transaction_id": "328307172405",
"gmt_payment": "2023-10-10 15:53:49",
"trade_type": "SALE",
"out_trade_no": "20231010155344000000",
"eft_trade_no": "8520000212700003682237ecgjtb181",
"eftpay_trade_no": "8520000212700003682237ecgjtb181",
"total_fee": "1.00",
"currency": "HKD",
"wallet": "MPGS",
"trade_status": "TRADE_SUCCESS",
"tid": "123",
"time": "20231010155349",
"return_status": "00",
"return_char": "",
"sign": "9dafe3af7a0686617787922b269b27953210349abf74464706798cb862b1e9b5"
}
支付失敗
{
"token_id": "",
"user_confirm_key": "S0004152",
"trade_no": "",
"transaction_id": "",
"gmt_payment": "",
"trade_type": "SALE",
"out_trade_no": "20231009153828",
"eft_trade_no": "8520000212700003682237e2uvki934",
"eftpay_trade_no": "8520000212700003682237e2uvki934",
"total_fee": "0.34",
"currency": "HKD",
"wallet": "MPGS",
"trade_status": "TRADE_CLOSED",
"tid": "123",
"time": "20231009153832",
"return_status": "00",
"return_char": "",
"sign": "cd6724a06db8d90a94875eef70610c4b0c86b468cb5ff14af9e474a857095a64"
}