新增收款单(强鉴权)
POST
/order-aggregation/fund/receipt-bill资金修改安全性要求高,为保护资金数据安全,防止请求数据被篡改,增加数据验签逻辑和请求时效性判断
验签逻辑:
将参与验签的字段key=value,按字典升序排序用 '&'拼接,最后拼接加密&_key_
=salt,然后计算MD5作为参数传递,服务接收到请求后,用相同的逻辑计算MD5,然后匹配是否相等,
例如拼接后:exemptAmount=0&nonce=123&otherOrgId=1772779383262880&otherOrgType=CUSTOMER&paymentMethodCode=3&realTradeAmount=10×tamp=1703154485&tradeMoney=10&tradeTime=1702990018000&_key_
=xxx
计算MD5:e405e585821989c8bae19e81110d0fb5
注意:
- 加密的盐salt由易订货颁发
- 参与验签的字段在接口里面有标记
请求参数
Query 参数
sign
string
必需
数据签名校验,签名请看文档说明
nonce
string
必需
签名随机串(参与加密),请勿重复,用于防重放
timestamp
integer
必需
签名时间戳(秒),同时用于请求超时校验,120s内有效(参与加密)
Body 参数application/json
attachments
array [object]
附件
exemptAmount
number
可选
优惠金额(参与加密)
otherOrgId
integer <int64>
必需
交易对手机构ID(往来单位机构id)(参与加密)
otherOrgType
enum<string>
必需
交易对手机构类型(总部:HEADQUARTER,分公司:BRANCH,门店:STORE,客户:CUSTOMER,供应商:SUPPLIER)(参与加密)
枚举值:
BRANCHCUSTOMERHEADQUARTERMERCHANTSTORESUPPLIERVOID
paymentMethodCode
string
必需
支付方式,1:现金(参与加密)
realTradeAmount
number
必需
实收金额(参与加密)
>= 0.01<= 100000000
remark
string
备注
tradeMoney
number
必需
交易金额(收款单金额) = exemptAmount + realTradeAmount(参与加密)
>= 0.01<= 100000000
tradeTime
string <date-time>
必需
交易时间(时间戳ms),允许往前15天,往后15天范围(参与加密)
示例
{
"attachments": [
{}
],
"exemptAmount": 0,
"otherOrgId": 0,
"otherOrgType": "BRANCH",
"paymentMethodCode": "string",
"realTradeAmount": 0.01,
"remark": "string",
"tradeMoney": 0.01,
"tradeTime": "2019-08-24T14:15:22.123Z"
}
返回响应
OK(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
object {0}
示例
未设置
最后修改时间: 1 年前