购印权益文档站

主题

卡易信系统对接 购印网络 ​

先看流程

这套对接可以简单理解成“两边各填一次”：

  1. 先在卡易信创建一个对接网站
  2. 去购印权益拿到 APPID 和 密钥
  3. 回到卡易信填写 APPID / APPKEY
  4. 再把卡易信给你的 服务器IP 和 商品信息更变通知地址 填回购印权益
  5. 刷新余额，能看到余额就成功

这篇文档适合谁？ ​

  • 第一次使用 卡易信 做货源对接
  • 想把 购印权益 接入卡易信
  • 希望按图一步一步配置，不想来回试错

开始前先准备 ​

准备项说明
卡易信后台账号能进入 货源对接 -> 通用API接口
购印权益后台账号能进入 用户中心 -> 账户管理 -> 接口管理
验证方式短信、邮箱或交易密码，至少能用一种
最新 API 域名建议用购印权益当前提供的最新地址

新手最容易忽略的 2 个点

  • 网站域名 一般只填域名本身，不要带路径，也不要随手多加 /
  • 卡易信不只是填 APPID / APPKEY，还要把 服务器IP 和 商品信息更变通知地址 回填到购印权益

字段对照，照着填就行 ​

购印权益字段卡易信字段用途
APPIDAPPID接口身份标识
密钥APPKEY接口鉴权密钥
商品通知地址商品信息更变通知地址商品变更回调地址
白名单IP卡易信的 服务器IP允许卡易信服务器访问接口
不懂“商品通知地址”也没关系

你可以把它理解成“购印权益把商品变动消息发回卡易信的地址”。

这个地址不是你手写的，而是 卡易信后台生成给你的，你只需要复制粘贴回购印权益即可。

第一步：先在卡易信添加对接网站 ​

  1. 打开卡易信后台：https://你的域名/admin
  2. 输入账号密码登录
  3. 进入 货源对接 -> 通用API接口
  4. 点击 添加对接网站

卡易信-登录页

卡易信-通用API入口

卡易信-添加对接网站

弹窗里先填这些必要项：

字段建议填写
网站名称自定义，建议写成 购印权益
渠道类型速售
网站域名购印权益的 API 域名，不带结尾 /

卡易信-填写网站信息

小提醒

这一步先把网站建出来就行，APPID / APPKEY 稍后再填。

第二步：去购印权益获取 APPID 和 密钥 ​

  1. 打开购印权益
  2. 点击 用户中心
  3. 进入 账户管理 -> 接口管理
  4. 选择验证方式进入页面

购印权益-用户中心入口

购印权益-进入接口管理

购印权益-选择验证方式

如果你不确定当前密钥是否正确，建议直接重置一次：

  1. 点击 重置
  2. 点击 获取验证码
  3. 输入验证码后点击 确定
  4. 复制新展示出来的 APPID 和 密钥

购印权益-点击重置

购印权益-获取验证码

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

购印权益-APPID与密钥展示

注意

只要重置过密钥，旧密钥会马上失效。

如果你后面没有把卡易信里的 APPKEY 一起更新，就一定会报鉴权错误。

第三步：回到卡易信填写 APPID / APPKEY ​

回到刚才在卡易信创建的网站编辑页，按下面做：

  1. 把购印权益的 APPID 填到卡易信 APPID
  2. 把购印权益的 密钥 填到卡易信 APPKEY
  3. 点击保存或确认修改

卡易信-填写APPID与APPKEY

接着还要拿两项信息：

  1. 点击编辑或查看详情
  2. 复制卡易信提供的 商品信息更变通知地址
  3. 再复制页面显示的 服务器IP

卡易信-复制通知地址并确认

卡易信-服务器IP

第四步：把 服务器IP 和 通知地址 回填到购印权益 ​

回到购印权益 接口管理 页面，填写下面两项：

购印权益字段这里填什么
白名单IP卡易信给你的 服务器IP
商品通知地址卡易信给你的 商品信息更变通知地址

填好后点击 保存信息。

购印权益-保存信息

如果有多个 IP

多个 IP 建议按一行一个填写，避免只加了其中一个导致偶发失败。

第五步：刷新余额，确认是否成功 ​

回到卡易信对接列表页，点击刷新：

  • 能正常显示余额，说明对接成功
  • 余额为空或报错，直接看文末排查清单

卡易信-刷新余额

成功标志

卡易信能够正常拉到购印权益余额，并且不再提示鉴权或白名单错误。

对接失败时，按这个顺序排查 ​

  1. APPKEY 是否还是旧密钥
  2. 购印权益 白名单IP 是否已经填写卡易信 服务器IP
  3. 购印权益 商品通知地址 是否填写成了卡易信给你的那个地址
  4. 网站域名 是否只填了域名，没有带路径
  5. 如果还不行，带上报错截图联系技术支持

常见问题 ​

1. 我能不重置密钥吗？ ​

可以。

如果你确认当前 APPID / 密钥 没问题，也没有泄露，可以直接使用。

2. 网站域名应该怎么填？ ​

通常只填域名本身，比如 example.com，不要带路径，也不要随手加多余的 /。

3. 为什么已经填了 APPID / APPKEY 还是不成功？ ​

因为卡易信这套对接除了凭证，还依赖：

  • 服务器IP 是否加入购印权益白名单
  • 商品信息更变通知地址 是否已经回填

这两项少一项都可能失败。

最后再提醒 3 件事 ​

安全建议

  • APPKEY 就像密码，不要发群里，也不要直接截图外传
  • 一旦怀疑泄露，马上去购印权益重置，然后同步更新卡易信
  • 以后如果卡易信服务器 IP 发生变化，记得重新更新购印权益白名单

© 2026 购印权益｜版权所有