福禄API对接文档
业务场景
复制页面
产品介绍
快速指引
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)对接商品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应用里的订单回调地址发起订单充值结果回调通知。
售后退款状态回调
:
回调说明
用于获得订单售后结果的回调通知接口。
对账单通知回调
:
回调说明
用于获得订单对账单结果的回调通知接口。
上一页
免责声明
下一页
话费充值