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

商品价格变更推送

POST
http://test.merchant.center.mf178.cn
最后修改时间:2025-04-27 08:17:19

简要描述#

商品价格变更推送#

注:商家订阅商品的时候提交URL

请求地址:#

请求域名:http://xxxxx.com【商户提供域名】如需真实获得回调 可提供公网回调地址
地址:/api/callback 【接口范例】
请求:POST

返回结果说明#

code说明
200成功
注:多次返回失败,超过阈值(10 次),默认回调接口有问题,取消订阅

请求示例#

POST方式提交, 数据格式:Content-Type: application/json  假设密钥为:test

请求地址:
http://xxxxx.com/api/callback
请求参数:
{
    "supplierAccountGuid": "test-merchant",
    "productNo": 22102100000517,
    "productCost": "100.980",
    "priceVer": 1640966400,
    "timestamp": 1640966400,
    "sign": "6a8380f2846f63918d773c61d4dbb960"
}

请求返回示例:#

{
    "code":200,
    "msg":"success"
}

签名验证算法#

因JAVA版本的MD5和PHP 存在一定差异 JAVA编码在使用MD5时请参考放单的加密方法
注:验签的密钥需要保密,验签的目的:1、主要是提供信息来源可靠性验证 2、数据不可串改的安全性保障 3、时效性控制。所以建议商家,做好验签

请求参数

Body 参数application/json
supplierAccountGuid
string 
商户编号-第三方唯一识别商户标识
必需
productNo
integer 
产品编号
必需
productCost
string 
产品价格金额,精确到 3 位小数
必需
priceVer
integer 
当前时间戳
必需
timestamp
integer 
必需
sign
string 
签名
必需

签名算法详见<秘钥签名>

示例
{
    "supplierAccountGuid": "68",
    "productNo": 37,
    "productCost": "deserunt anim ut ut",
    "priceVer": 881,
    "timestamp": 1744705992,
    "sign": "mollit id ex commodo"
}

示例代码

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' \
--header 'Content-Type: application/json' \
--data-raw '{
    "supplierAccountGuid": "68",
    "productNo": 37,
    "productCost": "deserunt anim ut ut",
    "priceVer": 881,
    "timestamp": 1744705992,
    "sign": "mollit id ex commodo"
}'

返回响应

🟢200成功
application/json
Body
code
integer 
返回码
必需
200 成功 其他失败
message
string 
返回信息
必需
stime
number 
必需
etime
number 
必需
data
array[string]
必需
示例
{
    "code": 200,
    "message": "success"
}
🟢200异常响应
修改于 2025-04-27 08:17:19
上一页
商品价格变更订阅
下一页
代充放单API
Built with