欢迎来到梦中星发卡客服热线:198-7941-2769(08:00-23:00)

API接口

梦中星发卡为合作伙伴提供标准化的API接口,方便批量提交验卡和查询订单状态。目前API接口仅对签约合作伙伴开放,如需接入请先联系我们的商务团队。

提示:API接口需要申请专属的AppKey和AppSecret,请通过商务合作渠道获取。未签约用户暂不支持自行接入。

接口概述

  • 接口地址:https://api.szljp.cn/v1
  • 通信协议:HTTPS
  • 数据格式:JSON
  • 字符编码:UTF-8
  • 签名方式:MD5
  • 请求方式:POST

公共参数

所有接口都需要携带以下公共参数:

参数名 类型 必填 说明
app_keyString平台分配的AppKey
timestampString当前时间戳(秒)
signStringMD5签名

签名算法

将所有请求参数按参数名ASCII码升序排序,拼接成key=value&key=value格式,末尾追加AppSecret,再进行MD5加密。

sign = MD5( sorted_params + app_secret )

接口列表

1. 卡种查询

  • 接口路径:/card/types
  • 功能说明:获取当前支持的卡种列表和回收价格
  • 请求参数:公共参数
  • 返回数据:卡种ID、卡种名称、面额列表、回收折扣

2. 验卡提交

  • 接口路径:/card/verify
  • 功能说明:提交卡密进行验证
  • 请求参数:card_type(卡种ID)、face_value(面额)、card_no(卡号)、card_pwd(卡密)、order_no(商户订单号)
  • 返回数据:订单号、验卡状态、回收金额

3. 订单查询

  • 接口路径:/order/query
  • 功能说明:查询订单状态和结果
  • 请求参数:order_no(商户订单号)或 platform_order_no(平台订单号)
  • 返回数据:订单状态、回收金额、交易时间

4. 余额查询

  • 接口路径:/account/balance
  • 功能说明:查询商户账户余额
  • 请求参数:公共参数
  • 返回数据:可用余额、冻结金额、总余额

错误码说明

错误码 说明
200请求成功
1001签名验证失败
1002AppKey无效
1003时间戳过期(有效期为60秒)
2001卡种不支持
2002卡密无效
2003卡片已使用
2004卡片已过期
3001账户余额不足
4001频率限制(每分钟最多100次请求)
5001系统内部错误

接入流程

1. 联系商务团队 - 通过 19879412769@163.com 提交合作意向

2. 签署合作协议 - 确认合作方案并签署正式协议

3. 获取接入凭证 - 分配专属AppKey和AppSecret

4. 技术联调测试 - 在沙箱环境进行接口测试

5. 正式上线 - 切换到生产环境,开始正式使用

详细的API技术文档将在您成为签约合作伙伴后提供。如需了解更多信息,请联系商务团队:19879412769@163.com