API 概览

本文档用于帮助开发者快速了解 TKLine 支付平台 API 的整体能力、设计规范及接入方式，便于您高效完成系统对接。

平台能力概览

TKLine 提供统一、稳定、可扩展的支付接口服务，帮助商户快速接入多种支付通道，实现资金收付、清结算及风控管理。

• 🔗 统一接口
  提供标准化 API，一次对接即可使用多个支付通道。
• 💰 多币种支持
  支持多币种交易、结算与对账，满足跨境及多区域业务需求。
• 🔀 智能通道路由
  根据通道状态、成本及规则自动选择最优通道，提高成功率。
• 🛡️ 风控体系
  覆盖交易风控、拒付管理、黑名单及物流风控等能力。
• 📒 清结算能力
  提供交易流水、手续费明细、结算账单等完整数据支持。

API 设计说明

TKLine API 采用统一的设计规范，确保接口清晰、易用、可维护。

• 接口风格：RESTful API
• 数据格式：JSON
• 安全机制：签名校验 + HTTPS
• 身份识别：商户号（Merchant ID）
• 鉴权方式：API Key / Secret Key

典型调用流程

一次完整的支付接口调用流程如下：

• 📝 准备请求参数
  按接口文档要求组装业务参数并生成签名。
• ⬆️ 发起 API 请求
  通过 HTTPS 向 TKLine API 发起请求。
• ⚙️ 平台处理
  平台完成参数校验、风控校验、通道路由等处理。
• ⬇️ 同步响应结果
  返回接口调用结果及交易状态。
• 🔔 异步通知（如有）
  平台通过回调地址推送最终交易结果。

环境说明

为保障接入安全与稳定性，平台提供不同运行环境：

• 沙盒环境
  用于开发、联调和测试，不产生真实资金交易。
• 正式环境
  用于真实业务场景，请在完成测试后再切换。

注意

请勿在正式环境中使用沙盒密钥或测试参数。

开始接入

在开始调用 API 之前，请确保您已完成以下准备工作：

• 已成功申请商户
• 已获取商户号及密钥信息
• 已阅读相关接口文档说明