搜索cybersource / rest-client-php
CyberSource REST API 客户端 SDK
Requires
- php: >=8.0.0
- ext-curl: *
- ext-json: *
- ext-mbstring: *
- firebase/php-jwt: ^6.0.0
- monolog/monolog: >=1.25.0
- web-token/jwt-framework: ^2.2.11|^3.3.5
Requires (Dev)
- phpunit/phpunit: 9.6.15
- dev-master
- 0.0.54
- 0.0.53
- 0.0.52
- 0.0.51
- 0.0.50
- 0.0.49
- 0.0.48
- 0.0.47
- 0.0.46
- 0.0.45
- 0.0.44
- 0.0.43
- 0.0.42
- 0.0.41
- 0.0.40
- 0.0.39
- 0.0.38
- 0.0.37
- 0.0.36
- 0.0.35
- 0.0.34
- 0.0.33
- 0.0.32
- 0.0.31
- 0.0.30
- 0.0.29
- 0.0.28
- 0.0.27
- 0.0.26
- 0.0.25
- 0.0.24
- 0.0.23
- 0.0.22
- 0.0.21
- 0.0.20
- 0.0.19
- 0.0.18
- 0.0.17
- 0.0.16
- 0.0.15
- 0.0.14
- 0.0.13
- 0.0.12
- 0.0.11
- 0.0.10
- 0.0.9
- 0.0.8
- 0.0.7
- 0.0.6
- 0.0.4
- 0.0.3
- 0.0.2
- 0.0.1
- dev-feature-add-merchantconfig-developerId
- dev-release-aug24
- dev-adding-workflows
- dev-new-cache
- dev-masking-fix
- dev-sensitive-logging
- dev-test-fix-empty-body-param
- dev-logging-issue
- dev-transient_token
- dev-travis-trial
- dev-generator-with-logging-and-masking
This package is not auto-updated.
Last update: 2024-09-13 09:49:17 UTC
README
描述
CyberSource PHP 客户端为您提供了从 PHP 应用程序访问 CyberSource REST API 的便捷方式。
系统要求
- PHP 8.0.0+
- cURL PHP 扩展
- JSON PHP 扩展
- OpenSSL PHP 扩展
- Zip PHP 扩展
- MBString PHP 扩展
- Sodium PHP 扩展
- PHP_APCU PHP 扩展。您需要为您自己的平台（Windows/Linux/Mac）下载它
安装
Composer
我们建议使用 Composer。 （注意：我们从不建议您覆盖新的 secure-http 默认设置） 按照以下示例更新您的 composer.json 文件，然后运行 composer update。
{
"require": {
"php": ">=8.0.0",
"cybersource/rest-client-php": "0.0.54"
}
}
账户注册 & 配置
- 账户注册
按照 开始使用 CyberSource REST SDKs 中提到的第一步创建一个沙箱账户。
- 配置
按照 开始使用 CyberSource REST SDKs 中提到的第二步通过输入您的凭证来配置 SDK。
请注意，这仅作参考。请确保以更安全的方式存储凭证。
如何使用
要开始使用此 SDK，我们强烈建议您下载我们的示例代码仓库
在该仓库中，我们提供了针对我们 API 所有常见用法的综合示例代码
此外，您还可以在我们的 API 参考指南中找到有关我们 API 结构的详细信息和示例
API 参考指南提供了特定请求所需信息的示例以及该信息的格式化方式。使用这些示例，您可以轻松确定需要包含哪些信息的方法，以便使用此 SDK 发送请求。
有关如何使用 CyberSource 的 REST API SDKs 的更多信息，请使用 开发者中心 REST API SDKs。
使用示例代码应用程序的示例
- 将 CyberSource REST 客户端 作为依赖项添加到您的 php 项目中。
- 在 外部配置 中配置您的凭证。
- 使用配置创建 ApiClient 实例。
- 使用创建的 ApiClient 实例调用 CyberSource API。例如 SimpleAuthorizationInternet
有关更详细的示例，请参阅cybersource-rest-samples-php存储库。
在沙箱环境和生产环境之间切换
CyberSource维护一个完整的沙箱环境，用于测试和开发。此沙箱环境与我们的生产环境完全相同，并模拟了交易授权和结算过程。默认情况下，此SDK配置为与沙箱环境通信。要切换到生产环境，请设置Resources\ExternalConfiguration.php中的适当属性。
例如
// For TESTING use // $this->runEnv = "apitest.cybersource.com"; // For PRODUCTION use $this->runEnv = "api.cybersource.com";
API参考指南提供了特定请求所需的信息示例以及该信息将如何格式化。使用这些示例，您可以轻松确定使用此SDK将信息包含在请求中所需的必要方法。
日志记录
自v0.0.24版本以来，SDK中引入了一个新的日志框架。此新的日志框架利用Monolog，并标准化了日志记录，以便可以与客户端应用程序中的日志记录集成。
有关此新日志框架的更多信息，请参阅此文件：Logging.md
功能
MetaKey支持
元键是单个键，可以由一个、一些或所有商贩（或账户，如果由组合用户创建）在组合中使用。
当使用元键时，组合或父账户拥有该键，并被视为交易提交者，而商贩则拥有交易。
MID仍然可以为自己创建密钥，即使已生成元键。
有关元键的更多信息，请参阅新业务中心用户指南。
附加信息
PHP_APCU PHP扩展
在php.ini文件中启用PHP_APCU PHP扩展。您需要为您自己的平台（Windows/Linux/Mac）下载它并将其添加到扩展中。
官方PHP_APCU - https://pecl.php.net/package/APCu
对于Windows
- PHP v8.0: 从官方pecl网站下载适用的php_apcu dll版本v5.1.19。
- PHP v8.1: 从官方pecl网站下载适用的php_acpu dll版本v5.1.21。
- PHP v8.2: 从官方pecl网站下载适用的php_acpu dll版本v5.1.22。但pecl网站上缺少php v8.2的dll。您可以参考此stackoverflow问题，或者您可以在此处下载php_apcu dll。
对于Mac/Linux/Unix
使用pecl命令下载php_apcu: pecl install apcu。它将自动下载适用于PHP v8.0、v8.1、v8.2的适用apcu扩展。
如何贡献
- 从
master创建分支并Fork仓库。 - 如果您添加了应进行测试的代码，请添加测试。
- 确保测试套件通过。
- 提交您的pull request！（在发起PR之前，请确保您已将同步您的Fork与原始存储库）。
需要帮助？
如有任何帮助，您可以联系我们的讨论论坛。
免责声明
CyberSource可能允许客户访问、使用和/或测试处于开发阶段或尚未进行市场测试的CyberSource产品或服务（“测试版产品”），仅限于评估测试版产品的功能或市场推广性（“测试版评估”）。尽管有相反的表述，以下条款适用于客户参与任何测试版评估（和通过该评估获取的测试版产品）：双方将签订一份单独的协议，详细说明测试版评估的范围、要求、定价、测试版评估期的长度（“测试版产品表”）。测试版产品不是，也不得成为交易服务，尚未公开发布，仅用于内部测试和非商业性评估。客户使用测试版产品的目的仅限于进行测试版评估。客户接受因访问和使用测试版产品而产生的一切风险。CyberSource可自行决定，在任何时候终止或停止测试版评估。客户承认并同意，任何测试版产品可能仍在开发中，并且测试版产品提供“现状”且可能无法达到商用服务的水平，可能无法按预期运行，在发布前可能进行修改。CyberSource对测试版产品或测试版评估（A）数据丢失或不准确或替代商品、服务或技术的采购成本，（B）与测试版产品相关的任何索赔、损失、损害或诉讼请求，或（C）任何间接、偶然或后果性损害（包括但不限于收入损失和利润损失）不承担任何责任或法律责任。