Introdução

Nesta wiki pode ser encontrado assuntos como instalação, verificação de exemplos e configurações avançadas em nossa SDK. Esta documentação é específica apenas para usos do SDK.

Download

Existem duas maneiras de instalar o Krypton Pay PHP SDK. A primeira é usando o Composer como seu gerenciador de dependências. Se você preferir não usar o composer e quiser fazer o download do pacote zipado, você pode fazer isso seguindo as instruções de Download Direto.

Download Composer Download Krypton Pay SDK Source

Dependências

    PHP >= 5.6

Instalação

Composer

O Composer é a maneira recomendada de instalar o SDK. Como alternativa, se você preferir não usar o Composer, mas quiser instalar nosso SDK, faça isso fazendo um download direto.

Atualmente, o Krypton Pay PHP SDK está disponível em Packagist . Para usá-lo em seu projeto, você precisa incluí-lo como uma dependência no arquivo composer.json de seu projeto.

Passo 1

Baixe o Composer se ainda não estiver instalado.

Passo 2

Vá para o diretório de seu projeto. Se você não tiver um, basta criar um diretório. 

$ cd project

Passo 3

Execute o comando de instalação do SDK via composer 

$ composer require kryptonpay/kryptonpay-php-sdk

Obs.: Substitua o composer por composer.phar, se necessário. A saída deve ser algo como isto: 

Using version ^2.0 for kryptonpay/kryptonpay-php-sdk
./composer.json has been updated
Loading composer repositories with package information
Updating dependencies (including require-dev)
Package operations: 16 installs, 0 updates, 0 removals
- Installing symfony/polyfill-mbstring (v1.15.0): Loading from cache
- Installing symfony/var-dumper (v5.0.7): Loading from cache
- Installing tightenco/collect (v7.6.1): Downloading (100%)
- Installing symfony/polyfill-ctype (v1.15.0): Loading from cache
- Installing symfony/inflector (v5.0.7): Loading from cache
- Installing symfony/property-access (v5.0.7): Loading from cache
- Installing symfony/serializer (v5.0.7): Loading from cache
- Installing ralouphie/getallheaders (3.0.3): Downloading (100%)
- Installing psr/http-message (1.0.1): Downloading (100%)
- Installing guzzlehttp/psr7 (1.6.1): Downloading (100%)
- Installing guzzlehttp/promises (v1.3.1): Downloading (100%)
- Installing guzzlehttp/guzzle (6.5.2): Downloading (100%)
- Installing symfony/translation-contracts (v2.0.1): Loading from cache
- Installing symfony/translation (v5.0.7): Loading from cache
- Installing nesbot/carbon (2.32.2): Loading from cache
- Installing kryptonpay/kryptonpay-php-sdk (2.0.16): Downloading (100%)
Writing lock file
Generating autoload files

Passo 4

É isso aí. Você tem o Krypton Pay PHP SDK instalado!

Download Direto

O Composer é a maneira recomendada de instalar o SDK. Como alternativa, se você preferir não usar o Composer, mas quiser instalar nosso SDK, faça isso fazendo um download direto.

Caso não queira quiser usar o Composer, poderá obter o zip que contém o Krypton Pay PHP SDK com todas as suas dependências. Portanto as atualizações deverão ser feitas manualmente, obtendo sempre o ultimo release disponível.

Passo 1

Baixar arquivo zip com a release desejada.

O nome do arquivo será algo como: kryptonpay-php-sdk-*.zip

Para ver a lista com todas as releases clique aqui.

Obs.: Recomendado a última disponível.

Passo 2

Vá para o diretório de seu projeto. Se você não tiver um, basta criar um diretório. 

$ cd project

Passo 3

Descompacte e copie o diretório para o local do projeto 

$ unzip kryptonpay-php-sdk-*.zip -d /path/to/directory

Passo 4

É isso aí. Você tem o Krypton Pay PHP SDK instalado!

Primeira chamada

Depois de concluir a instalação , você poderá fazer a primeira chamada. Para escrever um aplicativo que use o SDK, você criará seu primeiro script PHP que criará uma transação do Krypton Pay.

Introdução

Primeiro, crie um arquivo first.php no local raiz do projeto. Como alternativa, você pode copiar o arquivo completo aqui.

1. Carregando o pacote SDK

Carregue automaticamente o pacote SDK. Isso incluirá todos os arquivos e classes no seu carregador automático. Observe que, se você baixou nosso SDK usando o Composer, substitua PayPal-PHP-SDK por vendor. Isso se aplica a todo código de exemplo em nosso SDK.

Caso esteja utilizando o Composer: 

// Used for composer based installation
require __DIR__ . '/vendor/autoload.php';

Caso esteja utilizando o Download Direto: 

// Use below for direct download installation
require __DIR__ . '/KryptonPay-PHP-SDK/autoload.php';

2. Token de acesso

Forneça o Token de acesso. Substitua o dado por seu Token, que pode ser obtido aqui

// After Step 1
$apiContext = new KryptonPay\Api\ApiContext();
$apiContext->setApiToken('eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c');

3. Ambiente

Forneça o qual ambiente a chamada deverá ser executada:

// After Step 2
$apiContext->setIsSandbox(true);

4. Crie uma transação

4.1 Inicie uma transação incluindo os dados mencionados aqui:

// After Step 3
$transaction = new KryptonPay\Api\Transaction();
$transaction->setPaymentType(KryptonPay\Api\ApiContext::SLIPBANK);
$transaction->setIsQuickSale(false);
$transaction->setApplication(1);
$transaction->setReference('0001');

4.2 Crie um objeto pagador:

$payerAddress = new KryptonPay\Api\Address();
$payerAddress->setStreet('Rua A');
$payerAddress->setNumber('1');
$payerAddress->setDistrict('Bairro');
$payerAddress->setZipCode('12345678');
$payerAddress->setComplement('Complemento');
$payerAddress->setStateInitials('MG');
$payerAddress->setCityName('Belo Horizonte');
$payerAddress->setCountryName('Brasil');

$payer = new KryptonPay\Api\Payer();
$payer->setType(KryptonPay\Api\ApiContext::PERSON_NATURAL);
$payer->setBirthDate('1995-08-06');
$payer->setName('Nome Pagador');
$payer->setIdentity('12345678911');
$payer->setEmail('usuario@provedor.com');
$payer->setPhone('31999999999');
$payer->setAddress($payerAddress);

$transaction->setPayer($payer);

4.3 Crie um objeto item:

$item = new KryptonPay\Api\Item();
$item->setCode('0001');
$item->setDescription('Item nome');
$item->setUnitPrice(1.0);
$item->setQuantity(1);
$transaction->addItem($item);

4.4 Opcionalmente, crie um objeto Split:

$split = new KryptonPay\Api\Split();
$split->setDocument('12345678911');
$split->setValue(1.00);
//Value or Tax
//$split->setTax(1.00);
$transaction->addSplit($split);

4.5 Crie um objeto com o método de pagamento escolhido:

    Boleto bancário
$slipBank = new KryptonPay\Api\Slip();
$slipBank->setValue(1.00);
$slipBank->setInstruction('Pagar em qualquer correspondente bancário');
$slipBank->setDueDate('2050-01-01');
$slipBank->addObservation('Observação 01');
$slipBank->addObservation('Observação 02');
$transaction->setSlip($slipBank);
    Cartão de Crédito
$cardholderAddress = new KryptonPay\Api\Address();
$cardholderAddress->setStreet('Rua A');
$cardholderAddress->setNumber('1');
$cardholderAddress->setDistrict('Bairro');
$cardholderAddress->setZipCode('12345678');
$cardholderAddress->setComplement('Complemento');
$cardholderAddress->setStateInitials('MG');
$cardholderAddress->setCityName('Belo Horizonte');
$cardholderAddress->setCountryName('Brasil');

$creditCard = new KryptonPay\Api\CreditCard();
$creditCard->setValue(5.00);
$creditCard->setNumberInstallments(1);
$creditCard->setSaleDescription('LOJA*TESTE*COMPRA-123');
$creditCard->setCardNumber('1111222233334444');
$creditCard->setCardholder('John Doe');
$creditCard->setSecurityCode('111');
$creditCard->setMonthExpiration('01');
$creditCard->setYearExpiration('25');
$creditCard->setAddress($cardholderAddress);
$transaction->setCreditCard($creditCard);

5. Criando uma chamada

Inclua a transação no contexto da API e inicie a chamada de transação passando o objeto contexto:

/// After Step 4
try {
    $apiContext->setTransaction($transaction);
    return KryptonPay\Api\KryptonPay::createPayment($apiContext);
}
catch (\Exception $e) {
    // This will print the detailed information on the exception.
    //REALLY HELPFUL FOR DEBUGGING
    echo $ex->getData();
}