接口卡密商品配置指南
本指南面向店铺商家，用于配置“战区定位接口 → 发送卡密”商品。用户付款后，系统通过店铺配置的上游接口生成服务卡券，用户在订单详情复制链接，到浏览器打开使用。
操作前先选中正确的店铺。本文只涉及商家后台配置、用户使用及试购核对。
1. 先选对商品类型
| 商品配置 | 发货方式 | 购买前需要用户填写的信息 |
|---|---|---|
| 卡密商品 | 发放商家提前导入的本地卡密 | 不填写系统、地区或图片 |
| 战区定位接口 + 发送卡密 | 付款后通过上游接口生成服务卡券链接 | 不填写系统、地区或图片 |
| 战区定位接口 + 直接出码 | 付款后生成服务订单，在小程序中获取二维码 | 按所选业务填写系统、地区或选择图片 |
本指南配置的是第二种。商品列表中的类型显示为“ZQDW卡密”，新增商品时应选择“战区定位接口”，再选择“发送卡密”。无需在“卡密库存”中导入卡密。
当前可选择以下对接接口，均支持发送卡密：
| 对接接口 | 用户收到的服务卡券用途 |
|---|---|
| 王者战区修改 | 王者荣耀战区修改 |
| 和平战区修改 | 和平精英战区修改 |
| 王者名片修改 | 王者荣耀主页名片修改 |
| 王者元流海报 | 王者荣耀元流海报修改 |
商品名称不能代替对接接口设置。比如商品名称写“和平战区卡券”，对接接口也必须选择“和平战区修改”。
2. 准备当前店铺的接口和支付配置
准备好上游提供的 HTTPS 服务地址和 API Key，并在上游账号确认对应业务权限及余额足够。API Key 与微信 AppSecret、现网 AppKey 是不同的凭据，不能混填。
需要微信现金支付时，先按 店铺虚拟支付配置指南 完成当前店铺的小程序基础配置、消息推送及微信道具发布。使用积分兑换的商品同样需要有效的上游接口配置，才能生成服务卡券。
3. 保存并测试店铺接口配置
在商家后台打开“接口配置”，核对页面显示的当前店铺名称和公开店铺编号，然后填写：
| 字段 | 怎么填 |
|---|---|
| 服务地址 | 上游提供的完整 HTTPS 服务根地址；不要填卡券链接或具体接口路径 |
| API Key | 粘贴上游为该账号提供的完整 API Key |
填写后先点击“保存配置”，再点击“测试连接”。修改表单后，测试连接按钮会暂时禁用；先保存，再测试已保存的配置。
- 首次配置需要填写 API Key。
- 服务地址不变时，已配置的 API Key 输入框留空会保留原密钥。
- 修改服务地址时，必须同时填写新地址对应的 API Key。
- 正常配置无需勾选“清除 API Key”；清除后需重新填写并保存，接口发货才能继续。
- 切换到其他店铺后，需要核对该店铺自己的接口配置。
测试成功只表示连接测试通过，不代表上游余额足够或所有业务均可发券。本后台不提供上游余额、成本或充值查询，需到上游账号核对；地址或凭据不确定时联系上游负责人。
4. 新增接口卡密商品
打开商家后台“商品管理”，点击新增商品，按下面的示例填写。道具ID和价格应替换为你自己已发布的微信道具信息。
| 字段 | 示例 | 说明 |
|---|---|---|
| 商品名称 | 王者战区修改卡券 | 必填，清楚说明销售的服务 |
| 商品分类 | 战区服务 | 可选；选择当前店铺已经设置的商品分类 |
| 商品类型 | 战区定位接口 | 选中后会出现对接接口及发货类型 |
| 对接接口 | 王者战区修改 | 根据实际售卖业务选择 |
| 发货类型 | 发送卡密 | 购买前不向用户收集系统、地区或图片 |
| 发放数量 | 1 | 必填；当前每单交付一个服务卡券，此字段不配置卡券使用次数 |
| 售价（元） | 5.00 | 需要现金支付时，与微信道具原价一致 |
| 道具ID | wz_card_01 | 示例占位值；实际填写微信已发布道具 ID |
| 最多可抵扣比例 | 40 | 整数百分比，界面自动显示 %；填 0 禁用积分 |
| 支付赠送积分 | 0 | 不赠送；按需要设置，纯积分订单不赠送付款奖励积分 |
| 排序 | 0 | 数字越小越靠前 |
| 状态 | 上架 | 下架后不再供用户购买 |
商品分类按店铺自己的分类管理，不需要按“普通商品、卡密商品、战区定位接口”划分分类。
接口发送卡密商品的“发放数量”请填 1。填写更大的数值不会增加交付的卡券数量或使用次数，卡券实际使用规则以对应上游服务为准。
接口商品的库存输入框禁用，小程序显示库存“充足”。这不代表上游余额无限或服务一直可用，仍需维护上游账号的余额和业务权限。
“道具ID”是微信支付道具 ID，不是上游卡券编号，也不是商品列表中的本地商品编号。微信道具原价为 500 分时，本后台售价填 5.00 元；积分抵扣后的实付金额由系统计算，不要把折后价改成商品原价。
封面、商品说明和使用教程
- 封面地址：填写可访问的图片地址，或从附件库选择图片。
- 商品说明：支持“纯文本”“HTML”“Markdown”，填写后可在编辑表单内预览。建议写明卡券用途和领取方式。
- 使用教程视频地址：可选，填写可访问的视频地址，或从附件库选择视频；未配置时不会有可播放的教程。
商品说明可以使用以下纯文本示例：
付款后自动生成服务卡券，在订单详情复制链接到浏览器打开使用。购买前无需选择系统和地区，具体操作按服务卡券页面提示完成。
配置好教程后，用户可在订单详情点击“使用教程”弹窗播放，也可复制教程链接到浏览器打开。
5. 积分如何影响付款
固定比例为 100 积分抵扣 1 元；积分不要求整百，用户可少用或不用。最多可抵扣比例限制的是使用上限。
以上面的 5 元商品为例：
| 设置及余额 | 使用结果 |
|---|---|
| 上限 40%，用户有 123 积分 | 默认使用 123 积分，抵扣 1.23 元，实付 3.77 元 |
| 上限 40%，用户有 300 积分 | 最多使用 200 积分，抵扣 2.00 元，实付 3.00 元 |
| 用户选择不使用积分或手动输入 0 | 实付 5.00 元 |
| 上限 100%，用户有至少 500 积分并使用 500 积分 | 全额积分兑换，实付 0，不弹出微信支付面板 |
支付赠送积分是另一项商品设置，不会提高当前订单的抵扣上限。全额积分兑换不赠送付款奖励积分。
6. 用户如何领取和使用
- 打开商品，点击“立即购买”，在“信息确认”中核对商品；接口卡密无需填写系统、地区或图片。
- 点击确认，进入“确认支付”，核对商品金额、积分数量、抵扣金额和实际支付金额。
- 完成付款或全额积分兑换，等待服务卡券生成。
- 打开订单详情查看“服务卡券”；离开页面后可从个人中心“订单记录”重新进入。
- 点击链接下方的“复制”，到浏览器粘贴打开，按上游卡券页面提示使用。
订单中的“刷新卡券”用于查看该订单最新的卡券交付结果。发送卡密商品在浏览器使用服务卡券，不在小程序订单内填写系统、地区或获取直扫二维码。
付款确认后才会生成卡券，创建待支付订单不会发券。发货完成表示服务卡券已交付，不代表用户已经使用，也不代表上游修改已经成功。卡券使用结果按服务页面提示查看；服务失败不代表订单已自动退款，退款以订单显示为准。
服务卡券链接是使用凭据，只交给对应购买者，不要放入公开商品说明、截图或群聊。
7. 常见问题
| 现象 | 商家先检查什么 |
|---|---|
| 新增商品后仍要求用户选系统或地区 | 发货类型是否误选“直接出码”；应为“发送卡密”，保存后重新打开商品核对 |
| 找不到卡密导入或管理入口 | 接口卡密不走本地卡密库存；确认商品组合为“战区定位接口 + 发送卡密” |
| 测试连接失败 | 当前店铺服务地址、API Key 是否匹配，是否先保存再测试；持续失败时提供错误提示和请求编号 |
| 测试成功但付款后一直生成中 | 到上游核对余额及对应业务权限，在本后台核对该订单付款和发货结果；仍异常时向平台管理方提供订单号、请求编号和错误提示 |
| 收到的卡券业务不对 | 核对商品保存的“对接接口”，不要只看商品名称；已有异常订单交由平台管理方核查，不重复购买 |
| 无法拉起微信支付 | 按 支付指南 核对店铺支付配置、已发布道具ID和原价 |
| 全积分兑换未弹出微信付款 | 实付为 0 时正常；核对积分扣减和服务卡券交付结果 |
| 没有使用教程 | 在商品编辑中配置“使用教程视频地址”，并确认该视频地址可以访问 |
8. 上架前试购检查
- 当前店铺接口配置已保存，连接测试通过；上游业务权限与余额已核对。
- 商品为“战区定位接口”，业务选择正确，发货类型为“发送卡密”。
- 现金支付所需的店铺支付配置和微信道具发布已完成，商品原价与微信一致。
- 保存后重新打开商品，确认配置没有选错。
- 小程序购买前没有要求填写系统、地区或图片。
- 真机付款后订单出现正确业务的服务卡券，能复制到浏览器打开。
- 启用积分时，部分积分和全额积分兑换的金额、积分明细及发货结果符合设置。
- 配置了教程的商品，订单中的教程可播放且链接可复制。
本文依据当前配置页面和订单流程整理，未代替店铺执行真实扣款、上游发券或卡券使用验收。