福禄API对接文档
  1. 商品API
  • 产品介绍
  • 快速指引
    • API应用操作说明
    • 对接流程
    • 商品模版指引说明
    • 测试环境模拟数据
    • 常见问题
  • 接口规范
    • 签名规则
    • 卡密解密说明
    • 返回码说明
    • 免责声明
  • 业务场景
    • 在线直充
    • 话费充值
    • 卡密采购
  • API列表
    • 商品API
      • 获取商品列表接口 fulu.goods.list.get
        POST
      • 获取商品信息接口 fulu.goods.info.get
        POST
      • 获取商品模板接口 fulu.goods.template.get
        POST
      • 商品库存校验接口 fulu.goods.stock.check
        POST
    • 订单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.template.get

POST
https://it-fulu-mall-api-interface-api.suuyuu.cn/api/getway
1、直充商品,游戏类商品需要调用商品模版;卡密商品无需调用商品模板;
2、获取商品模板信息(请求参数template_id,通过商品列表或商品信息接口获得);
3、商品模板接口对接步骤:
3.1、通过商品编号,调用“获取商品信息接口”,获取商品模板编号;
3.2、通过商品模板编号,调用“获取商品模板接口”,获取商品模板信息;
3.3、商品模板是json格式字符串,需要渲染到前端,用户充值时,由用户自行选择游戏区服、充值方式等信息;
详见快速指引->商品模版指引说明

请求地址#

环境HTTP地址HTTPS地址(需您的服务端支持TLS1.2及以上)
测试环境http://it-fulu-mall-api-interface-api.suuyuu.cn/api/getwayhttps://it-fulu-mall-api-interface-api.suuyuu.cn/api/getway
正式环境http://fulu-mall-api-interface-api.fulu.com/api/getwayhttps://fulu-mall-api-interface-api.fulu.com/api/getway

请求参数

Body 参数application/json

示例
{
    "method": "fulu.goods.template.get",
    "app_key": "475EFB41E47E684AFC7A8670021C0AA9",
    "timestamp": "2026-02-05 10:10:28",
    "version": "2.0",
    "format": "json",
    "charset": "utf-8",
    "sign_type": "md5",
    "app_auth_token": "",
    "biz_content": "{\"template_id\":\"100032\"}",
    "sign": "c343195b43f18f9dd07b6da4c0202eda"
}

请求示例代码

HTTP
C#
Java
Python
Go
PHP
请求示例请求示例
HTTP
C#
Java
Python
POST /api/getway HTTP/1.1
Host: it-fulu-mall-api-interface-api.suuyuu.cn
Content-Type: application/json
Content-Length: 362

{
    "method": "fulu.goods.template.get",
    "app_key": "475EFB41E47E684AFC7A8670021C0AA9",
    "timestamp": "2026-02-05 10:10:28",
    "version": "2.0",
    "format": "json",
    "charset": "utf-8",
    "sign_type": "md5",
    "app_auth_token": "",
    "biz_content": "{\"template_id\":\"100032\"}",
    "sign": "c343195b43f18f9dd07b6da4c0202eda"
}

返回响应

🟢200成功
application/json
返回码,详见接口规范->返回码说明
响应结果result详解
{
	"AddressId": "100032", //模板编号
	"AddressName": "充值账号数量-API对接专用", //模板名称
	"IsServiceArea": true, //是否有区服,预留字段
	"ElementInfo": { //包含元素,一般用于前端充值账号和充值数量html组件绑定显示的内容
		"Inputs": [{ //充值账号元素,一般指充值账号
			"Type": "Input", //元素类型,代表输入框,目前只有Input类型
			"Id": "ChargeAccount", //属性名称:ChargeAccount
			"Name": "充值账户", //标识名称,一般放在充值账号输入框前或输入框内做提示使用
			"SortId": 0//排序值
		}],
		"ChargeNum": { //充值数量元素
			"Id": "ChargeNum", //属性名称:ChargeNum
			"Name": "选择充值数量", //标识名称
			"Value": "1-1000", //充值数量取值,一般会有三种模式:1:区间【1-1000】,2:分段【1|2|5|10|50|100|500】,3:综合,前两种模板的组合模式【1-10|20|30|50】
			"Unit": { //单位(非必填),一般只做显示;例如:在某些游戏中有金币这样的虚拟币
				"DefalutUnit": null, //换算前的单位,比如:100金币
				"DefalutUnitAfter": null, //换算后的单位,比如:1元
				"DefalutUnitRatio": 0.0 //换算比例  换算前的单位除以换算后的单位得来的: 100
			},
			"Type": "Input", //元素类型
            "SortId": 99
		}
	},
	"GameTempaltePreviewList": [{ //游戏商品模板区服列表
		"ChargeGame": "英雄无敌在线", //第一个游戏名称
		"GameList": {
			"ChargeRegion": [{ //区
				"Name": "经典大区-电信", //区名称
				"Code": null, //编码,不用考虑
				"ChargeServer": [{ //服
					"Code": null,
					"Name": "翡翠丘陵", //服名称
					"ChargeType": []
				}, {
					"Code": null,
					"Name": "霜冻平原", //服名称
					"ChargeType": []
				}, {
					"code": null,
					"name": "王者归来", //服名称
					"ChargeType": []
				}],
				"ChargeType": [] //充值方式
			}, {
				"Name": "经典大区-网通", //区名称
				"Code": null,
				"ChargeServer": [{ //服
					"Code": null,
					"Name": "德尔干河", //服名称
					"ChargeType": []
				}],
				"ChargeType": [] //充值方式
			}],
			"ChargeServer": [],
			"ChargeType": [{
				"Code": null,
				"Name": "QQ钱包"
			}, {
				"Code": null,
				"Name": "Q币"
			}, {
				"Code": null,
				"Name": "银行卡"
			}]
		}
	}, {
		"ChargeGame": "魔域掉钱版神石卡", //第二个游戏名称
		"GameList": {
			"ChargeRegion": [{ //区
				"Name": "掉钱版第一大区", //区名称
				"Code": null,
				"ChargeServer": [{ //服
					"Code": null,
					"Name": "掉钱一区电信", //服名称
					"ChargeType": []
				}, {
					"Code": null,
					"Name": "掉钱二区电信", //服名称
					"ChargeType": []
				}, {
					"Code": null,
					"Name": "掉钱十区电信", //服名称
					"ChargeType": []
				}],
				"ChargeType": [] //充值方式
			}],
			"ChargeServer": [], //服
			"ChargeType": [] //充值方式
		}
	}]
}
Bodyapplication/json

示例
{
    "code": 0,
    "message": "接口调用成功",
    "result": "{\"AddressId\":\"100032\",\"AddressName\":\"充值账号数量-API对接专用\",\"ElementInfo\":{\"Inputs\":[{\"Type\":\"Input\",\"Id\":\"ChargeAccount\",\"Name\":\"充值账号\",\"SortId\":0}],\"ChargeNum\":{\"Id\":\"ChargeNum\",\"Name\":\"选择充值数量\",\"Value\":\"1-999999\",\"Unit\":null,\"Type\":\"Input\",\"SortId\":99}},\"IsServiceArea\":false,\"GameTempaltePreviewList\":[]}",
    "sign": "8c1a069696c168f3ff8ad6b3f1bc5279"
}
上一页
获取商品信息接口 fulu.goods.info.get
下一页
商品库存校验接口 fulu.goods.stock.check
Built with