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
最后修改时间:2026-07-21 03:47:39

简要描述#

订单结果回调#

注:商家提供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

订单回调状态说明:#

state状态名备注处理结果
3充值成功充值结果处理成功
4充值失败充值结果处理失败
41充值结果未知充值结果未知人工核实

签名验证算法参考#

卡密模式下返回的ys_cards不参与签名#
因JAVA版本的MD5和PHP 存在一定差异 JAVA编码在使用MD5时请参考放单的加密方法
注:验签的密钥需要保密,验签的目的:1、主要是提供信息来源可靠性验证 2、数据不可串改的安全性保障 3、时效性控制。所以建议商家,做好验签
调试是可以重复触发回调接口 用于调试
[图片]
处理建议
这是一个注意类告示
1.订单如果超10分钟以上未返回最终状态((状态码4失败、3成功),建议每隔5-10分钟通过查询接口查询订单状态
2.订单处于充值中状态,如需加急返回最终结果,请联系蜜蜂客服核查加急

请求参数

Header 参数

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 'http://test.merchant.center.mf178.cn' \
--header 'USER-AGENT: testtest' \
--header 'token: test111111' \
--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 'ys_cards[0][card_type]="卡密或兑换码信息"'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
SUCCESS
修改于 2026-07-21 03:47:39
上一页
资金查询API
下一页
订单做单日志
Built with