福禄API对接文档
  1. 微信红包
  • 产品介绍
  • 快速指引
    • API应用操作说明
    • 对接流程
    • 商品模版指引说明
    • 测试环境模拟数据
    • 常见问题
  • 接口规范
    • 签名规则
    • 卡密解密说明
    • 返回码说明
    • 免责声明
  • 业务场景
    • 在线直充
    • 话费充值
    • 卡密采购
  • API列表
    • 商品API
      • 获取商品列表接口 fulu.goods.list.get
      • 获取商品信息接口 fulu.goods.info.get
      • 获取商品模板接口 fulu.goods.template.get
      • 商品库存校验接口 fulu.goods.stock.check
    • 订单API
      • 直充下单接口 fulu.order.direct.add
      • 卡密下单接口 fulu.order.card.add
      • 话费下单接口 fulu.order.mobile.add
      • 订单查询接口 fulu.order.info.get
      • 订单扩展信息查询接口 fulu.order.extend.get
    • 商户API
      • 获取商户信息接口 fulu.user.info.get
    • 其他API
      • 对账单申请接口 fulu.order.record.get
      • 手机号归属地查询接口 fulu.mobile.info.get
    • 回调通知
      • 订单充值结果回调
      • 售后退款状态回调
      • 商品信息变动回调
      • 对账单通知回调
      • 订单充值结果回调-在线调试
      • 售后退款状态回调-在线调试
      • 商品信息变动回调-在线调试
    • 特殊品类API
      • 微信红包
        • 订单充值结果回调
        • 微信红包直充下单接口 fulu.order.direct.addredpacket
          POST
        • 微信红包订单查询接口 fulu.order.info.getredpacket
          POST
  1. 微信红包

订单充值结果回调

平台对商户的业务请求处理完成后,会将处理的最终结果通过服务器主动通知至商户配置的“订单回调”地址,回调地址配置入口为:开放平台->充值API->应用配置->参数配置。
通知服务通过HTTP POST方式请求商户服务,请求格式(Content-Type)为application/json。
通知机制:最多通知3次,第一次立即执行,第二次在首次发送后间隔3分钟,第三次在第二次发送后间隔5分钟。
商户成功接受通知后请返回字符串:success,否则将按上述机制继续通知,直至通知机制完成。
签名方式:异步回调签名规则同其他接口签名方式一样,参考签名规则说明。详见接口规范->签名规则
注意:订单没有最终充值结果(order_status=success或failed),以及没有配置“订单回调”地址时,不会发起回调通知。
订单查询接口是必须要对接的接口。业务闭环中不能仅对接订单回调接口来获得订单最终充值结果。
请求参数
参数类型是否必填示例值描述
order_idstring是P26033155353051423福禄订单号
charge_finish_timestring是2019-12-30 14:23:09交易完成时间,格式为:yyyy-MM-dd HH:mm:ss
customer_order_nostring是20191230142306472外部订单号
order_statusstring是success订单状态: (success:成功,failed:失败)
recharge_descriptionstring是1106监控异常充值描述
product_idstring是10000585商品编号
pricestring是1.0300交易单价,单位:元
buy_numstring是100001905购买数量
operator_serial_numberstring是运营商流水号
signstring是a6697125a07a24c33f074cff253d432f签名
请求示例
{
    "order_id":"19123033155353051423",
    "charge_finish_time":"2019-12-30 14:23:09",
    "customer_order_no":"20191230142306472",
    "order_status":"failed",
    "recharge_description":"#1104 充值游戏(区服)异常",
    "product_id":"10000585",
    "price":"1.0300",
    "buy_num":"1",
    "sign":"a6697125a07a24c33f074cff253d432f"
}
签名示例
签名串:
""""""""""""""""""""""""""""""""""#,,,,,,,,--.000000000000000011111111111111122222222233333333333444445555556789999:::::::::::___________aaaaaabbccccccddddddddeeeeeeeeeeeeeeffgghhhiiiiiiiiiillllmmmmnnnnnnooooooooopppprrrrrrrrrrrrrrrrrsssssstttttttuuuuuuuy{}值充区常异戏服游()0a091b3aa4324435aab703142518a8f7
经过MD5后:
a6697125a07a24c33f074cff253d432f
回调成功说明
商户成功接受通知后请返回字符串:success,否则继续通知,直至通知机制完成。
上一页
商品信息变动回调-在线调试
下一页
微信红包直充下单接口 fulu.order.direct.addredpacket
Built with