福禄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
        • 微信红包订单查询接口 fulu.order.info.getredpacket
  1. 业务场景

话费充值

话费充值简介#

稳定的话费充值渠道,为客户提供满意的话费充值体验

接口对接步骤#

image.png

1)对接商户API#

获取商户信息接口: fulu.user.info.get
获取进货商基本信息的接口,该接口可获得进货商在平台的余额情况。

2)对接手机号API#

手机号归属地查询接口: fulu.mobile.info.get
用于获取手机号归属地信息及可充值的面值的信息。

3)对接订单API#

话费下单接口: fulu.order.mobile.add *必须对接
该接口为异步接口;
下单成功不代表订单充值成功,要得到订单充值结果需要调用订单查询接口的order_state获得;
当仅知道充值手机号和充值面值时可通过该接口来充值话费;
当是充值三网通话费这种明确知道三网通话费商品编号时,则要调用直充下单接口 fulu.order.direct.add去充值三网通话费;
订单查询接口: fulu.order.info.get *必须对接
订单查询接口用于获得订单充值结果信息,是订单流程中必须对接的核心接口,通过order_state来获得订单的充值状态。
order_state=success是订单的充值结果的最终状态,分别表示充值成功。
order_state=failed是订单的充值结果的最终状态,分别表示充值失败。
order_state=processing是处理中状态,需要持续调用订单查询接口,直到获得订单最终状态为止。
order_state=untreated可以当处理中来处理。
订单扩展信息查询接口: fulu.order.extend.get
用于获得订单充值描述的订单信息查询的扩展接口。
对账单申请接口: fulu.order.record.get
用于获取订单对账单的申请接口,发起对账申请后,通过对账单单通知回调接口获得对账单数据。
订单充值结果回调: 回调说明
当订单有了最终充值结果后(即订单状态order_state=success或failed时),充值API就会给商户配置在商户控制台充值API应用里的订单回调地址发起订单充值结果回调通知。
售后退款状态回调: 回调说明
用于获得订单售后结果的回调通知接口。
对账单通知回调: 回调说明
用于获得订单对账单结果的回调通知接口。
上一页
在线直充
下一页
卡密采购
Built with