Skip to main content

Place an order


Create a pre-order transaction and pay through the returned information.

Only mobile payment is supported. Through configuration, the following payments can be supported:

WeChat, Alipay, UnionPay
OCT, ICBC, FDMS, MPGS
PAYME, UEPAY, BOCVMP(bocpay)

Info

{domain}/Servlet/JSAPIService.do

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

NameTypeDescriptionRequirement
serviceStringInterface name
service.united.wap.PreOrder
user_confirm_keyString(12)User Key, provided by eftPay
transaction_amountString(8)Amount. Requires numbers, maximum decimal length is 2
out_trade_noString(28)Merchant order number
buyerTypeString(7)Device type
ios, android, others
subjectString(256)Transaction information
bodyString(128)In situations where various goods need to be described, it is recommended to accumulate the description of the goods
pay_sceneStringPayment scene
Fixed: WAP
fee_typeString(5)Currency type, HKD, CNY
Default: HKD
tidString(20)Merchant terminal number
notify_urlString(240)Notification address, production environment only supports 80 and 443 ports, other ports need to apply
return_urlString(240)The return address after payment is completed. Cannot carry parameters, the production environment only supports 80 and 443 ports, other ports need to apply
active_timeStringValid time, in seconds. Default 30 minutes, that is, 1800
langStringLanguage, fixed value:cnenhk
timeStringTime, format: yyyyMMddHHmmss
signString(64)Signature

NameTypeDescriptionRequirement
return_statusString(3)Return status code. represents . Note: This parameter cannot be used to determine the success of the transaction.
return_charString(100)Return description, which may change and cannot be used for conditional judgment.
return_status greater than 00 returns
timeStringTime in the format yyyyMMddHHmmss. Returned when return_status >= 00.
signString(64)Signature. Returned when return_status >= 00.

NameTypeDescriptionRequirement
pay_apptradeStringTransaction initiation information
user_confirm_keyStringUser key provided by eftPay
out_trade_noString(28)Merchant order number
buyerTypeString(7)Device type
fee_typeString(5)Currency
transaction_amountString(8)Transaction amount
tidString(20)Terminal number. Returned when there is a delivery request for consumption.

{
    "pay_scene": "WAP",
    "service": "service.united.wap.PreOrder",
    "user_confirm_key": "S0003469",
    "subject": "中文测试 test",
    "transaction_amount": "0.39",
    "sign": "cacaed54340aa12868ac27ee9573b9081ef46bba163ad066624fb811b24ef298",
    "body": "中文测试 test",
    "out_trade_no": "rrn_1686280006028",
    "fee_type": "HKD",
    "buyerType": "android",
    "return_url": "https://vmp.eftpay.com.cn/VMP/notify/testing",
    "time": "20230609110646"
}

{
    "user_confirm_key": "S0003469",
    "pay_apptrade": "https://vmp.eftpay.com.cn/VMP/web/payPage?userkey=12345678&outTradeNo=20190824010716&sign=5c24f30f758d86e2ba1cc1a291aa6d392f563180584f071d2d725eff52947f05",
    "return_char": "",
    "transaction_amount": "0.71",
    "sign": "4429ed39d64a06c2b0df52f4f16b643cd1f05fdc32de82230c46c28cfb75dd81",
    "fee_type": "HKD",
    "out_trade_no": "rrn_1686280006030",
    "buyerType": "andriod",
    "return_status": "00",
    "time": "20230609110646"
}

Cashier Payment Page
Cashier Payment Page