商户采购API接口文档
  1. 卡密卡券-采购文档
商户采购API接口文档
  • 开发指南
    • 对接环境介绍
    • 接口签名介绍
    • API接口调试
    • 常见问题
  • 接口文档
    • 话费|油卡|权益|代充|流量-采购文档
      • 新商品ID模式
        • 放单API
        • 查询商品列表API
        • 修改商品自主报价
        • 商品自定义放单超时时间设置
      • 旧产品模式API
        • 旧产品模式-放单API
        • 查询商品列表API
        • 修改商品自主报价
      • 商品价格变更通知
        • 商品价格变更订阅取消
        • 商品价格变更订阅
        • 商品价格变更推送
      • 代充充值-采购文档
        • 代充放单API
        • 解除充值号码/卡密黑名单API
      • 资金查询API
      • 订单结果状态回调API
      • 订单做单日志
      • 订单状态查询API
      • 订单状态列表批量查询API
    • 携号转网/空号检测API
      • 提交查询订单API
    • 卡密卡券-采购文档
      • 卡种面值库存列表
        POST
      • 库存购买
        POST
      • 卡密求购
        POST
      • 取消求购
        POST
      • 订单查询API
        POST
      • 上报订单结果
        POST
      • 订单状态回调API
        POST
      • 商户余额查询
        POST
      • 商户流水查询(按天查询)
        POST
    • 电影票-采购文档
      • 城市列表
      • 地区列表
      • 影院列表
      • 影院排期列表
      • 座位图
      • 座位图 Copy
  1. 卡密卡券-采购文档

卡密求购

POST
http://test.merchant.center.mf178.cn/api/card/want_buy_card
最后修改时间:2025-04-23 02:53:13

请求参数

Body 参数application/json
app_key
string 
【公共参数】系统分配给商户的秘钥
必需
sign
string 
【公共参数】签名
必需
所有请求参数签名
timestamp
string 
【公共参数】Unix时间戳
必需
时区为 GMT+8 允许与服务器最大误差30秒
goods_sku
string 
卡种SkU
必需
卡种sku,当前SKU列表:http://card.task.mf178.cn/goods/goods/index
face_val
integer 
求购的面值
必需
total_num
integer 
求购数量
必需
discount
string 
求购折扣
必需
cancel_type
integer 
自动取消求购类型,1不自动取消,2指定时间取消
必需
buy_cancel_time
integer 
指定时间自动取消求购时间戳(单位:秒) ,当cancel_type为2时必传
可选
want_buy_time
string 
指定接收卡密库存通知时间段,如:06:00-22:00,表示在(早上6点到晚上22点)这个时间段,有卡密库存会微信通知,不传则默认全天24小时有库存都会通知
可选
示例
{
    "app_key": "",
    "timestamp": "",
    "sign": "",
    "goods_sku": "SK000117",
    "face_val": 1,
    "callback_url": "www.mf178.com",
    "datas": [
        {
            "buy_num": 1,
            "discount": "950"
        }
    ]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'http://test.merchant.center.mf178.cn/api/card/want_buy_card' \
--header 'Content-Type: application/json' \
--data-raw '{
    "app_key": "",
    "timestamp": "",
    "sign": "",
    "goods_sku": "SK000117",
    "face_val": 1,
    "callback_url": "www.mf178.com",
    "datas": [
        {
            "buy_num": 1,
            "discount": "950"
        }
    ]
}'

返回响应

🟢200成功
application/json
Body
code
integer 
必需
message
string 
必需
stime
number 
必需
etime
number 
必需
data
object 
必需
record_id
string 
求购批次id(zx_id)
必需
示例
{
    "code": 400,
    "message": "取消求购时间必须大于当前时间",
    "stime": 1745376523.41079,
    "etime": 1745376524.008933,
    "data": []
}
修改于 2025-04-23 02:53:13
上一页
库存购买
下一页
取消求购
Built with