Apple Pay Token Payment
Make payments using the payment token obtained through Apple Pay integration. The payment service provider is mpgs.
Info
{domain}/Servlet/JSAPIService.do
https:/VMP/Servlet/JSAPIService.do
| Name | Type | Description | Requirement |
|---|---|---|---|
| service | String | Interface name, service.mpgs.token.ApplePay | |
| user_confirm_key | String(12) | User Key provided by eftPay | |
| token_id | String | Payment token obtained through Apple Pay integration | |
| transaction_amount | String(8) | Amount. Only numbers are required, with a maximum of 2 decimal places | |
| out_trade_no | String(28) | Merchant order number | |
| payType | String(6) | Payment type, Mpgs | |
| buyerType | String(7) | Device typeios , android , others | |
| subject | String(256) | Transaction information | |
| wallet | String(20) | Wallet type, MPGS | |
| body | String(128) | Recommended to accumulate a string describing the various products if necessary | |
| pay_scene | String | Payment scene, please pass TOKEN_APPLE_PAY by default | |
| fee_type | String(5) | Currency type, HKD | |
| tid | String(20) | Merchant terminal number | |
| notify_url | String(240) | Notification address. In the production environment, only ports 80 and 443 are supported. Other ports need to be applied for | |
| time | String | Time, format: yyyyMMddHHmmss | |
| sign | String(64) | Signature |
| Name | Type | Description | Requirement |
|---|---|---|---|
| return_status | String(3) | Return status code, represents . Note: This parameter cannot be used as a judgment of whether the transaction status is successful Other status codes see Appendix 3 | |
| return_char | String(100) | Return description, may change, can not be used as a condition judgment | |
| time | String | Time, format: yyyyMMddHHmmssreturn_status >= 00 return | |
| sign | String(64) | Signaturereturn_status >= 00 return |
| Name | Type | Description | Requirement |
|---|---|---|---|
| token_id | String | Payment token obtained through Apple Pay integration | |
| user_confirm_key | String | User Key provided by eftPay | |
| trade_no | String(64) | Payment provider order number | |
| transaction_id | String(64) | Payment provider order number | |
| gmt_payment | String | Transaction time in the format: yyyy-MM-dd HH:mm:ss | |
| trade_type | String(10) | Transaction typeSALE | |
| pay_scene | String | Payment scene | |
| out_trade_no | String(28) | Merchant order number | |
| eft_trade_no | String(28) | EftPay order number | |
| eftpay_trade_no | String(28) | EftPay order number | |
| total_fee | String(8) | Amount | |
| currency | String(5) | Currency type | |
| wallet | String(20) | Wallet type | |
| trade_status | String(32) | Transaction status, see Appendix 2 | |
| tid | String(20) | Merchant terminal number |
{
"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"
}
Payment successful
{
"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"
}
Payment failed
{
"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"
}