README

adyen-sdk

SDK Não Oficial para integração a partir de aplicações PHP com as APIs REST da Adyen

Requisitos

• PHP >= 5.4
• curl extension

Instalação

Adicione o pacote adyen-sdk ao seu projeto utilizando composer:

composer require gpupo/adyen-sdk

Uso

Setup Inicial

//...
use Gpupo\AdyenSdk\Factory;

$adyenSdk = Factory::getInstance()->setup([
    'client_user'       => 'foo',
    'client_password'   => 'bar',
    'version'           => 'test'
]);

Registro (log)

//...
use Monolog\Logger;
use Monolog\Handler\StreamHandler;
//..
$logger = new Logger('foo');
$logger->pushHandler(new StreamHandler('Resources/logs/main.log', Logger::DEBUG));
$adyenSdk->setLogger($logger);

Transações

Nos exemplos abaixo considere que $data possui esta estrutura

Criação de uma nova transação com cartão de crédito

//...
$request = $adyenSdk->createRequest($data);
$request->setEncryptedData($hash);
$manager = $adyenSdk->factoryManager('request');
$response = $manager->submit($request);

Criação de uma nova transação com boleto bancário

//...
$request->setType('boleto');
$response = $manager->submit($request); //acesso à url do boleto e outras informações
$response->getBarCodeReference(); // Linha digitável
$response->getExpirationDate(); // Data de Vencimento
$response->getUrl(); // Url Do Boleto
$response->getData(); // Parâmetro usado para compor a url para o boleto

Captura de uma transação com cartão de crédito

//...
$request = $adyenSdk->createRequest($data);
$response = $manager->capture($request);

Estorno parcial em uma transação

//...
$request = $adyenSdk->createRequest($data);
$response = $manager->refund($request, 10.99);

No exemplo acima é executado o estorno de R$10.99

Cancelamento de uma transação

//...
$request = $adyenSdk->createRequest($data);
$response = $manager->cancelOrRefund($request);

Informações contidas em cada Resposta

Valores possíveis para $response->getResultCode():

Valores possíveis para $response->getCode():

Erros

Valores possíveis para $response->getErrorCode():

Propriedades dos objetos

A lista abaixo é gerada automaticamente a partir da saída da execução dos testes unitários:

Client\Client

• Acesso ao client
• Sucesso ao definir options
• Gerencia uri de recurso

Factory

• Centraliza criacao de objetos

Payment\Request\Decorator\BoletoDecorator

• To json

Payment\Request\Decorator\CreditCardDecorator

• To json

Payment\Request\Manager

• É o administrador de requisições
• Executa a requisição de um novo boleto e devolve objeto específico
• Executa a autorização de um pagamento com cartão de crédito e devolve objeto específico
• Em requisições mal sucedidas entrega objeto problemático
• Executa a requisição de uma captura
• Executa a requisição Refund()
• Executa a requisição CancelOrRefund()

Payment\Request\Order\Order

• Possui método getId() para acessar Id
• Possui método setId() que define Id
• Possui método getShopper() para acessar Shopper
• Possui método setShopper() que define Shopper
• Possui método getAmount() e setAmount() para acessar e definir Amount
• Possui método getAmountInt() para acessar e definir Amount em formato "minor units"
• Possui método getBillingAddress() para acessar BillingAddress
• Possui método setBillingAddress() que define BillingAddress
• Possui método getShippingAddress() para acessar ShippingAddress
• Possui método setShippingAddress() que define ShippingAddress
• Possui método getInstallments() para acessar Installments
• Possui método setInstallments() que define Installments
• Possui método getDeliveryDate() para acessar DeliveryDate
• Possui método setDeliveryDate() que define DeliveryDate
• Possui método getCreatedAt() para acessar CreatedAt
• Possui método setCreatedAt() que define CreatedAt
• Entidade é uma Coleção

Payment\Request\Order\Shopper

• Possui método getFirstName() para acessar FirstName
• Possui método setFirstName() que define FirstName
• Possui método getLastName() para acessar LastName
• Possui método setLastName() que define LastName
• Possui método getIp() para acessar Ip
• Possui método setIp() que define Ip
• Possui método getEmail() para acessar Email
• Possui método setEmail() que define Email
• Possui método getSocialSecurityNumber() para acessar SocialSecurityNumber informado com Left Pad (zeros à esquerda)
• Possui método setSocialSecurityNumber() que define SocialSecurityNumber
• Entidade é uma Coleção

Payment\Request\Request

• Possui método getOrder() para acessar Order
• Possui método setOrder() que define Order
• Possui método getType() para acessar Type
• Possui método setType() que define Type
• Possui método getEncryptedData() para acessar EncryptedData
• Possui método setEncryptedData() que define EncryptedData
• Entidade é uma Coleção

Payment\Response\Decorator\BoletoDecorator

• Custom fields
• Generic fields

Payment\Response\Decorator\CaptureDecorator

• Custom fields
• Generic fields

Payment\Response\Decorator\CreditCardDecorator

• Custom fields
• Generic fields

Payment\Response\Decorator\ProblematicDecorator

• Custom fields
• Generic fields

Payment\Response\Decorator\RefundDecorator

• Custom fields
• Generic fields