核心概念

在深入研究具体示例之前，有必要了解构成 Payment Kit SDK 基础的核心概念。本节内容涵盖 SDK 的组织结构、如何管理测试和线上环境，以及处理潜在错误的正确方法。掌握这些概念将帮助您构建可靠且可扩展的支付集成。

SDK 结构#

Payment Kit SDK 采用了清晰且一致的结构设计。主 payment 对象作为入口点，提供对各种资源模块的访问。每个模块（例如 payment.customers 或 payment.products）将相关的 API 函数分组在一起，从而使 SDK 直观易用。

有关可用模块的详细说明，请参阅 SDK 结构 文档。

环境#

Payment Kit 在两种独立的环境中运行：用于真实交易的 live 环境和用于开发与集成测试的 test 环境。所有 API 请求均在其中一种模式下执行。您可以轻松地在它们之间切换，以确保您的集成在上线前能正常工作。

在 环境 指南中了解如何配置您的环境。

错误处理#

网络问题或无效数据可能会导致 API 请求失败。一个健壮的应用程序必须能够预见并妥善处理这些错误。发生错误时，SDK 会抛出异常。我们建议使用 try...catch 代码块来管理这些情况，以防止应用程序崩溃，并向用户提供明确的反馈。

有关最佳实践和详细示例，请参阅 错误处理 指南。

扎实掌握这些核心概念后，您就可以开始使用 Payment Kit SDK 进行构建了。

要查看这些概念的实际应用，请继续阅读我们的 使用指南 以获取实用的分步示例。