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

放单API

POST
/api/merchant/upload_order
当前所有新业务 均按 新商品ID模式接入

状态编码说明#

错误码 (错误以错误码为主,同一错误码有不同的错误原因,方便跟踪问题)#

错误码接口错误描述处理结果
0所有成功订单推送成功
10001所有参数错误接口访问失败
10002所有签名错误接口访问失败
10003所有时间戳超期接口访问失败
10004所有商户不存在接口访问失败
10005所有商户被禁用接口访问失败
10006所有商户请求IP错误接口访问失败
10010所有第三方订单号已存在不用处理,查单获取结果
10011所有账户余额不足接口访问失败
10012所有渠道不可用或无资源 业务配置异常接口访问失败
10013所有充值故障,请稍后再试接口访问失败
10014所有充值号码有问题(号码格式错误、空号或已拉黑)处理失败
10015所有订单不存在一分钟后查单不存在,则处理失败
10016所有请求太频繁,请稍后重试接口访问失败

订单状态说明:#

state状态名备注处理结果
1待处理未进行充值处理中
11待账号验证未进行充值处理中
12账号验证中未进行充值处理中
2处理中开始进行充值处理中
3充值成功充值结果处理成功
4充值失败充值结果处理失败
41充值结果未知充值结果未知人工核实
6失败已退款充值结果处理失败
当state=4或6时 充值失败会返回 error_code
error_code说明
1充值号码问题
2卡号卡密问题
3未进行充值
4其他问题

请求参数

Header 参数

Body 参数application/json

示例
{
    "app_key": "",
    "timestamp":  "",
    "sign":"",
    "miniunit_id ":"10001",
    "third_id":"223221352193323",
    "call_back_url":"http:xxx.xxx.com",
    "datas":{
        "target": "13760471262",
        "amount": "100"
    } 
}

请求示例代码

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/merchant/upload_order' \
--header 'AppKey;' \
--header 'AppSecret;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "app_key": "",
    "timestamp":  "",
    "sign":"",
    "miniunit_id ":"10001",
    "third_id":"223221352193323",
    "call_back_url":"http:xxx.xxx.com",
    "datas":{
        "target": "13760471262",
        "amount": "100"
    } 
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": 0,
    "message": "ok",
    "stime": 1698980245.05146,
    "etime": 1698980245.37863,
    "data": {
        "third_id": "1698980245394604",
        "order_id": "23110100762323",
        "target": "1376047xxxx",
        "state": 1,
    }
}
修改于 2025-05-29 07:43:54
上一页
常见问题
下一页
查询商品列表API
Built with