卖卡密教程：协议、开放 API、自托管 CDK 站与日常对账
发码人管理CDK与费用，兑换人提交兑换请求；发码完成和订阅完成是两个时点。
第 4 章 协议简介
这篇图文按接口准备、自托管站点和日常发码说明经销商流程。
4.1 工作流程
从发码、买家兑换到订单确认逐步核对。发出CDK只表示创建了兑换凭证，最终订阅与费用仍应关联兑换订单查询。
4.2 确认账号权限
先检查账户是否具备目标产品、直充和 API 权限，再根据页面提示申请开通。
4.3 两种用法
可以在卡台直接管理CDK，也可以通过自己的兑换站提供买家入口。两种方式仍需使用同一套权限、资金和订单查询规则。
4.4 需要准备的东西
准备有权限的账号、适用卡片和资金；自托管还需要服务器、域名、HTTPS及必要的维护能力。
第 5 章 开发者页：API 密钥和回调
开发者页集中展示密钥、访问限制、消费限额、回调与接口文档。不要在截图、日志或公开消息中披露真实密钥。
5.1 打开开发者页
从工作台打开开发者入口，核对当前权限状态、接口地址和可用文档，再准备密钥配置。
5.2 创建 API 密钥
核对创建入口的消费限额，确认创建结果后按页面规则保管App Secret。
5.3 设置 IP 白名单和消费限额
填写实际服务的出口IP及限额，注意网关、代理或服务器变更造成的出口变化。限额数值和重置周期应按接口文档核对。
5.4 回调地址（Webhook）
设置由自己控制的HTTPS回调地址，并保管签名密钥。接收端应核对签名，处理重复通知，并使用订单查询确认最终状态。
5.5 下载官方文档
根据接口文档核对鉴权、参数、错误码和回调签名。
5.6 用 curl 测试密钥
先调用余额或套餐等只读接口，核对网络、鉴权和权限。不要把写入接口当成连通性检查，也不要直接复用教程中的示例密钥。
第 6 章 部署自托管 CDK 站
自托管部署依次完成环境准备、服务安装、管理员设置和接口配置。
6.1 准备服务器、域名和端口
确认服务器、域名解析、HTTPS端口和安全组一致，避免域名指向旧主机；具体运行条件按当前部署项目文档检查。
6.2 用 SSH 登录服务器
使用自己授权的SSH账号登录目标服务器，先确认机器和目录，再执行维护操作；不要在公开终端输出凭据。
6.3 安装前置工具
按官方环境要求准备运行工具，安装后检查版本和可执行路径，记录每一步结果以便定位失败位置。
6.4 运行官方部署脚本
只在读懂来源和影响后使用官方部署流程。完成后分别核对容器健康、代理服务和访问地址，不以脚本退出成功代替实际验收。
6.5 找到 Setup Token
安装向导的Setup Token属于初始化凭据，从自己的部署日志中取得并妥善保存。
6.6 运行安装向导，创建管理员
按向导验证安装身份，创建管理员并设置密码。安装完成后检查初始化入口的访问规则，保留安全恢复方式。
6.7 登录后台
使用刚创建的管理员访问自托管站点，核对域名与身份，避免把管理员入口作为买家兑换地址分享。
6.8 填写卡台 API 密钥
在卡台接入页面填写自己的API信息，分别检查鉴权、权限与套餐数据。教程的连通检测图片只展示结果形态。
6.9 配置回调（Webhook）
将卡台回调配置与兑换站接收地址对应，核对签名配置及测试结果；回调失败时保留原单并查询状态。
6.10 验收
依次确认HTTPS、健康状态、管理员登录、只读接口与订单查询。真实兑换需要另行授权的受控账号和资金，本轮不执行。
6.11 日常维护和常见问题
升级、备份和恢复按官方部署文档进行；先查看当前版本与日志，避免在故障原因不明时覆盖配置或重建数据。
第 7 章 日常操作：发码、兑换和对账
日常流程应把卡密、买家兑换、卡台订单和资金流水关联起来，便于识别未兑换、处理中、成功和失败的不同阶段。
7.1 费用和发码前的检查
发码前核对套餐、地区、数量、卡片余额、服务费及单码限额。费用承担方和兑换条件应向买家清楚说明。
7.2 发码
选择产品、套餐和地区，核对数量与费用后创建卡密，再检查返回的码和状态。以实际处理结果为准。
7.3 管理卡密
在CDK列表搜索、筛选或导出，核对启停、使用次数和关联订单。导出的卡密属于敏感业务资料，应限制分发范围。
7.4 在卡台管理卡密：前缀、状态与资金上限
前缀用于识别来源，仅影响以后生成的代码。先核对使用状态与关联订单，再使用列表中的复制、资金上限及启用或禁用操作；批量操作前确认选中条目。
7.5 把卡密交给买家
将正确的兑换地址和相应卡密交给买家，并说明适用套餐及操作条件。管理员和API密钥不能随卡密一起交付。
7.6 买家的兑换流程
买家先确认卡密和套餐，再检查目标账号，核对报价后提交兑换。提交后使用同一订单查询；批量操作仍需逐项检查结果。
7.7 对账
把兑换站记录与卡台订单及财务流水对应，核对本金、费用、失败释放和回调时间；结果冲突时保留两边编号与时间。
7.8 修改站点名称
站点名称与展示配置可以调整，但不能据此推断域名、回调地址或业务身份已经同步更新；修改后检查买家看到的页面。
7.9 常见问题
无效卡密、权限不足、预检失败、余额不足与订单处理中应分别排查。结果不明时先查原单，避免重复兑换。
7.10 日常检查
日常检查服务健康、回调积压、失败订单、余额与备份结果；针对异常保存日志，不把单次健康响应当成完整业务验收。
7.11 用 API 发码和对账
程序化发码和对账先阅读接口文档，保留请求关联标识，处理重试与幂等。
附录 A 常见错误
按错误所属阶段定位：网络、鉴权、权限、输入、资金或订单。不要只根据一条通用错误文字推断真实扣款结果。
A.1 通用
先核对接口地址、请求方法、鉴权和IP限制，再查权限与参数。保留必要错误码，不将真实Secret贴入公开反馈。
A.2 直充和兑换
检查目标产品、登录态、套餐、地区和可用金额，再查询相关订单。预检成功和最终兑换成功是不同结果。
A.3 订单状态
处理中应继续查询，成功应核对权益，失败应核对资金释放。网络超时不证明订单失败，也不应立即重复提交。
附录 B 官方资料
部署前核对运行环境、接口参数及版本兼容要求。
继续阅读
继续阅读新手教程、CDK使用说明和API回调指南；页面下方提供对应功能入口。