1. 用户下发接口
业务描述:用户A再商户B请求提现,商户B调用本接口,接口返回相关信息。收到请求后后台会回调callBackUrl。业务成功后,商户B钱包币减少,扣除amount数量币,扣除手续费;用户A钱包增加amount数量币
`接口地址:{host}/api/v2/merch/user/down `请求方式:GET/POST表单
| 字段 | 类型 | 名称 | 说明 |
|---|---|---|---|
| merchId | Integer | 商户ID | |
| body | String | 加密参数 | 详见表六 |
| t | Integer | 当前时间戳 | |
| key | String | 签名 | Md5(merchId+body+t+md5key) |
参数: 表六:
| 字段 | 类型 | 名称 | 说明 |
|---|---|---|---|
| merchOrderId | String | 商户下发单号 | |
| amount | Integer | 下发金额 | |
| username | String | 用户真实姓名 | 非必要,传入值会验证用户实名,不匹配则打回请求 |
| callBackUrl | String | 商户自定义回调接口 | 详见用户下发单结果通知 |
| userWalletAddress | String | 用户钱包地址 | |
| remark | String | 备注 | 非必要 |
| currency | String | 货币的KEY | 非必要,商户会有默认的货币,正常为CNY |
| merchUserId | String | 商户的用户ID | 商户的用户ID(唯一值) |
| title | String | 支付标题 | 支付的标题 |
| idNumber | String | 身份证号 | 非必要,传入值会验证用户身份证号,不匹配则打回请求 |
| phoneNumber | String | 电话号码 | 非必要,传入值会验证用户电话号码,不匹配则打回请求(注意需要加国家code 如:8613145202569) |
body生成规则:
`1. base64Decode 公钥 `2. 将表六中参数转为 jsonString
3. 用公钥将jsonString 进行RSA加密(ECB模式,OAEP SHA256对⻬,MGF1填充 )
4. 加密结果base64 Encode即为字符串body
接口响应结果:
| 字段 | 类型 | 名称 | 说明 |
|---|---|---|---|
| code | Integer | 状态码 | 0为请求正常,详见附表 |
| message | String | 消息 | |
| data | 返回内容 | {status:””,id:”下发单订单号”} |
status 订单状态:
`“finish”:订单交易完成 `“pending”:订单进行中