跳至主要內容

下單

創建預下單交易，通過返回的信息進行支付。

相關信息

{domain}/Servlet/JSAPIService.do 

https://vmp.eftpay.com.cn/VMP/Servlet/JSAPIService.do

名稱類型描述要求
serviceString接口名稱，詳見 支援的service
user_confirm_keyString(12)用戶Key，由 eftPay 提供
transaction_amountString(8)金額。要求數字，小數位最大長度為2
out_trade_noString(28)商戶訂單號
payTypeString(6)支付類型，詳見 支援的payType
buyerTypeString(7)設備類型
ios，android，others
subjectString(256)交易信息
walletString(20)錢包類型，詳見 支援的wallet
bodyString(128)在需要描述各種商品的情況下，建議積累描述商品的字符串
pay_sceneString支付場景，默認請傳 WEB，其他詳見 支援的pay_scene
fee_typeString(5)貨幣類型，HKD，CNY
默認：HKD
tidString(20)商戶終端號
notify_urlString(240)通知地址，投產環境只支援 80 和 443 端口，其他端口需要申請
return_urlString(240)支付完成後的返回地址。不能攜帶參數，投產環境只支援 80 和 443 端口，其他端口需要申請
active_timeString有效時間，單位秒。默認30分鐘，即1800
langString語言，固定值：cn，en，hk，詳見 支援lang的service
customerInfoObject客戶信息，支付類型為ATOME時有效，詳見 ATOME參數說明
shippingAddressObject送貨地址，支付類型為ATOME時有效，詳見 ATOME參數說明
billingAddressObject賬單地址，支付類型為ATOME時有效，詳見 ATOME參數說明
itemsObject[]有關訂單項的詳細信息，支付類型為ATOME時有效，詳見 ATOME參數說明
schemeStringAPP 應用 scheme，APP使用 webview 嵌套方式進行支付時有用。支付類型為UnionPay時有效
packageNameStringAPP 應用包名，APP使用 webview 嵌套方式進行支付時有用。支付類型為UnionPay時有效
app_linkStringAPP 鏈接，支付後跳回APP。錢包類型為 BOCVMPUPI 時有效
timeString時間，格式：yyyyMMddHHmmss
signString(64)簽名

查看支援的 service 以及其對應的 payType 和 wallet

以下是 service、payType 和 wallet 三者之間的對應關係

servicepayTypewallet描述
service.alipay.wap.PreOrderAlipayALIPAYCN
ALIPAYHK		支付寶 wap 接口
service.wechat.web.MobileH5WeChatWECHATCN
WECHATHK		非微信內手機瀏覽器 H5 接口
service.wechat.oauth2.AuthorizeWeChatWECHATCN
WECHATHK		微信內公眾號 H5 接口
service.icbc.wap.PreOrderICBCICBCWAPICBC wap 接口
service.atome.v2.wap.PreOrderATOMEATOMEATOME 線上接口
service.unionpay.online.web.PreOrderUnionPayUNIONPAY銀聯線上收銀接口
service.oct.online.PreOrderOCTOCT八達通線上支付接口
service.fdms.web.PreOrderFdmsFDMSFDMS 的 VISA ，Master 支付
service.mpgs.web.PreOrderMpgsMPGSMPGS 的 VISA ，Master 支付
service.ae.web.PreOrderAEAEAE 支付
service.jetco.wap.PreOrderJetcoJETCOHK銀通 wap 接口
service.payme.web.PreOrderPAYMEPAYMEPayMe web 支付接口
service.bocvmp.upi.wap.PreOrderBOCVMPBOCVMPUPIBOCPay wap 接口
查看支援的 service 以及其對應的 pay_scene

預設請傳 WEB。使用以下接口時，需要注意對應的支付場景

servicepay_scene
service.wechat.oauth2.AuthorizeWXWEB
service.alipay.wap.PreOrderWAP
service.jetco.wap.PreOrderWAP
service.unionpay.online.web.PreOrderONLINE_WEB
service.payme.web.PreOrderWEB/APP
service.bocvmp.upi.wap.PreOrderH5/APP

提示

  • 當 pay_scene= WEB ，PayMe web支付接口返回一個二維碼支付頁面鏈接，用於PC端。
  • 當 pay_scene= APP ，PayMe web支付接口返回一個PayMe APP調起鏈接，用於移動端。
  • 當 pay_scene= H5 ，BOCPay wap 接口返回一個 BOCPay APP 調起鏈接，支付完成後會打開默認瀏覽器，跳轉至 return_url。
  • 當 pay_scene= APP ，BOCPay wap 接口返回一個 BOCPay APP 調起鏈接，支付完成後會跳轉至 app_link，參數需要自行簽驗。
  • 調起 BOCPay APP 參考 BOCPay集成指南v1.1.1
查看支援 lang 的 service

cn 為中文簡體，hk 為 中文繁體，en 為英文

servicelang
service.oct.online.PreOrdercn，en，hk
service.mpgs.web.PreOrdercn，en，hk
service.ae.web.PreOrdercn，en，hk
service.jetco.wap.PreOrdercn，en，hk

transaction_amount

PAYME UAT 場可以通過 transaction_amount 的兩位小數位來控制交易的狀態

小數位描述範例
81  將創建一個 [成功] 的交易transaction_amount=0.81
80  將創建一個 [超時] 的交易transaction_amount=0.80
77  將創建一個 [失敗] 的交易transaction_amount=0.77
44  將創建一個 [服務器錯誤-沒有支付二維碼] 的交易transaction_amount=0.44
45  將創建一個 [服務器錯誤-無狀態]的交易transaction_amount=0.45

customerInfo
名稱類型描述要求
mobileNumberString客戶的手機號碼，格式為 E.164。例如中國電話的國際寫法（手機和座機）+8610123456。+861xxxxxxxxxx
fullNameString客戶的全名

例子

"customerInfo": {
	"mobileNumber": "+8613344445555",
	"fullName": "Atome Developer"
}
shippingAddress
名稱類型描述要求
countryCodeString送貨地址，使用 ISO-3611 格式的兩位數字國家/地區代碼。例如 "SG" "HK" "MY" "ID" "TH" "TW" "VN" "PH"
linesArray送貨地址，地址線。例如 ["中國", "香港","九龍",...]
postCodeString送貨地址，郵政編碼

例子

"shippingAddress": {
	"countryCode": "HK",
	"lines": ["中國", "香港"],
	"postCode": "999077"
}
billingAddress
名稱類型描述要求
countryCodeString送貨地址，使用 ISO-3611 格式的兩位數字國家/地區代碼。例如 "SG" "HK" "MY" "ID" "TH" "TW" "VN" "PH"
linesArray送貨地址，地址線。例如 ["中國", "香港","九龍",...]
postCodeString送貨地址，郵政編碼

例子

"shippingAddress": {
	"countryCode": "HK",
	"lines": ["中國", "香港"],
	"postCode": "999077"
}
项目
名稱類型描述要求
temIdString此產品 / SKU 的 ID
nameString項目名稱
quantityInt項目數量
priceInt商品的售價，單位分

例子

"items": [{
	"itemId": "P100",
	"name": "iPhone 12 pro max",
	"price": 11020,
	"quantity": 1
}, {
	"itemId": "P101",
	"name": "iPhone SE case",
	"price": 1000,
	"quantity": 1
}]

名稱類型描述要求
return_statusString(3)返回狀態碼，代表。注：此參數不可作為交易狀態是否成功的判斷
其他狀態碼見 附錄3
return_charString(100)返回說明，可能會變化，不能作條件判斷
return_status 大於 00 時返回
timeString時間，格式：yyyyMMddHHmmss
return_status >= 00 時返回
signString(64)簽名
return_status >= 00 時返回

名稱類型描述要求
pay_apptradeString交易發起信息
user_confirm_keyString用戶Key，由 eftPay 提供
out_trade_noString(28)商戶訂單號
payTypeString(6)支付類型
buyerTypeString(7)設備類型
walletString(20)錢包類型
eft_trade_noString(28)依付得訂單號
fee_typeString(5)貨幣
transaction_amountString(8)交易金額
tidString(20)終端號，當消費請求有送的時候返回

{
	"pay_scene": "WAP",
	"user_confirm_key": "12345678",
	"wallet": "ALIPAYHK",
	"subject": "中文测试 test",
	"transaction_amount": "0.02",
	"sign": "af8f9f9d60019ce649af1ddfefd2aae98fa71656278a6edf439948cab7dc69d9",
	"body": "中文测试 test",
	"tid": "",
	"payType": "Alipay",
	"out_trade_no": "20190824010716",
	"service": "service.alipay.wap.PreOrder",
	"buyerType": "andriod",
	"return_url": "https://vmp.eftpay.com.cn/VMP/notify/testing",
	"time": "20190824010716"
}


{
	"user_confirm_key": "12345678",
	"wallet": "ALIPAYHK",
	"pay_apptrade": "https://vmp.eftpay.com.cn/VMP/wap/payPage?userkey=12345678&outTradeNo=20190824010716&sign=5c24f30f758d86e2ba1cc1a291aa6d392f563180584f071d2d725eff52947f05",
	"return_char": "",
	"transaction_amount": "0.02",
	"sign": "11c2d25ad95a8849a7598ca57b83731d0e2c2019710c7dd3feccbd8895d6d01c",
	"fee_type": "HKD",
	"tid": "",
	"eft_trade_no": "08520005269190824010701722",
	"out_trade_no": "20190824010716",
	"payType": "Alipay",
	"buyerType": "andriod",
	"return_status": "00",
	"time": "20190824010717"
}
Powered By eftPay Copyright©2023 eftPay All Rights Reserved.