福禄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
    • 回调通知
      • 订单充值结果回调
      • 售后退款状态回调
      • 商品信息变动回调
      • 对账单通知回调
      • 订单充值结果回调-在线调试
        POST
      • 售后退款状态回调-在线调试
        POST
      • 商品信息变动回调-在线调试
        POST
    • 特殊品类API
      • 微信红包
        • 订单充值结果回调
        • 微信红包直充下单接口 fulu.order.direct.addredpacket
        • 微信红包订单查询接口 fulu.order.info.getredpacket
  1. 回调通知

对账单通知回调

平台对商户的售后订单处理/退款完成后,会将处理的最终结果通过服务器主动通知至商户提供的“对账单回调”地址。
通知服务通过HTTP POST方式请求商户服务,请求格式(Content-Type)为application/json。
通知机制:最多通知3次,第一次立即执行,第二次在首次发送后间隔3分钟,第三次在第二次发送后间隔5分钟。
签名方式:异步回调签名规则同其他接口签名方式一样,参考签名规则说明。详见接口规范->签名规则
注意:对于对账时间跨度较大的对账需要,处理时间会较长,请耐心等待,不要重复创建新的对账单请求。sftp账号、密码请妥善保存。
请求参数
参数类型是否必填示例值描述
order_record_get_nostring是AC072426795315681645对账单获取单号
topicstring是2019年12月份对账单对账的主题
file_urlstring是https://xxx.xxx.com对账单文件地址
file_md5string是对账单文件md5值
sftp_server_hoststring否sftp服务器地址
sftp_usernamestring否sftp用户名
sftp_passwordstring否sftp密码
signstring是1c94f99a4f468771a4451984a3011e58签名
Excel对账单示例
请求示例
{
	"order_record_get_no": "AC072426795315681645",
	"topic": "2019年12月份对账单",
	"file_url": "https://bigdata-odps.oss-cn-hangzhou.aliyuncs.com/test_20200415.zip?OSSAccessKeyId=LTAIADq1AkuqereH&Expires=1587646811&Signature=G2oQxcxTj76ePnzu9pYTpWNDKE0%3D",
	"file_md5": null,
	"sftp_server_host": "",
	"sftp_username": "",
	"sftp_password": "",
	"sign": "1c94f99a4f468771a4451984a3011e58"
}
签名示例
签名串:
""""""""""""""""""""""""""%&&,,,,,,---....///00000011111111122222223344445555556666667777888999::::::::===?AAAAACDDDEEGHIIKKLNOPQSSSTTTWY__________aaaaaaabccccccccdddddddeeeeeeeeeeeeeeeeefffffgggghhhhiiiiiiiijkllllllmmmnnnnnnnnooooooooooopppppppppppqqrrrrrrrrrrrrsssssssssssssssssttttttttttttuuuuuuuuvwxxxyyzzz{}份单对年月账0a091b3aa4324435aab703142518a8f7
经过MD5后:
1c94f99a4f468771a4451984a3011e58
Sftp对账单示例
请求示例
{
	"order_record_get_no": "AC072426795315681649",
	"topic": "2019年12月份对账单",
	"file_url": "upload/20200423_183502112.txt",
	"file_md5": "27fb3b16a8a211f7917cfdeb2f5b1df9",
	"sftp_server_host": "47.114.44.100:16550",
	"sftp_username": "a9000358",
	"sftp_password": "569a96cb-c38b-4ebe-9755-2e7d1a32fc58",
	"sign": "b641ace5e39333416a72d72708e430f8"
}
签名示例
签名串:
"""""""""""""""""""""""""""",,,,,,----..../0000000000001111111111111111122222222222222333333344444444555555555555666666677777777888888999999999::::::::AC__________aaaaaaaabbbbbbbccccccddddddddeeeeeeeeeeeeefffffffffffghiiillllmmnnooooooopppppprrrrrrrrrssssssssttttttttuuuvwx{}份单对年月账0a091b3aa4324435aab703142518a8f7
经过MD5后:
b641ace5e39333416a72d72708e430f8
回调成功说明
商户成功接受通知后请返回字符串:success,否则继续通知,直至通知机制完成。
上一页
商品信息变动回调
下一页
订单充值结果回调-在线调试
Built with