商户采购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/buy_card_stock
最后修改时间:2025-04-23 02:46:54

请求参数

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
string 
购买的面值
必需
callback_url
string 
回调地址
必需
用于订单结束后,蜜蜂回调订单状态和信息给你,比如异常订单结束后
datas
array [object {2}] 
购买列表信息
必需
该参数不参与签名
discount
string 
购买折扣
必需
buy_num
integer 
购买数量
必需
示例
{
    "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 --location --request POST 'http://test.merchant.center.mf178.cn/api/card/buy_card_stock' \
--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_ids
array[string]
必需
批次id集合(zx_id)
示例
{
    "code": 0,
    "message": "购买成功,购买数量: 1张,扣费金额: 74.00元",
    "stime": 1745375874.87222,
    "etime": 1745375878.990569,
    "data": {
        "record_ids": [
            "1014285"
        ]
    }
}
修改于 2025-04-23 02:46:54
上一页
卡种面值库存列表
下一页
卡密求购
Built with