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

油卡CK代充放单API

POST
/api/merchant/upload_order
当前代充业务,通过本接口提交到平台

1、状态编码说明#

错误码 (错误以错误码为主,同一错误码有不同的错误原因,方便跟踪问题)#

2.请求参数:#

注:公共参数之外为业务参数,秘钥签名公共参数必传
参数名称参数类型是否必须参数描述
miniunit_idstring是商品编码
source_pack_idstring否资源编码,不传时使用默认资源,代充业务可忽略
datasarray是商品规格数据包,一维数组
third_idstring是商家侧订单ID
call_back_urlstring否回调地址(如不填则使用商户后台配置的地址)外网可访问

参数说明#

【注:不同的商品代码下拥有不同的datas参数】
【调用“获取产品列表”接口实时查看平台产品】
【页面实时查看平台产品:查看 】

所有参数以表单方式提交#

当参数中需要传递 card_pwd时 需要进行加密后传递
业务类型商品编码(必传)miniunit_id业务名称datas参数资源id备注
油卡CK代充1002297中石油代充 (已维护)datas:["
"target":'充值油卡账号', //16671829***
"card_no":'充值卡卡号', //2451235884
"card_pwd": "卡密"//x3OOYokmHzRomYNZUz8sDJItBEHpL3CFAo+76sDm1/8=
"cookies":"ticket="SSO-225_MMKJX3W4BG4C0DYNV58Z9RSCP_S3FYK7WQ1ANR8KJ3R1DTJC2LG2H2OIMGNUWH,687474703A2F2F31302E3234382E323232353A383038302F77656273736F"; acw_sc__v2=68824cfe088dc7bd42c597d2f5af9ae3369a9178"
]
【卡密加密参考下方card_pwd加密方法】
--油卡CK代充
错误码接口错误描述处理结果
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其他问题
5CK失效

2、card_pwd加密方法#

PHP示例:#
JAVA示例:#

请求参数

Header 参数

Body 参数application/json

示例
{
    "app_key": "82162472761",
    "timestamp": "",
    "sign": "sgsdsg3aasdgdsgsdfs434343efset43",
    "third_id": "223221352192444",
    "call_back_url": "http:xxx.xxx.com",
    "miniunit_id ": "1002297",
    "datas": {
        "target": "15541413177",
        "card_no": "112500001770813",
        "card_pwd": "1105926834552733534",
        "cookies": "ticket=\"SSO-225_MMKJX3W4BG4C0DYNV58Z9RSCP_S3FYK7WQ1ANR8KJ3R1DTJC2LG2H2OIMGNUWH,687474703A2F2F31302E3234382E3230302E3232353A383038302F77656273736F\"; acw_sc__v2=68824cfe088dc7bd42c597d2f5af9ae3369a9178"
    }
}

请求示例代码

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 'appSecret: 790a423c81774f6811' \
--header 'Content-Type: application/json' \
--data-raw '{
    "app_key": "82162472761",
    "timestamp": "",
    "sign": "sgsdsg3aasdgdsgsdfs434343efset43",
    "third_id": "223221352192444",
    "call_back_url": "http:xxx.xxx.com",
    "miniunit_id ": "1002297",
    "datas": {
        "target": "15541413177",
        "card_no": "112500001770813",
        "card_pwd": "1105926834552733534",
        "cookies": "ticket=\"SSO-225_MMKJX3W4BG4C0DYNV58Z9RSCP_S3FYK7WQ1ANR8KJ3R1DTJC2LG2H2OIMGNUWH,687474703A2F2F31302E3234382E3230302E3232353A383038302F77656273736F\"; acw_sc__v2=68824cfe088dc7bd42c597d2f5af9ae3369a9178"
    }
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": 0,
    "message": "ok",
    "stime": 1698980245.05146,
    "etime": 1698980245.37863,
    "data": {
        "third_id": "1698980245394604",
        "order_id": "23110100762323",
        "target": "1376047xxxx",
        "state": 1,
    }
}
修改于 2025-09-11 02:56:43
上一页
油卡代充对接流程
下一页
登录油卡账号
Built with