增值服务接口
功能概述
本接口用于商户展示增值服务内容,商户根据服务编码选择需要展示的服务内容。
接口地址
https://webox-api.5upay.com/webox/valueAdded/create
| 参数名称 |
参数中文名称 |
类型& 长度 |
参数说明 |
是否必填 |
| merchantId |
商户编号 |
varchar(9) |
商户在首信易系统的唯一 id,可在商户后台查看 |
M |
| requestId |
订单号 |
varchar(50) |
提交的订单号必须在账户交易中唯一;首信易数据支付系统中对于已创建的订单,商户端不能重复提交。 |
M |
| walletId |
钱包 ID |
varchar(19) |
用户钱包在我司的唯一编号 |
M |
| itemCode |
服务编码 |
固定值 |
锦鲤财富 KOI_FINANCIAL |
M |
|
视听卡 OFPAY_MALL
|
| hmac |
参数签名 |
varchar(500) |
商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 |
M |
参数示例
{
"merchantId": "890000595",
"requestId": "202002251582614048062",
"walletId ":"1233345",
"itemCode":"KOI_FINANCIAL",
"hmac": null
}
同步返回参数列表
| 参数名称 |
参数中文名称 |
参数说明 |
| status |
响应状态 |
SUCCESS 响应正常
|
| FAIL 响应异常 |
| createStatus |
生成状态 |
SUCCESS |
| merchantId |
商户编号 |
同请求参数 |
| walletId |
钱包 ID |
同请求参数 |
| requestId |
订单号 |
同请求参数 |
| token |
票据 |
通过此参数调起移动端 SDK(仅可使用一次) |
| createDateTime |
创建时间 |
格式:yyyy-MM-dd HH:mm:ss |
| hmac |
参数签名 |
商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 |
参数示例
{
"status":"SUCCESS",
"createStatus":"SUCCESS",
"merchantId":"890000595",
"requestId":"202002251582614048062",
"token":"20191022221481371367938298683392",
"walletId":"11111111"
"createDateTime":"2019-10-22 18:43:36",
"hmac":"NJ6mmeVuilTlmWC2ps8vFkxJPqyehltp3h92LPutr0PuE+vdt32o7AOqHFozN7I8
3KI5y+CoQy1XE8w3d+xEmClPMwhviIZYRcDUoq4IFI7LjHGtUHpISwDx4/21mjTMyDc6q
ISC+6PBBW6iqbGTcv0XZTGRxULhtkxrJ4qk/FlHGwP/5mwKyqOapWHS1nbufHkf5fhR8
BviurnNQHPwhIUXJpbieJGRS+aDvw/zIfG49MhHKESbttHhgGaZmResmxyWUlrDCrYY8
xYnBKhn7Z/ohR2IRz7U8yO8oRQbSj6FU5GOMknFXhbDSIR/FK05TnioDuc5mNTk0Vvs
oSsmmg==",
}