发起收银

应用场景

生成支付链接,最福利将跳转至渠道收银台,进行支付。支付完成对方应该异步通知最福利

接口信息

URL	CashierURL(第三方提供)
Method	GET/POST x-www-form-urlencoded

OrderInfo

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

TradeInfo

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

Item

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

请求参数

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

userId

string

第三方用户 id

必需

merchantCode

string

必需

分配的商户 Code

sign

string

加签

必需

signType

string

必需

加签类型固定 MD5

示例值:

MD5

timestamp

string

请求时间

必需

charset

string

必需

字符类型固定 UTF8

nonce

string

必需

随机字符串,仅参与加签使用

amt

string

支付金额，单位元

必需

body

string

商品描述

可选

expireAt

string

支付失效时间

必需

notifyUrl

string

必需

支付成功异步回调地址

subject

string

支付提示

必需

orderInfo

string

可选

订单信息,最福利一个交易包含至少一笔订单,第三方可据此构造自己的订单记录,结构请参照orderInfo

orderTime

string

下单时间

可选

outTradeNo

string

必需

商户订单号,幂等去重字段

returnUrl

string

可选

支付完成自动跳转地址

backUrl

string

支付中返回商户地址

可选

orderUrl

string

订单详情地址

可选

extraInfo

string

可选

免密登录时，如果设置了ext,则会回传该参数信息

settleAmt

string

结算金额

可选

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

resultCode

string

响应码，0为正常

必需

resultDesc

string

响应描述

必需

timestamp

string

响应时间

必需

bizContent

string

必需

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

示例

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

应用场景#

接口信息#

OrderInfo#

TradeInfo#

Item#

请求参数

示例代码

返回响应

应用场景

接口信息

OrderInfo

TradeInfo

Item