方式二：API采购

前往商户采购文档中心

1.对接前必读

2.订单对接API说明

名称	接口	是否必须	描述	接口地址
库存购买	/api/card/buy_card_stock	订单交易必须	库存购买	API地址
卡密求购	/api/card/want_buy_card	非必须	卡密求购	API地址
取消求购	/api/card/cancel_buying	非必须	取消求购	API地址
订单查询API	/api/card/order_detail	和回调必选二选一	订单查询API	API地址
上报订单结果	/api/card/order_deal	必须	上报订单结果	API地址
订单状态回调	对接方提供	和查单必选二选一	放在放单API提交参数callback_url 订单完结后会自动根据地址回调	API地址
余额查询	/api/merchant/account	可选对接	获取当前账户资金明细	API地址
商户流水查询	/api/card/merchant_flow	可选对接	商户流水查询(按天查询)	API地址

3.商品对接API说明

名称	接口	是否必须	描述	接口地址
卡种面值库存列表	/api/card/faceval_stock_list	可选对接	卡种面值库存列表	API地址

4.问题Q&A

Q1: 回调订单结果时，remark参数可以自定义吗？

不可以，必须按照系统提供的关键词进行回调，具体可在“上报订单结果”接口查询
例：【卡号/卡密错误】不能写【卡密错误】或者【卡号错误】系统无法识别

Q2: 出现我们没有定义的结果场景，可以自定义吗？？

不可以，如有新增的场景，请联系客服或者运营，后续由技术添加

Q3: 采购端的接口刷新频率是？

目前是5秒/次，请勿请求太频繁，否则会提示请求出错

Q4: 服务器响应回调通常是多久？

目前是3秒内响应

前往商户采购文档中心

修改于 2025-09-11 11:44:24