帮助中心
进入EZR

3.驿氪发起金额扣减申请（ezr向第三方系统发起金额扣减申请）

2017-06-06

接口说明：

驿氪发起积分扣减申请

API接口请求加签算法(提交和返回都使用同一套加密)：

  1. 将AppId、Timestamp、Token(客户端保存),OldCode,RequestTradeNo,RequestTradeName,RelationCode,Money，ShopCode，RequestTime 按照参数名在英文字典中的顺序排序，然后重新拼成一个标准的query string。

  2. 将上一步得到的query string，按照UTF-8格式转换成字节数组。

  3. 以SHA1算法，对query string字节数组计算出一个签名字节数组。

  4. 将签名字节数组，转换为十六进制的字符串。将最后得到的字符串作为请求的sign参数，将sign字段与其他参数一同放在请求中发送给服务。

例如：

  1. 将得到的AppId和Token以及时间戳拼接成QueryString串（注意大小写）：AppId=EZP&Money=1&OldCode=E00001&RelationCode=X001&RequestTime=2015-1-1&RequestTradeName=aaa&RequestTradeNo=SX10000&Timestamp=20150701093010&ShopCode=001&Token=ezpToken123 

  2. 做SHA1结果为：90111CE7806F7464F490E45C8A07D7302CFF78DE

  3. 将SHA1结果作为Sign的请求一并提交。

请求说明：

使用浏览器跳转进行调用 （GET）

请求路径：客户提供跳转地址

请求参数：


字段类型为空长度描述
AppIdstring否1~16客户appid

Timestamp

string否

请求时间戳（yyyyMMddHHmmss格式）

服务端会判断请求过期，过期限制为三分钟内


Signstring否1~20

请求签名，详见签名算法

OldCodestring否
客户卡号
ShopCodestring是1^20消费门店
RequestTimestring否
兑换时间（yyyy-MM-dd HH:mm:ss格式）
RequestTradeNostring否
请求交易流水号
RequestTradeNamestring否1~50请求交易物品名称
Moneydecimal否
请求交易金额
RelationCodestring否1^20关联订单号
CardNostring否1^20储值卡号

请求参数示例代码（跳转地址携带）：

 AppId=EZP&Money=1&OldCode=E00001&RelationCode=X001&RequestTime=2015-1-1&RequestTradeName=aaa&RequestTradeNo=SX10000&Timestamp=20150701093010&ShopCode=001&Sign=07A2086661C4092F703D758193D6F76CDCC9CF64


当接到调整成功处理后，页面跳转（4.充值卡金额扣减结果异步回掉（第三放系统异步（同步跳转）上传 扣减结果）  IsPage=true）：（如扣减成功 ：同时异步回调 ”4.充值卡金额扣减结果异步回掉（第三放系统异步（同步跳转）上传 扣减结果）“ IsPage=false）


2046