README

PHP 商业全球支付 SDK

此 SDK 已由商业全球支付公司适配，以便于将 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" 文件来找到针对每种支付操作定制的文档。

该文档包含 Addon Payments 官方 JavaScript 项目的验证。您也可以在项目的 "test/assets/js" 路径中找到它们。

该文件位于 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
}

测试卡数据

3DS2 测试卡

异常

在您的集成过程中，您将能够测试发卡行提供的特定响应，如“卡片拒绝”。

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

您可以在 "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。

贡献

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

1. 分支
2. 创建功能分支（git checkout -b mi-nueva-feature）
3. 确保SDK的测试正确
4. 确认您的更改（git commit -am '添加一个提交'）
5. 推送到分支（git push origin mi-nueva-feature）
6. 创建新的提取请求

许可证

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