下单

创建预下单交易，通过返回的信息进行支付。

相关信息

{domain}/Servlet/JSAPIService.do

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

名称	类型	描述
service	String	接口名称，详见支持的service
user_confirm_key	String(12)	用户Key，由 eftPay 提供
transaction_amount	String(8)	金额。要求数字，小数位最大长度为2 PAYME测试金额参数说明
out_trade_no	String(28)	商户订单号
paytype	String(6)	支付类型，详见支持的paytype
buyertype	String(7)	设备类型 `ios`，`android`，`others`
subject	String(256)	交易信息
payment_type	String(20)	钱包类型，详见支持的payment_type
tid	String(20)	商户终端号
notify_url	String(240)	通知地址，投产环境只支持 `80` 和 `443` 端口，其他端口需要申请
time	String	时间，格式：`yyyyMMddHHmmss`
sign	String(64)	签名

查看支持的 service 以及其对应的 paytype 和 payment_type

以下是 service、paytype 和 payment_type 三者之间的对应关系

service	paytype	payment_type	描述
service.alipay.qrcode.PreOrder	`Alipay`	`ALIPAYCN` `ALIPAYHK` `ALIPAYBOTH`	支付宝 qrcode 接口
service.wechat.qrcode.PreOrder	`WeChat`	`WECHATCN` `WECHATHK`	微信 qrcode 接口
service.atome.v1.qrcode.PreOrder	`ATOME`	`ATOME`	ATOME qrcode 接口
service.unionpay.qrcode.csb.PreOrder	`UnionPay`	`UNIONPAY`	银联 qrcode 接口
api.service.gbpay.qrcode.cash.PreOrder	`GBPAY`	`GBPAY`	GBPAY qrcode 接口
service.payme.qrcode.PreOrder	`PAYME`	`PAYME`	PAYME qrcode 接口
service.fps.qrcode.PreOrder	`FPS`	`FPS`	FPS qrcode 接口

提示

ALIPAYBOTH 的产生的二维码，可以使用“支付宝”app 或者“支付寶香港”app 进行扫码
微信如果接入的商户是融合钱包机构值为 WECHATHK 或 WECHATCN 都可以下单，最后交易返回的钱包类型以用户支付的钱包为准。

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

名称	类型	描述
return_status	String(3)	返回状态码，代表。注：此参数不可作为交易状态是否成功的判断其他状态码见附录3
return_char	String(100)	返回说明，可能会变化，不能作条件判断
return_status 大于 00 时返回
time	String	时间，格式：`yyyyMMddHHmmss` `return_status` >= `00` 时返回
sign	String(64)	签名 `return_status` >= `00` 时返回

名称	类型	描述
qr_code	String	二维码文本
qr_code_address	String	二维码地址，Alipay类型会有返回，其他类型返回""
user_confirm_key	String	用户Key，由 eftPay 提供
out_trade_no	String(28)	商户订单号
paytype	String(6)	支付类型
buyertype	String(7)	设备类型
payment_type	String(20)	钱包类型
transaction_amount	String(8)	交易金额
tid	String(20)	终端号，当消费请求有送的时候返回
subject	String(256)	交易信息
eftpay_trade_no	String(28)	依付得订单号，配置返回

{
    "service": "service.alipay.qrcode.PreOrder",
    "user_confirm_key": "S0003469",
    "transaction_amount": "0.03",
    "out_trade_no": "$function=getSaleOutTradeOut",
    "paytype": "Alipay",
    "buyertype": "others",
    "subject": "test",
    "sign": "a482c2a7af5cbeb5bee616d74d74e24e2ec1eaf598f01f7d5aba18ce97375309",
    "time": "20230609110646",
    "payment_type": "ALIPAYCN",
    "tid": "ttt333",
    "notify_url": "https://www.merchant.com/notify/receive"
}

{
    "return_status": "00",
    "return_char": "",
    "sign": "799f6804aa6a8ee96a714654051cf0b9c1f228fb86446aa7d0454ed5924ef489",
    "time": "20230609110646",
    "qr_code": "sa22fs3avv3smvs4a45jgs578fsk2330fojsjg311",
    "qr_code_address": "sa22fs3avv3smvs4a45jgs578fsk2330fojsjg311",
    "user_confirm_key": "S0003469",
    "out_trade_no": "rrn_1686280006055",
    "paytype": "Alipay",
    "buyertype": "andriod",
    "payment_type": "ALIPAYHK",
    "transaction_amount": "0.77",
    "tid": "tid_3378",
    "subject": "test123"
}