概述
集成
简要介绍平台工具和集成方式。
注意: 请一定在测试环境完整验证后，才部署功能到生产。
Clink的测试环境和生产使用不同域名和API密钥。请不要在测试环境使用真实信息或者生产密钥。
Clink的测试环境和生产使用不同域名和API密钥。请不要在测试环境使用真实信息或者生产密钥。
商户后台
后台给您的账户提供日常运营功能。以下资源通过后台进行管理：API 集成
我们提供安全且易用的API。API集成通过商户后台生成的密钥进行认证。初始化API密钥
进入开发者页面，点击初始化密钥，请务必复制并安全保存密钥，因为它只会显示一次。生成API密钥
生成API密钥
密钥类型
- 密钥（Secret Key）：用于验证Clink的API请求。默认情况下，此密钥可以执行任何API请求，没有限制。
- 测试环境密钥格式：sk_test_********************
- 生产环境密钥格式：sk_prod_********************
- 可发布密钥（Publishable Key）：用于客户端代码中，主要用于嵌入支付表单。Clink正在开发此功能的支持。
- 测试环境密钥格式：pk_test_********************
- 生产环境密钥格式：pk_prod_********************
密钥轮换
轮换密钥会使当前密钥失效并自动生成替代密钥。您可以选择让旧密钥立即失效，或设定在特定时间后失效。 轮换API密钥的步骤：- 进入开发者页面
- 在要轮换的密钥行中点击更多按钮(⋮)，然后选择轮换密钥
- 从失效时间下拉菜单中选择期限
- 点击轮换密钥
- 复制对话框中显示的新密钥
- 保存密钥值，因为之后将无法再次查看
删除密钥
删除密钥后，该密钥将立即无法进行API调用。如果某个密钥是最后一个有效的密钥，则不能删除它。 删除API密钥的步骤：- 打开API密钥页面
- 轮换要删除的密钥
- 更新代码使用新密钥
- 点击旧密钥的更多按钮，然后选择删除
限制密钥的IP地址
只有密钥（Secret Key）可以限制特定IP地址。您可以将API请求限制在一个或多个IP地址，或使用CIDR限制IP地址范围。- 打开API密钥页面
- 在要限制的密钥行中点击更多按钮(⋮)，然后选择管理IP限制
- 开启_限制使用特定IP地址_
- 点击添加按钮
- 输入单个IP地址或CIDR范围
- 点击保存按钮
Webhooks
Webhooks允许应用程序向其他应用程序提供实时信息。它们在事件发生时立即传递数据，确保您能即时接收信息。 注册webhook端点后，当事件发生时，Clink会将实时事件数据推送到您应用程序的webhook端点。注册
要注册webhook端点，请进入开发者页面并选择Webhooks标签：- 点击新增按钮
- 输入您的HTTPS端点
- 选择您想要监听的事件类型。我们建议监听所有事件
验证签名
Clink使用 HMAC SHA-256 为每个事件生成签名。签名密钥在webhook端点注册后可用。 生成签名的步骤：- 从请求头中提取时间戳和签名：
- 时间戳在X-Clink-Timestamp字段中
- Clink生成的签名在X-Clink-Signature字段中
- 准备要签名的载荷字符串，连接以下内容：
- 时间戳（字符串形式）
- 字符 .
- 事件主体（JSON载荷）
- 使用SHA256哈希函数计算HMAC生成签名
- 比较签名值，只有在签名匹配时才处理事件