README

这是一个简单的库，可以简化与 WebServices Pix 的集成。

安装

要安装此库，只需执行以下命令

composer require pedrobruning/phpix

可用服务

• OpenPix (https://developers.openpix.com.br/api/)

要求

• 需要 PHP 8.1 或更高版本。
• 需要 symfony/http-client 包，版本 ^6.0

使用方法

要使用此库，请参考以下示例。

<?php
require __DIR__ . 'vendor/autoload.php';

//DEPENDÊNCIAS
use PedroBruning\PhPix\Services\PhPixServiceFactory;
use PedroBruning\PhPix\Services\Providers;
use Symfony\Component\HttpClient\HttpClient; 

//INSTÂNCIA
//CRIAÇÃO DO CLIENT: Se o provider que você está utilizando precisa de token de authorization você deve informa-lo na criação do client
$client = HttpClient::create();
$client = $client->withOptions([
    'headers' => ['Authorization' => 'YOUR_TOKEN']
]);

$provider = Providers::YourProvider;
$phPixService = PhPixServiceFactory::make($provider, $client);

收款

通过 ID 获取收款

$chargeId = 'chargeId';
$charge = $phPixService->charges()->getById($chargeId);

通过过滤器获取收款

$filter = [
    'start' => '2021-03-01T17:28:51.882Z',
    'end' => '2021-03-05T17:28:51.882Z',
    'status' => 'ACTIVE',
];
$charges = $phPixService->charges()->getByFilter($filter);

创建收款

可以用于创建收款的全部字段都可以在 Request 类中查询到。

use PedroBruning\PhPix\Models\OpenPix\ChargeRequest;
$chargeRequest = new ChargeRequest(
    correlationId: 'validCorrelation',
    value: 100,
    comment: 'validComment',
    identifier: 'validIdentifier',
    customer: [
        'name' => 'Test Customer',
        'email' => 'email@test.com',
        'phone' => '(00) 00000-0000',
        'taxID' => '000000000000'
    ]
);
$charge = $phPixService->charges()->create($chargeRequest);

退款

通过 ID 获取退款

$refundId = 'refundId';
$refund = $phPixService->refunds()->getById($refundId);

获取所有退款

$refund = $phPixService->refunds()->getAll();

创建退款

可以用于创建退款的全部字段都可以在 Request 类中查询到。

use PedroBruning\PhPix\Models\OpenPix\RefundRequest;
$refundRequest = new RefundRequest(
    value: 100,
    transactionEndToEndId: 'validTransactionEndToEndId',
    correlationId: 'validCorrelation'
);
$refund = $phPixService->refunds()->create($refundRequest);