福禄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. 快速指引

商品模版指引说明

调用接口说明#

直充商品,游戏类商品需要调用商品模版;卡密商品无需调用商品模版。

接口对接步骤#

1)获取商品模版编号
通过商品编号,调用“获取商品信息接口”,获取商品模版编号。
2)获取商品模版信息
通过商品模版编号,调用“获取商品模版接口”,获取商品模版信息。
3)前端场景渲染处理
商品模版是json格式字符串,需要渲染到前端,用户充值时,由用户自行选择游戏区服、充值方式等信息。

商品模版信息#

参数名称字段类型是否必填描述
AddressIdstring是商品模板编号
ElementInfostring是元素信息
AddressNamestring是模板名称
IsServiceAreastring是是否有区服
GameTempaltePreviewListstring是游戏区服模板信息

前端场景渲染说明#

1)标准商品充值场景#

如果从商品模板接口中只获取充值账号和充值数量时,则不用传区服,充值方式等信息。
image.png

2)游戏商品充值场景#

如果从商品模板接口中获取区或服信息,则需将该信息渲染到前端页面,由终端用户自行选择游戏区服等信息。
image.png

3)少部分文娱商品充值场景#

如果从商品模板接口中获取的是充值方式时,则需将该信息渲染到前端页面,由终端用户自行选择充值方式(如:安卓端、iOS端、鸿蒙端)。
image.png
上一页
对接流程
下一页
测试环境模拟数据
Built with