Safe2Pay JAVA SDK

Principais recursos

• Consulta de transações.
• Tokenização de cartão.
• Pagamentos.
  • Boleto bancário.
  • Cartão de crédito.
  • Bitcoin.
  • Cartão de débito.

Utilização

A integração com a API do Safe2Pay se dá pelo modelo RESTful, de forma a realizar a transferência segura e simplificada dos dados pelo formato JSON. Para facilitar o envio dos dados, deve-se montar um objeto para envio baseado nos modelos disponíveis, com exemplos abaixo, e a própria chamada do método desejado realizará o tratamento e conversão deste objeto para JSON.

Tratamento das respostas da API

Após o envio, a própria chamada devolverá a resposta em um objeto completo com as propriedades desta, onde um cast das classes de resposta permitirá o tratamento das propriedades do objeto de retorno de forma simplificada, sem a necessidade de criar os mesmos modelos em seu projeto. Utilize a Response para transações.

Dependências

• JDK >= 1.7

Pagamentos / Transações

A informação da forma de pagamento é dada por meio da propriedade PaymentMethod, onde deve ser informado o código correspondente ao método desejado:

1. Boleto Bancário;
2. Cartão de Crédito;
3. Bitcoin;
4. Cartão de Débito

O retorno do envio da transação trará um status para esta, que pode ser igual a:

1 = PENDENTE
2 = PROCESSAMENTO
3 = AUTORIZADO
4 = DISPONÍVEL
5 = EM DISPUTA
6 = DEVOLVIDO
7 = BAIXADO
8 = RECUSADO
11 = LIBERADO
12 = EM CANCELAMENTO

Criando uma venda com Boleto

Client.SetEnviroment("x-api-key");
//Inicializar método de pagamentoTransactionpayload = newTransaction();
//Ambiente de homologaçãopayload.setIsSandbox(true);
//Descrição geral payload.setApplication("Teste SDK JAVA");
//Nome do vendedorpayload.setVendor("João da Silva");
//Url de callbackpayload.setCallbackUrl("https://callbacks.exemplo.com.br/api/Notify");
//Código da forma de pagamento// 1 - Boleto bancário// 2 - Cartão de crédito// 3 - Criptomoeda// 4 - Cartão de débito // 10 - Débito em conta payload.setPaymentMethod("1");
//Informa o objeto de pagamento//Objeto de pagamento - para boleto bancáriopayload.setPaymentObject(newBankSlip() {
{
setDueDate("16/09/2019");
setCancelAfterDue(false);
setIsEnablePartialPayment(false);
setPenaltyRate(2.00);
setInterestRate(0.40);
setInstruction("Instrução de Exemplo");
setMessage(newArrayList<String>() {
{
add("mensagem 1");
add("mensagem 2");
add("mensagem 3");
}
});
}
});
//Lista de produtos incluídos na cobrançapayload.setProducts(newArrayList<Product>() {
{
add(newProduct("001", "Teste 1", 10, 1.99));
add(newProduct("002", "Teste 2", 3, 2.50));
add(newProduct("003", "Teste 3", 7, 1));
}
});
//Dados do clientepayload.setCustomer(newCustomer() {
{
setName("João da Silva");
setIdentity("54557795000162");
setEmail("safe2pay@safe2pay.com.br");
setAddress(newAddress() {
{
setZipCode("90670090");
setStreet("Logradouro");
setNumber("123");
setDistrict("Higienopolis");
setStateInitials("RS");
setCityName("Porto Alegre");
setCountryName("Brasil");
}
});
}
});
ResponseSafe2Payresponse = PaymentAPI.BankSlip(payload);
// ...

Criando uma venda com cartão de crédito

//Inicializar método de pagamentoTransactionpayload = newTransaction();
//Ambiente de homologaçãopayload.setIsSandbox(true);
//Descrição geral payload.setApplication("Teste SDK JAVA");
//Nome do vendedorpayload.setVendor("João da Silva");
//Url de callbackpayload.setCallbackUrl("https://callbacks.exemplo.com.br/api/Notify");
//Código da forma de pagamento// 1 - Boleto bancário// 2 - Cartão de crédito// 3 - Criptomoeda// 4 - Cartão de débito // 10 - Débito em conta payload.setPaymentMethod("2");
//Informa o objeto de pagamento//Objeto de pagamento - para boleto bancáriopayload.setPaymentObject(newCreditCard() {
{
setHolder("João da Silva");
setCardNumber("4024007153763191");
setExpirationDate("12/2019");
setSecurityCode("241");
}
});
//Lista de produtos incluídos na cobrançapayload.setProducts(newArrayList<Product>() {
{
add(newProduct("001", "Teste 1", 10, 1.99));
add(newProduct("002", "Teste 2", 3, 2.50));
add(newProduct("003", "Teste 3", 7, 1));
}
});
//Dados do clientepayload.setCustomer(newCustomer() {
{
setName("João da Silva");
setIdentity("54557795000162");
setEmail("safe2pay@safe2pay.com.br");
setAddress(newAddress() {
{
setZipCode("90670090");
setStreet("Logradouro");
setNumber("123");
setDistrict("Higienopolis");
setStateInitials("RS");
setCityName("Porto Alegre");
setCountryName("Brasil");
}
});
}
});
ResponseSafe2Payresponse = PaymentAPI.CreditCard(payload);
// ...

Criando uma venda com Bitcoin

Client.SetEnviroment("x-api-key");
//Inicializar método de pagamentoTransactionpayload = newTransaction();
//Ambiente de homologaçãopayload.setIsSandbox(true);
//Descrição geral payload.setApplication("Teste SDK JAVA");
//Nome do vendedorpayload.setVendor("João da Silva");
//Url de callbackpayload.setCallbackUrl("https://callbacks.exemplo.com.br/api/Notify");
//Código da forma de pagamento// 1 - Boleto bancário// 2 - Cartão de crédito// 3 - Criptomoeda// 4 - Cartão de débito // 10 - Débito em conta payload.setPaymentMethod("3");
//Lista de produtos incluídos na cobrançapayload.setProducts(newArrayList<Product>() {
{
add(newProduct("001", "Teste 1", 10, 1.99));
add(newProduct("002", "Teste 2", 3, 2.50));
add(newProduct("003", "Teste 3", 7, 1));
}
});
//Dados do clientepayload.setCustomer(newCustomer() {
{
setName("João da Silva");
setIdentity("54557795000162");
setEmail("safe2pay@safe2pay.com.br");
setAddress(newAddress() {
{
setZipCode("90670090");
setStreet("Logradouro");
setNumber("123");
setDistrict("Higienopolis");
setStateInitials("RS");
setCityName("Porto Alegre");
setCountryName("Brasil");
}
});
}
});
ResponseSafe2Payresponse = PaymentAPI.CryptoCurrency(payload);
// ...

Criando uma venda com cartão de débito

Client.SetEnviroment("x-api-key");
//Inicializar método de pagamentoTransactionpayload = newTransaction();
//Ambiente de homologaçãopayload.setIsSandbox(true);
//Descrição geral payload.setApplication("Teste SDK JAVA");
//Nome do vendedorpayload.setVendor("João da Silva");
//Url de callbackpayload.setCallbackUrl("https://callbacks.exemplo.com.br/api/Notify");
//Código da forma de pagamento// 1 - Boleto bancário// 2 - Cartão de crédito// 3 - Criptomoeda// 4 - Cartão de débito // 10 - Débito em conta payload.setPaymentMethod("4");
//Informa o objeto de pagamento//Objeto de pagamento - para boleto bancáriopayload.setPaymentObject(newCreditCard() {
{
setHolder("João da Silva");
setCardNumber("4024007153763191");
setExpirationDate("12/2019");
setSecurityCode("241");
}
});
//Lista de produtos incluídos na cobrançapayload.setProducts(newArrayList<Product>() {
{
add(newProduct("001", "Teste 1", 10, 1.99));
add(newProduct("002", "Teste 2", 3, 2.50));
add(newProduct("003", "Teste 3", 7, 1));
}
});
//Dados do clientepayload.setCustomer(newCustomer() {
{
setName("João da Silva");
setIdentity("54557795000162");
setEmail("safe2pay@safe2pay.com.br");
setAddress(newAddress() {
{
setZipCode("90670090");
setStreet("Logradouro");
setNumber("123");
setDistrict("Higienopolis");
setStateInitials("RS");
setCityName("Porto Alegre");
setCountryName("Brasil");
}
});
}
});
ResponseSafe2Payresponse = PaymentAPI.DebitCard(payload);
// ...

Tokenizando um cartão

Client.SetEnviroment("x-api-key");
CreditCardcredit = newCreditCard();
credit.setHolder("João da Silva");
credit.setCardNumber("4024007153763191");
credit.setExpirationDate("12/2019");
credit.setSecurityCode("241");
ResponseSafe2Payresponse = TokenizationAPI.Create(credit);
// ...

Consultar transação

intId = 852920;
Client.SetEnviroment("x-api-key");
ResponseSafe2Payresponse = TransactionAPI.Get(Id);
// ...

Informações adicionais / Contato

A orientação sobre a utilização da API também está disponível na documentação de referência da API, disponível aqui, porém salientamos que ela se encontra em atualização para a nova versão da API.

Em caso de dúvidas, ficamos à disposição em nossos canais ou diretamente pelo e-mail integracao@safe2pay.com.br.