聚合支付支付接口
聚合支付丨支付接口
1、支付接口说明
用户在商户页面进行支付时，选择微信或支付宝扫码或者商户反扫等支付。
2、请求地址
请求URL：/api/unified/payment
请求方式：POST
请求接口名称：unifiedPayment
3、输入参数
|
字段名 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
|---|---|---|---|---|---|
|
支付方式 |
defrayalType |
是 |
String(20) |
WECHAT_SCAN |
支付方式请参考公共参数-支付方式 |
|
商户号 |
subMerchantNumber |
是 |
String(50) |
API0100001102000001 |
与请求报文头的商户号一致 |
|
通道标识 |
channelMapped |
是 |
String(50) |
BO_HAI |
商户自行指定要支付的通道-商户后台可见 |
|
商户订单号 |
merchantOrderNumber |
是 |
String(50) |
DsorderiD2018010100 |
商户请求支付的订单号，唯一 |
|
结算周期 |
tradeCheckCycle |
是 |
String(10) |
T1 |
T1,D0 暂时只支持T1 |
|
订单时间 |
orderTime |
是 |
String(20) |
20180101100000 |
yyyyMMddHHmmss |
|
币种 |
currenciesType |
是 |
String(10) |
CNY |
CNY-人民币，默认为CNY |
|
交易金额 |
tradeAmount |
是 |
String(20) |
1000 |
以分为单位，10.00元填入值为1000 |
|
商品信息 |
commodityBody |
是 |
String(200) |
衣服 |
商品信息 |
|
商品详情 |
commodityDetail |
是 |
String(255) |
防寒大衣 |
商品详情 |
|
商品备注 |
commodityRemark |
否 |
String(200) |
很实用的防寒大衣 |
商品的详细备注 |
|
同步通知地址 |
returnUrl |
否 |
String(150) |
同步通知到商户指定的地址(https://www.shbapi.com/) |
视具体的通道是否支持而定,拼接状态字段为 payStatus=XXX 成功:ok 失败:fail 取消:cancel |
|
异步通知地址 |
notifyUrl |
是 |
String(150) |
商户平台指定的异步通知地址 |
商户接收速汇宝异步通知的地址 |
|
设备ID |
terminalId |
否 |
String(50) |
10001 |
付款设备的ID编号 |
|
设备IP |
terminalIP |
是 |
String(50) |
127.0.0.1 |
付款设备或发起请求的服务的IP地址 |
|
用户标识 |
userId |
否 |
String(50) |
|
当支付方式为反扫时为付款码； |
|
备注 |
remark |
否 |
String(50) |
交易备注 |
交易备注信息 |
|
附加信息 |
attach |
否 |
String(50) |
附加信息 |
商户可自行设置附加信息，订单查询会原值返回 |
4、返回结果
|
字段名 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
|---|---|---|---|---|---|
|
速汇宝订单号 |
shbOrderNumber |
是 |
String(50) |
API01180119205845001 |
速汇宝平台交易订单号 |
|
返回内容 |
content |
是 |
String(50) |
|
NATIVE和JSAPI为付款链接 |
|
订单状态 |
orderStatus |
是 |
String(50) |
WAIT |
WAIT:下单成功,等待支付 |
