README

PHP 商业全球支付 SDK

此 SDK 已由 Comercia Global Payments 适配，以便简化将您的 Addon Payments 终端集成到 PHP 服务器中的过程。

解决方案

通用

支付 API 处理
Apple Pay 和 Google Pay（开发中）
安全存储卡片和客户管理
周期性支付
信用卡和借记卡
使用 HPP 解决方案最小化 PCI 合规性要求
140 多种授权货币和 16 种结算货币
内置欺诈预防规范
3D Secure、AVS 和 CVV 验证
端到端安全加密
兼容 3D Secure 版本 2

要求

PHP 5.5.9+
OpenSSL 1.0.1+
PHP Curl 扩展
PHP DOM 扩展
PHP OpenSSL 扩展

安装

通常使用 Composer/Packagist 在您的解决方案中安装 SDK，或者将项目添加到您的解决方案中，并直接引用它。

通过 Composer/Packagist 安装，请在您的控制台中输入以下命令

composer require addonpayments/php-sdk

通过直接下载安装

您可以下载并解压库，或者使用 Git 从 GitHub 克隆存储库。

git clone https://github.com/addonpayments/php-sdk

有关如何克隆存储库的更多信息，请参阅克隆存储库。

文档和示例

您可以通过在服务器上执行 "index.php" 文件来找到针对每种支付操作的适应型文档。

此文件位于 SDK 的 "test" 文件夹中。如果您愿意，您还可以查看我们的官方文档，位于 Addon Payments 开发者页面上，在那里您还可以找到用于测试购买和可用库的示例卡。

快速提示：包括在内的测试包可以是使用 SDK 的代码示例的一个很好的来源！

处理支付

$card = new CreditCardData();
$card->number = "4111111111111111";
$card->expMonth = "12";
$card->expYear = "2025";
$card->cvn = "123";

try {
    $response = $card->charge(129.99)
        ->withCurrency("EUR")
        ->execute();

    $result = $response->responseCode; // 00 == Autorizado
    $message = $response->responseMessage; // [ sistema de pruebas ] AUTHORISED
} catch (ApiException $e) {
    // Manejar errores
}

测试卡数据

异常

在您的集成过程中，您可以测试发卡行提供的特定响应，例如 "卡被拒绝"。

由于我们的测试环境无法到达发卡行以获取授权，因此存在一些卡号将触发发卡行的响应。

在 "test" 文件夹的文档中，您可以找到一个动态错误搜索器，其中显示了每个错误及其可能的解决方案的详细描述。

请联系 Addon Payments 支持团队以获取用于值和模拟 AVS/CVV 交易结果的完整列表。

错误处理代码示例

try {
    $response = $card->charge(129.99)
        ->withCurrency("EUR")
        ->execute();
} catch (BuilderException $e) {
    // Errores del constructor
} catch (ConfigurationException $e) {
    // Errores referentes a la configuración de los servicios
} catch (GatewayException $e) {
    // Errores/excepciones de la pasarela de pagos
} catch (UnsupportedTransactionException $e) {
    // Manejar errores cuando la pasarela de pagos no soporta el tipo de transacción
} catch (ApiException $e) {
    // Manejar otros errores
}

支持

如果您想与 Addon Payments 的专家交谈，请拨打 914 353 028 或发送电子邮件至 soporte@addonpayments.com。

贡献

我们所有的代码都是开源的，并鼓励其他开发者参与贡献，帮助我们改进代码！

进行分支
创建功能分支（git checkout -b mi-nueva-feature）
确保SDK的测试正确无误
确认您的更改（git commit -am '添加一个提交'）
将分支推送到远程（git push origin mi-nueva-feature）
创建新的拉取请求

许可证

本项目基于GNU通用公共许可证v2.0授权。有关更多详细信息，请参阅项目根目录下的"LICENSE.md" 文件。

quadram/ addonpayments-php

维护者

详细信息