飞鱼数字接口对接
**飞鱼数字接口下单**
下单商品分为直充类(话费、石油卡充值等)和卡密类(美团优惠券等),商户不需要区分,下单根据不同商品和规格参数区分,下单接口接收POST请求。
**1、直充类**
直充类商品下单结果根据下单接口同步返回结果集中code字段判断,code状态为受理成功(状态码参考附录编码表)仅表示飞鱼受理成功,具体充值结果以回调形式通知商户(回调地址在下单接口参数传入,不传默认不通知),同步返回其他状态为受理失败,相关失败原因参考接口返回错误信息参考msg字段。
**2、卡密类**
卡密类下单成功直接返回卡密及卡号等信息,失败同步返回错误信息。
**关于直充类回调通知**
直充类下单充值到账后会以POST请求回调通知商户回调接收地址,商户返回字符串"success"表示接受回调成功,其他为失败,成功后不再继续回调,失败后飞鱼间隔2、4、8分钟再次调用商户回调地址通知下单结果,任何一次通知成功后飞鱼不再继续回调商户,如果四次通知都失败该订单结果不再通知商户。
**接口数据交互格式**
application/x-www-form-urlencoded
**测试商户账号**
appKey=GKLVFVFX
secretKey=734b6fb71d424a25bd9985caccbf4958
**测试商品及规格**
直充类测试商品及规格:测试商品-17,测试规格-1
卡密类测试商品及规格:测试商品-40,测试规格-test
**注意:测试账号只开通上面商品及规格方便测试下单使用,其他自定义商品规格参数测试下单均返回失败。**
**签名规格**
HTTP参数的签名规则为:
(1)将请求参数名按字符升序排序,包括secretKey
(2)拼接参数值(不需要连接参数名),得到待签名数据
(3)使用MD5(32位)算法对待签名数据产生签名数据
(4)签名数据字符串转为小写
注意:传数据前请secretKey字段去掉再传给接口。
**例如有以下参数信息**
out_trade_id=111
account=222
appKey=GKLVFVFX
secretKey=734b6fb71d424a25bd9985caccbf4958
timestamp=1503547614
拼装得到字符串:222GKLVFVFX111734b6fb71d424a25bd9985caccbf49581503547614
对该字符串进行MD5(32位)加密运算,再将所得字符串转换为小写,作为sign 参数值。
**直充回调验签规则**
(1)参与验签字段
out_trade_id
orderStatus
order_number
price
customerA
customerB
secretkey
(2)将请求参数名按字符升序排序,拼接参数值(不需要连接参数名),得到待签名数据
(3)使用MD5(32位)算法对待签名数据产生签名数据并转小写,签名为sign字段回传。