福禄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.goods.list.get
获取平台提供进货商的可售商品列表,该列表中的商品状态都为上架的、库存充足的。
获取商品信息接口: fulu.goods.info.get
获取平台提供进货商的可售商品信息,该商品的状态为上架的、库存充足的。
获取商品模板接口: fulu.goods.template.get
用于获取直充充值中的一些可选参数,比如:充值区、服、充值方式等信息。
商品库存校验接口: fulu.goods.stock.check
通过下单数量,查询该数量的商品库存情况;其库存情况结果只有两个:断货、充足。
商品信息变动回调: 回调说明
用于获得商品信息变更结果的回调通知接口。商品信息变更包括商品上下架状态和商品价格变更。

2)对接商户API#

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

3)对接订单API#

直充下单接口: 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