发起交易

应用场景

用于最福利发起支付，第三方扣款失败时如需展示失败原因，需返回resultCode=12005,,第三方需要校验用户的可用积分余额是否可以支付订单金额

接口信息

serviceName	trade.pay
version	1.0

请求bizContent参数

参数名称	类型	必填	说明
thirdUser	String	是	第三方用户 id
total	Long	否	用户免密登陆传入信息
amount	Long	是	第三方扣款金额,单位人民币的分,也就是用户应付积分金额，渠道需要校验用户可用积分余额
outTradeNo	String	是	最福利的交易编号,用于查询,重复判断
subject	String	是	订单描述
orderDate	DateTime	是	下单日期
orderIds	String	是	宜员订单号，多个订单号使用逗号分割，可以使用订单号查询具体交易明细
orderInfo	JSONString json 数组字符串	是	订单信息,最福利一个交易包含至少一笔订单,第三方可据此构造自己的订单记录, 结构请参照orderInfo 不建议使用

OrderInfo

参数名称	类型	必填	说明
buyerId	Long	是	最福利用户编号
phone	String	否	第三方免登时传递过来的用户手机号码，如果免登时未传入手机号码，则这里是channelCode ^thirdUserId
orderId	String	是	最福利订单编号
tradeInfo	Object	否	收货地址信息，参考TradeInfo
fee	Long	是	订单金额 ,单位分
serviceName	String	否	最福利商品分类
shipFee	Long	是	运费,单位分
serviceCode	String	否	最福利商品分类编号
sourceId	String	否	如果是京东商城的商品，此值为京东订单编号
items	Array	是	订单商品信息，参考Item

TradeInfo

参数名称	类型	必填	说明
name	String	是	收货人
phone	String	是	联系方式
detail	String	是	收货地址

Item

参数名称	类型	必填	说明
fee	Long	是	商品金额，单位分
mainImage	String	是	商品大图
itemId	Long	是	最福利商品编号
quantity	Integer	是	商品数量
skuId	Long	是	最福利 SkuId
subOrderId	Long	是	最福利子订单编号
title	String	是	商品名称

响应bizContent参数

参数名称	类型	必填	说明
thirdUser	String	是	第三方用户 id
outTradeNo	String	是	最福利的交易编号,用于查询,重复判断
tradeNo	String	是	第三方交易号,后续用于查询或者退款

请求参数

Body 参数application/x-www-form-urlencoded

channelCode

string

渠道编号

必需

serviceName

string

服务名称

必需

示例值:

balance.query

version

string

版本号

必需

示例值:

1.0

thirdUserId

string

第三方用户唯一标识

可选

custId

string

最福利用户编号

可选

phone

string

用户手机号码

可选

bizContent

string

必需

json字符串，具体业务参数

timestamp

string

必需

请求时间，yyyy-MM-dd HH:mm:ss

charset

string

固定值 UTF8

必需

format

string

固定值 json

必需

sign

string

签名

必需

signType

string

必需

签名类型，固定值MD5

示例值:

MD5

返回响应

🟢200成功

application/json

Body

resultCode

string

响应码，0为正常

必需

resultDesc

string

响应描述

必需

timestamp

string

响应时间

必需

bizContent

string

必需

json字符串，具体内容见备注

示例

{
    "resultCode": "string",
    "resultDesc": "string",
    "timestamp": "string",
    "bizContent": "string"
}

应用场景#

接口信息#

请求bizContent参数#

OrderInfo#

TradeInfo#

Item#

响应bizContent参数#

请求参数

返回响应

应用场景

接口信息

请求bizContent参数

OrderInfo

TradeInfo

Item

响应bizContent参数