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

放单API

POST
http://test.merchant.center.mf178.cn/api/merchant/upload_order
最后修改时间：2025-05-29 07:43:54
当前所有新业务 均按 新商品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 参数
AppKey
string 
可选
AppSecret
string 
可选
Body 参数application/json
app_key
string 
【公共参数】系统分配给商户的秘钥
必需
timestamp
integer 
【公共参数】Unix时间戳
必需
时区为 GMT+8 允许与服务器最大误差30秒
sign
string 
【公共参数】签名
必需
所有请求参数签名
miniunit_id 
string 
商品ID
必需
仅限产品化业务的商品使用此方式下单,
third_id
string 
商家侧订单ID
必需
call_back_url
string 
回调地址
必需
（如不填则使用商户后台配置的地址）外网可访问
datas
数据包
必需
Any of
当对接业务为话费
target
string 
充值账号
必需
operator_id
string 
运营商
可选
prov_code
string 
省份
可选
示例
{
    "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
integer 
请求结果
必需
0为成功，其他为错误，详见错误码
message
string 
错误信息
必需
stime
number 
必需
etime
number 
必需
data
object 
必需
third_id
string 
平台充值订单号
必需
order_id
string 
商家侧订单ID
必需
target
string 
需要充值的号码（手机号/油卡号）
必需
state
integer 
必需
示例
{
    "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