README

GETNET SDK PHP - API v1.0.1

E-commerce

Todos os passos e processos referentes à integração com o sistema de captura e autorização de transações financeiras da Getnet via as funcionalidades da API.

Documentação oficial

• https://api.getnet.com.br/v1/doc/api

Composer

"klebervmv/getnet-sdk": "1.0.*"

or run

composer require klebervmv/getnet-sdk

Recuperar bandeira do cartão de credito

//o parametro inserido dentro do Bin() são os 6 primeiros digitos do cartão
// Autenticação da API (client_id, client_secret, env)
$getnet = new Getnet("client_id","client_secret", "SANDBOX");
$getnet->Bin("515590");
//Bandeira do cartão
$getnet->getBrand();

Salvar Cartão de credito na getnet

// Autenticação da API (client_id, client_secret, env)
$getnet = new Getnet("client_id","client_secret", "SANDBOX");
//$numCard = numero do cartão de crédito
//$clientId = id do cliente no ecommerce
//$verify = true ou false informa se é para executar uma verificação se o cartão está ativo
//$brand = bandeira do cartão
//$expirationMonth = mês do vencimento
//$expirationYear = ano do vencimento
//$holderName = nome como no cartão
//$cvv = cvv

$card = (new Card(new Token($numCard, $clientId, $getnet)))
                ->setVerifyCard($verify)
                ->setBrand($brand)
                ->setExpirationMonth($expirationMonth)
                ->setExpirationYear($expirationYear)
                ->setCardholderName($holderName)
                ->setSecurityCode($cvv);

        $saveCard = $getnet->saveCard($card, $clientId);

 $cardId = $saveCard->getCardId();

Recuperar dados do cartão salvo

//$cardId = id do cartão salvo na getnet
// Autenticação da API (client_id, client_secret, env)
$getnet = new Getnet("client_id","client_secret", "SANDBOX");
$response = $getnet->getSavedCard($cardId);

//retorno
 $response->getLast_four();
 $response->getNumberToken();
 $response->getExpiration_month();
 $response->getExpiration_year();
 $response->getBrand();

Exemplo Autorização com cartão de crédito MasterCard R$10,00 em 2x

// Autenticação da API (client_id, client_secret, env)
$getnet = new Getnet("client_id","client_secret", "SANDBOX");

// Inicia uma transação
$transaction = new Transaction();

// Dados do pedido - Transação
$transaction->setSellerId("saler_id");
$transaction->setCurrency("BRL");
$transaction->setAmount("1000");

// Gera token do cartão - Obrigatório
$card = new Token("5155901222280001", "customer_21081826", $getnet);

// Dados do método de pagamento do comprador
$transaction->Credit("")
    ->setAuthenticated(false)
    ->setDynamicMcc("1799")
    ->setSoftDescriptor("LOJA*TESTE*COMPRA-123")
    ->setDelayed(false)
    ->setPreAuthorization(true)
    ->setNumberInstallments("2")
    ->setSaveCardData(false)
    ->setTransactionType("FULL")
    ->Card($card) 
        ->setBrand("MasterCard")
        ->setExpirationMonth("12")
        ->setExpirationYear("20")
        ->setCardholderName("Kleberton Vilela")
        ->setSecurityCode("123");
// Dados pessoais do comprador
$transaction->Customer("customer_21081826")
    ->setDocumentType("CPF")
    ->setEmail("customer@email.com.br")
    ->setFirstName("Kleberton")
    ->setLastName("Paz")
    ->setName("Kleberton Vilela")
    ->setPhoneNumber("5551999887766")
    ->setDocumentNumber("12345678912")
    ->BillingAddress("90230060")
        ->setCity("São Paulo")
        ->setComplement("Sala 1")
        ->setCountry("Brasil")
        ->setDistrict("Centro")
        ->setNumber("1000")
        ->setPostalCode("90230060")
        ->setState("SP")
        ->setStreet("Av. Brasil");
// Dados de entrega do pedido
$transaction->Shippings("")
    ->setEmail("customer@email.com.br")
    ->setFirstName("João")
    ->setName("João da Silva")
    ->setPhoneNumber("5551999887766")
    ->ShippingAddress("90230060")
        ->setCity("Porto Alegre")
        ->setComplement("Sala 1")
        ->setCountry("Brasil")
        ->setDistrict("São Geraldo")
        ->setNumber("1000")
        ->setPostalCode("90230060")
        ->setState("RS")
        ->setStreet("Av. Brasil");
// Detalhes do Pedido
$transaction->Order("123456")
    ->setProductType("service")
    ->setSalesTax("0");
$transaction->setSellerId("saler_id");
$transaction->setCurrency("BRL");
$transaction->setAmount("1000");

// FingerPrint - Antifraude
$transaction->Device("hash-device-id")->setIpAddress("127.0.0.1");

// Processa a Transação
$response = $getnet->Authorize($transaction);

// Resultado da transação - Consultar tabela abaixo
$response->getStatus();

CONFIRMA PAGAMENTO (CAPTURA)

// Autenticação da API (client_id, client_secret, env)
$getnet = new Getnet("client_id","client_secret", "SANDBOX");

// Processa a confirmação da autorização
$capture = $getnet->AuthorizeConfirm("PAYMENT_ID");

// Resultado da transação - Consultar tabela abaixo
$capture->getStatus();

CANCELA PAGAMENTO (CRÉDITO e DÉBITO)

// Autenticação da API (client_id, client_secret, env)
$getnet = new Getnet("client_id","client_secret", "SANDBOX");

$cancel = $getnet->AuthorizeCancel("[PAYMENT_ID]", [AMOUNT]);

// Resultado da transação - Consultar tabela abaixo
$cancel->getStatus();

BOLETO BANCÁRIO (SANTANDER)

// Autenticação da API (client_id, client_secret, env)
$getnet = new Getnet("client_id","client_secret", "SANDBOX");
$transaction = new Transaction();
$transaction->setSellerId("saler_id");
$transaction->setCurrency("BRL");
$transaction->setAmount("1000");

$transaction->Boleto("000001946598")
    ->setDocumentNumber("170500000019763")
    ->setExpirationDate("21/11/2018")
    ->setProvider("santander")
    ->setInstructions("Não receber após o vencimento");

$transaction->Customer()
    ->setDocumentType("CPF")
    ->setFirstName("Kleberton")
    ->setName("Kleberton Vilela")
    ->setDocumentNumber("12345678912")
    ->BillingAddress("90230060")
    ->setCity("São Paulo")
    ->setComplement("Sala 1")
    ->setCountry("Brasil")
    ->setDistrict("Centro")
    ->setNumber("1000")
    ->setPostalCode("90230060")
    ->setState("SP")
    ->setStreet("Av. Brasil");

$transaction->Order("123456")
    ->setProductType("service")
    ->setSalesTax("0");

$response = $getnet->Boleto($transaction);

// Resultado da transação - Consultar tabela abaixo
$response->getStatus();

Possíveis status de resposta de uma transação

Cartões para testes

Ambientes disponíveis

Meios de Pagamento

Métodos de Pagamento