README

官方 Zota PHP SDK

这是 Zota PHP SDK 的官方页面。它旨在供运行现代 PHP 应用程序的开发商使用，以便集成我们的下一代支付平台。

简介

PHP SDK 提供了集成 Zota 商户 API 所需的所有必要方法。该 SDK 由客户使用，同时也用于主流 PHP 应用程序的所有相关电子商务插件。

要求

• 一个有效的 Zota 沙盒或生产账户及其相关凭证
• PHP 版本 7.2.0 或更高
• 客户端 URL 库（cURL）版本 7.34.0 或更高
• 启用 JSON 扩展

使用方法

主要配置

所有文件加载完成后，需要进行配置。这可以通过 Zota 类提供的静态方法来完成。配置包括

• 凭证
• API URL - 测试或生产环境
• 端点
• 日志阈值和位置

API 请求

一切设置完成后，所有对 API 的请求都通过相应的类进行。

• 存款
• DepositCC（使用信用卡数据存款）
• 付款
• 订单状态
• 订单报告

每个请求类都包含一个公共请求方法，该方法具有数据对象参数。同时还有用于数据准备和签名的私有方法。

发送请求

首先创建数据对象，并使用设置器（例如，DepositOrder）设置所有必要的数据。

然后创建请求类（例如，Deposit），并使用数据对象作为参数调用请求方法。

检索响应

每个请求方法都返回一个带有可用获取器的响应对象。在每个响应对象中，都包含从 API 收到的代码、消息和数据。同时，在每个响应对象中，还包含用于响应体、HTTP 状态码和 JSON 的获取器。所有其他获取器都是特定于请求的，可用于更方便地使用响应。

回调和商家重定向处理器

可用于处理回调和重定向的类具有相应的获取器

• ApiCallback
• MerchantRedirect

其他资源

此外，还提供了 DefaultLogger 类，用于记录日志。DefaultLogger 包含八个方法，用于将日志写入八个 RFC 5424 级别（调试、信息、注意、警告、错误、临界、警报、紧急）。

示例

示例在 examples 文件夹中。

加载和配置

• autoload.php 作为引导程序加载所有必需的文件。
• config.php 包含主要配置。

• 如果需要，可以为不同的请求设置不同的端点。

请求

• deposit.php - 存款请求
• deposit-cc.php - 带有信用卡详情的存款请求
• payout.php - 付款请求
• order-status.php - 订单状态请求
• orders-report.php - 订单报告请求

订单处理器

• callback.php - API 回调
• merchant-redirect.php - API 商家重定向

日志记录

• logger.php - DefaultLogger 使用

资源

有关 存款 和 付款 操作的 Zota API 指南可在官方 API 文档页面上找到。

支持

本SDK由Zota提供支持和维护。如需注册和销售咨询，请联系sales@zota.com。如需支持，请使用support@zota.com，并在邮件中包含客户可识别信息以及问题描述。