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

商户退款通知回调API

POST
http://test.merchant.center.mf178.cn
最后修改时间:2025-11-03 09:36:56

简要描述#

订单结果回调#

注:商家提供API 由充值平台回调商户URL
商户正式上线时,请提交回调url,服务器IP等信息,交由平台方配置

请求地址:#

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

返回结果说明#

SUCCESS

签名验证算法参考#

卡密模式下返回的ys_cards不参与签名#
因JAVA版本的MD5和PHP 存在一定差异 JAVA编码在使用MD5时请参考放单的加密方法
注:验签的密钥需要保密,验签的目的:1、主要是提供信息来源可靠性验证 2、数据不可串改的安全性保障 3、时效性控制。所以建议商家,做好验签
调试是可以重复触发回调接口 用于调试
[图片]
处理建议
这是一个注意类告示
1.返回值为:SUCCESS ,非 json

请求参数

Body 参数application/json

示例
{
    "order_id": 25110301859035,
    "third_id": "4855785339408171001-00",
    "status": 3,
    "timestamp": 1762160963
}

请求示例代码

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 '{
    "order_id": 25110301859035,
    "third_id": "4855785339408171001-00",
    "status": 3,
    "timestamp": 1762160963
}'

返回响应

🟢200成功
application/json
Body

示例
SUCCESS
修改于 2025-11-03 09:36:56
上一页
商户订单退款请求
下一页
预购订单退款请求
Built with