主题
卡速售系统对接 购印网络
先看整体流程
卡速售这套对接，记住下面这条线就够了：
- 在购印权益拿到
APPID、密钥、API 地址 - 在卡速售里新建货源渠道
- 用卡速售拿到
白名单 IP和商品通知地址 - 回到购印权益把这两项填进去
- 回卡速售刷新余额，正常显示就成功
这篇文档适合谁？
- 第一次使用
卡速售对接货源 - 想把
购印权益接入卡速售 - 希望按步骤完成，不想反复排错
对接前先准备
| 准备项 | 说明 |
|---|---|
| 卡速售后台账号 | 能进入 商品 -> 货源渠道 |
| 购印权益后台账号 | 能进入 用户中心 -> 账户管理 -> 接口管理 |
| 验证方式 | 短信、邮箱或交易密码，至少能用一种 |
| 最新 API 地址 | 购印权益的 API 地址可能变更，建议用当前最新地址 |
先记住这 3 个容易错的点
API 地址不是固定永远不变，最好用购印权益当前给出的最新地址- 只填
APPID / 密钥还不够，后面还要补白名单 IP和商品通知地址 - 如果你重置过密钥，卡速售里必须同步改成新密钥
这些名词，照着理解就行
| 名词 | 你可以把它理解成什么 |
|---|---|
API 地址 | 卡速售请求购印权益接口的地址 |
APPID / 密钥 | 接口登录凭证 |
白名单 IP | 允许卡速售服务器访问购印权益的 IP |
商品通知地址 | 购印权益把商品变更消息发回卡速售的地址 |
第一步：去购印权益拿到 APPID 和 密钥
- 打开购印权益
- 点击
用户中心 - 进入
账户管理 -> 接口管理 - 选择验证方式进入页面
如果你不确定当前密钥是否正确，建议直接重置一次：
- 点击
重置 - 点击
获取验证码 - 输入验证码后点击
确定 - 保存新生成的
APPID和密钥
关于 API 地址
APPID 和 密钥 在接口管理页获取，API 地址 请优先使用购印权益当前提供的最新地址。
如果你不确定，先联系购印权益客服确认，避免后面因为地址变更导致对接失败。
第二步：在卡速售添加货源渠道
- 登录卡速售后台：
https://你的域名/admin - 进入
商品 -> 货源渠道 - 点击
添加
按下面填写即可：
| 字段 | 建议填写 |
|---|---|
| 渠道名称 | 购印权益 |
| 渠道类型 | 卡速售v2 |
| 地址 | 购印权益的 API 地址 |
| APPID | 购印权益的 APPID |
| 密钥 | 购印权益的 密钥 |
| 状态 | 开启 |
其他字段要不要填？
像 备用地址、余额预警 这类字段，不影响基础对接。
如果你只是想先跑通流程，可以先不折腾这些扩展项。
第三步：在卡速售拿到白名单 IP 和商品通知地址
这一步很关键，因为这两个值都不是你手写的，而是卡速售生成给你的。
3.1 先拿白名单 IP
- 回到货源渠道列表
- 点击
刷新余额 - 如果提示“某个 IP 未加入白名单”，把这个 IP 复制下来
3.2 再拿商品通知地址
- 在同一条渠道上点击
编辑 - 进入
基础配置 - 复制
购印权益商品通知地址
小提醒
有些后台会提示“购印权益余额需大于 1.00 元才会通知同步商品”，请以你后台实际提示为准。
第四步：回到购印权益，补齐白名单和通知地址
回到购印权益 账户管理 -> 接口管理 页面，把刚才拿到的信息填进去：
| 购印权益字段 | 这里填什么 |
|---|---|
商品通知地址 | 卡速售提供的 购印权益商品通知地址 |
白名单IP | 卡速售提示需要加入的 IP |
填好后点击 保存信息。
如果有多个 IP
多个 IP 建议一行一个填写。
如果只加了其中一个 IP，可能会出现“有时成功、有时报白名单错误”的情况。
第五步：回到卡速售刷新余额验证
回到卡速售货源渠道列表，点击 刷新：
- 能正常显示
渠道余额 - 不再提示白名单错误或鉴权错误
这就代表对接成功了。
成功标志
只要卡速售能正常拉到余额，并且不再提示报错，就说明 卡速售 ↔ 购印权益 已经打通。
对接失败时，按这个顺序排查
- 先看卡速售里的
APPID / 密钥是否和购印权益最新一致 - 再看
API 地址是否还是最新可用地址 - 再看购印权益
白名单IP是否已经加上卡速售提示的 IP - 再看购印权益
商品通知地址是否填成了卡速售给你的那个地址 - 如果还是不行，截图报错页面联系技术支持
常见问题
1. 刷新余额提示“未加入 IP 白名单”
把提示里的 IP 添加到购印权益 白名单IP，保存后再回卡速售刷新一次。
2. 提示“鉴权失败 / 签名错误 / APPID 不正确”
通常是 APPID 或 密钥 不匹配，尤其是你重置过密钥但卡速售里还在用旧值。
3. 商品通知一直不生效
先确认购印权益里的 商品通知地址 填的是卡速售提供的那条地址，再确认你的卡速售站点可以被公网访问。
4. 找不到最新 API 地址
购印权益的 API 地址 可能调整，优先联系购印权益客服或查看最新文档说明。
最后再提醒 3 件事
安全建议
- 不要在群聊或公开截图里暴露
密钥 - 只把必要的服务器 IP 加入白名单，避免风险扩大
- 一旦怀疑密钥泄露，马上重置并同步更新卡速售配置