bamboopayment/bamboopayment-sdk

PHP SDK 用于与 BambooPayment PCI API 交互

v0.10.0 2021-12-23 17:01 UTC

README

Latest Version on Packagist Software License Build Status Coverage Status Total Downloads

系统要求

您需要 PHP >= 7.4

依赖关系

这些绑定需要以下扩展才能正常工作

  • json (此扩展实现了 » JavaScript Object Notation (JSON) 数据交换格式。)
  • guzzle (Guzzle 是一个 PHP HTTP 客户端,用于发送 HTTP 请求和与 Web 服务集成。)
  • generated-hydrator (GeneratedHydrator 是一个关于高性能将数据从数组转换为对象以及从对象转换为数组的库。)

如果您使用 Composer,这些依赖项应该会自动处理。如果您手动安装,请确保这些扩展可用。

文档

完整文档:西班牙语英语葡萄牙语

安装

Composer

使用 Composer 安装,只需运行以下命令

composer require bamboopayment/bamboopayment-sdk

或者您可以将需求手动添加到 composer.json 文件中

{
  "require" : {
    "bamboopayment/bamboopayment-sdk" : "0.1.*"
  }
}

然后运行以下命令进行安装

composer.phar install

手动安装

使用以下命令获取 BambooPayment SDK 的最新版本

git clone https://github.com/BambooPayment/sdk_php.git

入门

如果您使用 Composer,请使用自动加载功能

include "vendor/autoload.php";

用法

创建客户

包含有效示例的文件: examples/customers/create.php

要在后端使用 REST API 创建订单,您必须在控制器中提供一个包含客户数据的数组

    $bambooPaymentClient = new BambooPaymentClient(
        [
            'api_key' => PRIVATE_KEY,
            'testing' => true,
        ]
    );

    $customer = $bambooPaymentClient->customers->create(
        [
            'Email'          => 'testing@bamboopayment.com',
            'FirstName'      => 'PrimerNombre',
            'LastName'       => 'PrimerApellido',
            'DocNumber'      => 12345672,
            'DocumentTypeId' => 2,
            'PhoneNumber'    => '24022330',
            'BillingAddress' => [
                'AddressType'   => 1,
                'Country'       => 'UY',
                'State'         => 'Montevideo',
                'City'          => 'MONTEVIDEO',
                'AddressDetail' => '10000'
            ]
        ]
    );

创建购买

包含有效示例的文件: examples/purchases/create.php

要在后端使用 REST API 创建订单,您必须在控制器中提供一个包含购买数据的数组

    $bambooPaymentClient = new BambooPaymentClient(
        [
            'api_key' => PRIVATE_KEY,
            'testing' => true,
        ]
    );

    $purchase = $bambooPaymentClient->purchases->create(
        [
            'TrxToken'     => 'OT__klLNXDDkgAvk1KXG-i6SIUxo-ACnvpjf4jiYpVJ8SzQ_',
            'Order'        => '12345678',
            'Amount'       => 100,
            'Installments' => 1,
            'Customer'     => [
                'Email'          => 'juanperez123@bamboopayment.com',
                'FirstName'      => 'Juan',
                'LastName'       => 'Perez',
                'PhoneNumber'    => '099123123',
                'DocNumber'      => '12345672',
                'DocumentTypeId' => 2,
                'BillingAddress' => [
                    'AddressType'   => 1,
                    'Country'       => 'Uruguay',
                    'State'         => 'Montevideo',
                    'City'          => 'MONTEVIDEO',
                    'AddressDetail' => 'Av. Sarmiento 2260'
                ]
            ],
            'DataUY'       => [
                'IsFinalConsumer' => 'true',
                'Invoice'         => '1000',
                'TaxableAmount'   => 100
            ],
            'Currency'     => 'UYU',
            'Capture'      => 'true'
        ]
    );

贡献

  1. 分支它
  2. 创建您的功能分支(git checkout -b my-new-feature
  3. 使用 Angular 贡献指南git commit -am 'Add some feature')提交您的更改
  4. 将更改推送到分支(git push origin my-new-feature
  5. 运行 composer test 测试您的代码(composer test
  6. 创建新的拉取请求

支持

有关支持,请通过电子邮件 soportetec@bamboopayment.com 联系我们

许可

MIT 许可证(MIT)。有关更多信息,请参阅 许可文件