商户采购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-27 08:46:11

简要描述#

订单结果回调#

注:商家提供API 由充值平台回调商户URL
商户正式上线时,请提交回调url,服务器IP等信息,交由平台方配置
字段:ys_cards 为数组,如果字段值有回调的话,需要参与验签,拼接的默认值设置为:Array

ys_cards参数样例转json后如下 实际以表单为准#

#网址模式(餐饮,卡密url下单)
[{"card_pwd":"https:\/\/mdlp.com\/#\/pages\/store\/list?sic42y","card_type":3}]
#卡密模式
[{"card_no":"JDV16751600092119","card_pwd":"9ax4-4112-7015-2840","card_type":1}]

请求地址:#

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

返回结果说明#

SUCCESS

签名验证算法参考#

卡密模式下返回的ys_cards不参与签名#
因JAVA版本的MD5和PHP 存在一定差异 JAVA编码在使用MD5时请参考放单的加密方法
注:验签的密钥需要保密,验签的目的:1、主要是提供信息来源可靠性验证 2、数据不可串改的安全性保障 3、时效性控制。所以建议商家,做好验签
调试是可以重复触发回调接口 用于调试
[图片]
处理建议
这是一个注意类告示
1.订单如果提交10-120分钟未返回终止状态(状态码8失败、9成功)建议每隔5-10分钟通过查询接口查询订单最新状态
2.订单如果提交120分钟以上仍未返回终止状态,且查询状态也返回处理中,即可通知双方运营人员查明原因,一起协商处理
3.在前端管理平台,运营人员可发起状态查询请求,查询平台订单最新状态,同步订单状态

请求参数

Body 参数multipart/form-data

请求示例代码

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' \
--form 'order_id="平台充值订单号"' \
--form 'third_id="商家侧订单ID"' \
--form 'biz_no="sku编码(仅参考"' \
--form 'real_amount="实际充值金额"' \
--form 'state="订单状态"' \
--form 'cost=""' \
--form 'info="订单费用"' \
--form 'time="订单处理时间"' \
--form 'voucher="凭证信息"' \
--form 'card_no="如果我们是卡密充值,那么会返回卡号"' \
--form 'new_cookies="ck"' \
--form 'new_cookies_time="ck创建时间"' \
--form 'error_code="错误码"' \
--form 'sign="签名"' \
--form 'sign="签名"' \
--form '_code="错误码"' \
--form 'ys_cards[0][card_type]="卡密或兑换码信息"'

返回响应

🟢200成功
application/json
Body

示例
SUCCESS
修改于 2025-11-27 08:46:11
上一页
资金查询API
下一页
订单做单日志
Built with