概述
欢迎接入 IntPay 支付网关。本章节将帮助您快速完成接口对接，并了解基础通信规则与环境配置。
一、签名机制（Signature）
IntPay 提供 双向签名机制，用于确保交易安全、数据完整性及请求来源的可靠性。
📌 基本要求
- 所有 API 请求 必须进行签名
- 所有 API 响应 需要验证签名
- 所有异步通知（Webhook）必须验证签名
- 通知响应无需签名
🔐 签名类型
| 类型 | 适用场景 | 特点 |
|---|---|---|
| POST 签名 | API 请求、API 响应、系统通知（Webhook） | 签名通过 Header 传递，Body 参与签名 |
| GET 签名 | 页面跳转（如支付完成回跳） | 签名参数附加在 URL Query 中 |
二、环境信息
🧪 沙箱环境（Sandbox）
- API 地址：
http://staging-api.links-pay.com
🔑 商户配置
| 参数 | 值 |
|---|---|
| 支付渠道(channel) | UnitedStates2D |
| 商户号（tenant-id） | 220818025875 |
| 密钥（secretKey） | lfzqfim2sa9hbj3l57xupzp9pzrjojni |
🧪 生产环境（Prod）
- API 地址：
https://api.links-pay.com
🔑 商户配置
| 参数 | 值 |
|---|---|
| 支付渠道(channel) | 开户后由商务经理分配 |
| 商户号（tenant-id） | 开户后由商务经理分配 |
| 密钥（secretKey） | 开户后由商务经理分配 |
三、通用请求规则（General Rules）
| 项目 | 说明 |
|---|---|
| 字符编码 | UTF-8 |
| 请求方式 | POST |
| Content-Type | application/json |
| 金额单位 | 最小货币单位（整数，单位：分） |
| 时间格式 | 13 位毫秒级时间戳 |
| 签名算法 | 基于 MD5 的消息签名 |
| 签名规则 | 按字段字典序升序排列，参与签名的字段为非 null（空字符串参与） |
四、对接流程概览（Integration Flow）
- 商户系统构建请求参数
- 按规则生成签名
- 发起 API 请求至 IntPay
- 验证返回签名
- 根据业务处理响应结果
- 接收并验证异步通知（Webhook）
五、重要说明（Important Notes）
- ⚠️ 所有请求必须保证参数完整性，请务自行修改、变动顺序，否则可能导致签名失败
- ⚠️ 建议服务端进行签名与验签，避免密钥泄露
- ⚠️ 异步通知为最终交易结果且可能存在多次发送的情况，请务必正确处理