Este SDK em PHP foi criado para facilitar a integração com a API BsPag, permitindo que aplicações PHP interajam com a plataforma BsPag para realizar e gerenciar transações financeiras. O SDK abstrai a complexidade da comunicação direta com a API, proporcionando métodos simples e eficazes para a criação, consulta e manipulação de transações de pagamento.

• PHP 8.1 ou superior
• Composer

Para instalar o SDK BsPag em seu projeto, utilize o Composer para adicionar o pacote:

composer require betalabs/bspag-api-php

Antes de utilizar o SDK, configure a API com sua chave de autenticação. A autenticação é realizada via cabeçalho com o token fornecido pela plataforma BsPag.

use Bspag\Bspag;

// Configuração da chave API
$apiKey = 'sua-chave-api-aqui';
$bspag = new Bspag($apiKey);

$transactionData = [
    'amount' => 100.00,
    'reference' => 'REF12345',
    'customer' => [
        'name' => 'João da Silva',
        'email' => '[email protected]',
        'phone' => '5199999999',
    ],
    'paymentMethod' => 'credit_card'
];

$response = $bspag->createTransaction($transactionData);

if ($response->isSuccess()) {
    echo "Transação criada com sucesso: " . $response->getTransactionId();
} else {
    echo "Erro ao criar transação: " . $response->getError();
}

• Criação de Transações: Suporte a diferentes métodos de pagamento (cartão de crédito, boleto, etc.).
• Cancelamento e Estorno: Realize cancelamentos ou estornos de transações diretamente pelo SDK.

A documentação completa da API BsPag está em desenvolvimento. (https://www.bspag.com.br).

Se encontrar algum problema ou tiver dúvidas, abra uma issue neste repositório ou entre em contato com nosso suporte.

This PHP SDK was developed to simplify the integration with the BsPag API, allowing PHP applications to interact with BsPag’s platform for performing and managing financial transactions. The SDK abstracts the complexity of direct API communication, providing easy-to-use methods for creating, querying, and managing payment transactions.

• PHP 8.1 or higher
• Composer

To install the BsPag SDK in your project, use Composer to add the package:

composer require betalabs/bspag-api-php

Before using the SDK, configure it with your API authentication key. Authentication is performed using a token provided by the BsPag platform in the request headers.

use Bspag\Bspag;

// Set up the API key
$apiKey = 'your-api-key-here';
$bspag = new Bspag($apiKey);

$transactionData = [
    'amount' => 100.00,
    'reference' => 'REF12345',
    'customer' => [
        'name' => 'John Doe',
        'email' => '[email protected]',
        'phone' => '5199999999',
    ],
    'paymentMethod' => 'credit_card'
];

$response = $bspag->createTransaction($transactionData);

if ($response->isSuccess()) {
    echo "Transaction successfully created: " . $response->getTransactionId();
} else {
    echo "Error creating transaction: " . $response->getError();
}

• Transaction Creation: Support for different payment methods (credit card, boleto, etc.).
• Cancellation and Refunds: Cancel or refund transactions directly using the SDK.

If you encounter any issues or have questions, please open an issue in this repository or contact our support team.