跳至主要內容

下单


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

目前只支持微信和支付宝。

相关信息

{domain}/Servlet/AppTradePay.do

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

名称类型描述要求
user_confirm_keyString(12)用户Key,由 eftPay 提供
transaction_amountString(8)金额。要求数字,小数位最大长度为2
out_trade_noString(28)商户订单号
payTypeString(6)支付类型
AlipayWeChat
buyerTypeString(7)设备类型
iosandroidothers
subjectString(256)交易信息
walletString(20)钱包类型
AlipayALIPAYHKALIPAYCN
WeChatWECHATHKWECHATCN
bodyString(128)在需要描述各种商品的情况下,建议积累描述商品的字符串
pay_sceneString支付场景
APP
fee_typeString(5)货币类型,HKDCNY
默认:HKD
默认:HKD
tidString(20)商户终端号
notify_urlString(240)通知地址,投产环境只支持 80443 端口,其他端口需要申请
active_timeString(240)有效时间,单位秒。微信默认900;支付宝默认1800,而且要求为60的倍数。
timeString时间,格式:yyyyMMddHHmmss
signString(64)签名

提示

不同的 payType 需要对应不同的 wallet

  • Alipay
    • ALIPAYHK (支付宝香港钱包)
    • ALIPAYCN (支付宝大陆钱包)
  • WeChat
    • WECHATHK (微信支付香港钱包)
    • WECHATCN (微信支付大陆钱包)

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

名称类型描述要求
pay_apptradeStringAPP 交易发起信息
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_apptrade 用来调用对应支付钱包的sdk,发起支付。
支付宝会返回数据类型为 String 可以直接使用,微信返回是 JSON 格式需要解析在参考 app 开发文档进行处理。

{
    "pay_scene": "APP",
    "user_confirm_key": "S0003469",
    "wallet": "ALIPAYCN",
    "subject": "中文测试 test",
    "body": "test",
    "transaction_amount": "0.77",
    "sign": "43b6b40b6083cc914f62216d262bae6a4f22bc9317852420295e3b4a18f529c8",
    "tid": "123456",
    "fee_type": "HKD",
    "payType": "Alipay",
    "out_trade_no": "rrn_1686280005923",
    "buyerType": "android",
    "time": "20230609110645"
}

{
    "user_confirm_key": "S0003469",
    "wallet": "ALIPAYCN",
    "pay_apptrade": "_input_charset=utf-8&body=测试&currency=HKD&forex_biz=FP......",
    "return_char": "",
    "transaction_amount": "0.02",
    "sign": "068235adf035e0d60ca25b5d68bcc09b26782ee2190d1ac47acca9b982e2a1bb",
    "fee_type": "HKD",
    "tid": "",
    "eft_trade_no": "20005269520084311t5rutcv1734",
    "out_trade_no": "20200120114032000838",
    "payType": "Alipay",
    "buyerType": "android",
    "return_status": "00",
    "time": "20200120114035"
}