购印权益文档站

主题

卡卡云系统对接 购印网络 ​

先说结论

这套对接不难，你只需要按顺序完成这 5 件事：

  1. 在购印权益拿到 APPID 和 接口密钥
  2. 在卡卡云里新建货源平台
  3. 先点一次 余额，拿到需要加白名单的 IP
  4. 回到购印权益，把 IP 加进 白名单IP
  5. 再点一次 余额，能看到余额就代表成功

这篇文档适合谁？ ​

  • 第一次接触 API 对接，不想研究太多专业术语
  • 正在使用 卡卡云
  • 想把 购印权益 接进来做货源

对接完成后，你会得到什么？ ​

  • 卡卡云可以正常查询购印权益余额
  • 后续可以继续在卡卡云里稳定调用货源
  • 遇到报错时，知道优先检查哪里

开始前，先准备这 4 样 ​

准备项说明
卡卡云后台账号能进入 对接配置 -> 货源平台
购印权益后台账号能进入 用户中心 -> 账户管理 -> 接口管理
验证方式短信、邮箱或交易密码，至少能用一种
最新接口地址常用地址是 https://by.yscr.cn，如平台有更新请以最新通知为准

新手最容易卡住的地方

绝大多数失败都不是“不会填表单”，而是 白名单 IP 没配对。

所以第一次点击 余额 报错不用慌，这一步本来就是为了拿到需要加白名单的 IP。

字段怎么对应？ ​

购印权益里的信息卡卡云里填写的位置说明
APPID商户ID接口身份标识
接口密钥商户KEY接口鉴权密钥
https://by.yscr.cn下单网址接口请求地址
222-KK定制【API】平台类型固定选择项
API对接对接方式固定选择项

第一步：在购印权益获取 APPID 和 接口密钥 ​

  1. 打开购印权益站点：https://by.yscr.cn
  2. 点击顶部 用户中心
  3. 进入 账户管理 -> 接口管理
  4. 选择验证方式并进入接口管理页

购印权益-用户中心入口

购印权益-接口管理入口

购印权益-选择验证方式

进入接口管理页后，重点看两项：

  • APPID
  • 接口密钥
看不到接口密钥怎么办？

大多数情况下，接口密钥不能直接查看，需要点击 重置 重新生成。

如果你需要重新生成密钥，就按下面做：

  1. 点击 重置
  2. 点击 获取验证码
  3. 输入验证码后点击 确定
  4. 复制新展示出来的 API 信息并保存好

购印权益-重置密钥入口

购印权益-获取验证码

购印权益-输入验证码并确定

购印权益-API信息展示

注意

只要你点了 重置，旧密钥会立刻失效。

如果你之前已经在别的地方填过旧密钥，后面一定要同步改成新的。

第二步：在卡卡云创建货源平台 ​

  1. 登录卡卡云后台：https://你的域名/PA
  2. 打开 对接配置 -> 货源平台
  3. 点击 创建新平台

卡卡云-登录

卡卡云-对接配置入口

卡卡云-创建新平台

按下面填写即可：

字段建议填写
平台名称购印权益
下单网址https://by.yscr.cn
平台类型222-KK定制【API】
对接方式API对接
商户ID购印权益的 APPID
商户KEY购印权益的 接口密钥
备用网址 / 用户账号 / 用户密码 / 交易密码不确定时先留空

卡卡云-基本设置填写示例

监控 / 采集配置没有特殊要求的话，保持默认即可。

卡卡云-监控采集配置

看到“添加成功”后，说明平台已经建好了。

卡卡云-添加成功

第三步：先点一次 余额，拿到白名单 IP ​

  1. 回到 货源平台 列表
  2. 找到刚添加的平台
  3. 点击 余额

卡卡云-点击余额

如果白名单还没配，会弹出类似“未加入 IP 白名单”的提示。

这里面会有一个 IP，比如 101.37.67.47，把它复制下来。

卡卡云-未加入白名单报错示例

为什么这里先报错？

这是正常现象。

卡卡云必须先发起一次请求，购印权益才会告诉你“哪个服务器 IP 需要加入白名单”。

第四步：回到购印权益，把 IP 加进白名单 ​

  1. 回到购印权益 接口管理
  2. 在 白名单IP 里粘贴刚才复制的 IP
  3. 点击 保存信息

购印权益-填写白名单IP并保存

这里一定要注意

  • 如果卡卡云有多个出口 IP，建议联系卡卡云客服一次性拿到完整 IP 列表
  • 多个 IP 建议一行一个
  • 只加一个 IP，可能会出现“有时能查余额、有时下单失败”的情况

第五步：回到卡卡云再验证一次 ​

  1. 回到卡卡云 货源平台
  2. 再次点击 余额
  3. 能正常看到余额，就说明对接完成了

卡卡云-再次点击余额

卡卡云-余额查询成功

成功标志

出现“查询成功”或正常余额数字，就表示 卡卡云 ↔ 购印权益 已经打通。

如果失败，按这个顺序排查 ​

  1. 先看 白名单IP 是否填全
  2. 再看 APPID 和 接口密钥 是否填错
  3. 再看 下单网址 是否还是 https://by.yscr.cn
  4. 如果你刚重置过密钥，确认卡卡云里已经换成新密钥
  5. 还是不行，就把错误截图发给技术支持

常见问题 ​

1. 提示“未加入 IP 白名单” ​

把报错里的 IP 添加到购印权益 白名单IP。

如果平台有多个 IP，需要补齐全部 IP。

2. 提示“签名错误 / 商户信息错误 / 401 / 403” ​

通常是 APPID 或 接口密钥 不正确，或者你重置过密钥但卡卡云里还在用旧值。

3. 余额查询超时 ​

先检查 下单网址 是否正确，再确认服务器能正常访问该域名；如果平台通知了新 API 域名，请同步更新。

最后再提醒 3 件事 ​

安全建议

  • 接口密钥 就像密码，不要发群里，也不要明文截图
  • 如果怀疑泄露，马上去购印权益 重置，再回卡卡云更新
  • 每次改完密钥或接口地址，最好重新点一次 余额 做验证

© 2026 购印权益｜版权所有