API-3.0-Java

SDK API-3.0 Java

Principais recursos

• Pagamentos por cartão de crédito.
• Pagamentos recorrentes.
  • Com autorização na primeira recorrência.
  • Com autorização a partir da primeira recorrência.
• Pagamentos por cartão de débito.
• Pagamentos por boleto.
• Pagamentos por transferência eletrônica.
• Cancelamento de autorização.
• Consulta de pagamentos.
• Geração de token para o cartão para armazenamento seguro

Limitações

Por envolver a interface de usuário da aplicação, o SDK funciona apenas como um framework para criação das transações. Nos casos onde a autorização é direta, não há limitação; mas nos casos onde é necessário a autenticação ou qualquer tipo de redirecionamento do usuário, o desenvolvedor deverá utilizar o SDK para gerar o pagamento e, com o link retornado pela Cielo, providenciar o redirecionamento do usuário.

Utilizando o SDK

Para criar um pagamento simples com cartão de crédito com o SDK, basta fazer:

Criando um pagamento com cartão de crédito

// ...// Configure seu merchantMerchantmerchant = newMerchant("MERCHANT ID", "MERCHANT KEY");
// Crie uma instância de Sale informando o ID do pagamentoSalesale = newSale("ID do pagamento");
// Crie uma instância de Customer informando o nome do clienteCustomercustomer = sale.customer("Comprador Teste");
// Crie uma instância de Payment informando o valor do pagamentoPaymentpayment = sale.payment(15700);
// Crie uma instância de Credit Card utilizando os dados de teste// esses dados estão disponíveis no manual de integraçãopayment.creditCard("123", "Visa").setExpirationDate("12/2018")
.setCardNumber("0000000000000001")
.setHolder("Fulano de Tal");
// Crie o pagamento na Cielotry {
// Configure o SDK com seu merchant e o ambiente apropriado para criar a vendasale = newCieloEcommerce(merchant, Environment.SANDBOX).createSale(sale);
// Com a venda criada na Cielo, já temos o ID do pagamento, TID e demais// dados retornados pela CieloStringpaymentId = sale.getPayment().getPaymentId();
// Com o ID do pagamento, podemos fazer sua captura, se ela não tiver sido capturada aindasale = newCieloEcommerce(merchant, Environment.SANDBOX).captureSale(paymentId, 15700, 0);
// E também podemos fazer seu cancelamento, se for o casosale = newCieloEcommerce(merchant, Environment.SANDBOX).cancelSale(paymentId, 15700);
} catch (CieloRequestExceptione) {
// Em caso de erros de integração, podemos tratar o erro aqui.// os códigos de erro estão todos disponíveis no manual de integração.CieloErrorerror = e.getError();
} catch (IOExceptione) {
e.printStackTrace();
}
// ...

Criando um card token para armazenamento seguro do cartão

// Configure seu merchantMerchantmerchant = newMerchant("MERCHANT ID", "MERCHANT KEY");
// Informe os dados do cartão que irá tokenizarCardTokencardToken = newCardToken().setBrand("Visa")
.setCardNumber("4532117080573700")
.setHolder("Comprador T Cielo")
.setExpirationDate("12/2018");
// Crie o Token para o cartãotry {
// // Configure o SDK com seu merchant e o ambiente apropriado para// gerar o tokencardToken = newCieloEcommerce(merchant, Environment.SANDBOX).createCardToken(cardToken);
StringgeneratedToken = cardToken.getCardToken();
System.out.printf("CardToken: %s\n", generatedToken);
} catch (CieloRequestExceptione) {
e.printStackTrace();
} catch (IOExceptione) {
e.printStackTrace();
}

Manual

Para mais informações sobre a integração com a API 3.0 da Cielo, vide o manual em: Integração API 3.0