Subotiz 接入设置为商户进行系统集成提供所需的 API 接入信息和支付跳转设置。当商户需要将自有网站、应用或其他业务系统与 Subotiz 集成时，可在此查看 API 密钥和访问号，并配置客户支付成功或取消支付后的跳转 URL。
接入设置包含 API 密钥和回调设置两个模块：
模块 |
主要功能 |
适用场景 |
|---|---|---|
API 密钥 |
查看标准密钥和访问号 |
调用 Subotiz API、进行系统集成和身份验证 |
回调设置 |
配置 Return URL 和 Cancel URL |
设置客户支付成功或取消支付后的跳转页面 |
API 密钥
API 密钥用于系统集成过程中的 API 访问和身份验证。当商户通过自有网站、应用或其他业务系统接入 Subotiz API 时，可在此查看当前账户提供的接入信息。
API 密钥页面包含 标准密钥和基础信息。
标准密钥
如当前账户显示标准密钥，可查看以下信息：
- 名称： 标准密钥的名称。
- ID： 标准密钥的唯一标识。
- 令牌： 用于 API 接入的密钥信息。
- 状态： 标准密钥当前的使用状态。
- 有效期： 标准密钥的有效期限。
标准密钥拥有完整的 API 访问权限，请妥善保管，避免泄露。
注意： 标准密钥的显示情况以当前账户的 API 密钥页面为准。
基础信息
基础信息区域显示当前账户的 访问号。进行系统集成时，请根据相关 API 文档使用访问号。
有关 API 密钥的详细说明，请参阅《接入设置｜查看与轮换 API 密钥》。
回调设置
回调设置用于控制客户完成支付操作后的页面跳转。商户可根据自身业务流程设置以下 URL：
- Return URL： 客户支付成功后跳转的 URL，例如订单确认页或支付成功页。
- Cancel URL： 客户取消支付后跳转的 URL，例如重新结账页面或其他指定页面。
通过配置跳转 URL，商户可将客户从 Subotiz 支付流程引导回自己的业务页面，使支付和后续操作保持连贯。
有关具体配置步骤，请参阅《接入设置｜配置支付链接的跳转页面》。
安全使用建议
- 保护标准密钥： 请勿在前端代码、公共文档、截图或即时通讯工具中公开令牌。
- 限制访问权限： 仅向负责系统集成的可信技术人员开放接入设置信息。
- 安全存储密钥： 将敏感密钥信息存储在安全的服务器环境或密钥管理工具中。
进入接入设置
- 进入接入设置： 登录 Subotiz 后台，前往 开发者 > 接入设置。
Subotiz 接入设置为系统集成提供 API 访问所需的信息，并支持配置支付完成后的客户页面跳转。商户可通过 API 密钥完成系统接入，并通过回调设置衔接 Subotiz 支付流程与自身业务页面。