飞鱼数字接口对接

**飞鱼数字接口下单** 下单商品分为直充类(话费、石油卡充值等)和卡密类(美团优惠券等),商户不需要区分,下单根据不同商品和规格参数区分,下单接口接收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字段回传。