Moip v2 Java SDK

O jeito mais simples e rápido de integrar o Moip a sua aplicação Java

Índice

• Instalação
• Configurando a autenticação
  • Por BasicAuth
  • Por OAuth
• Configurando o ambiente
• Exemplos de Uso:
  • Pedidos
    • Criação
    • Consulta
  • Pagamentos
    • Cartão de Crédito
    • Boleto
  • Clientes
    • Criação
    • Consulta
• Tratamento de Exceções
• Documentação
• Licença

Instalação

Adicionar no seu pom.xml:

<dependency>
    <groupId>br.com.moip</groupId>
    <artifactId>java-sdk</artifactId>
    <version>2.1.2</version>
</dependency>

Configurando a autenticação

Autenticando por BasicAuth

Authentication auth = new BasicAuth("TOKEN", "SECRET");

Autenticando por OAuth

Authentication auth = new OAuth("TOKEN_OAUTH");

Configurando o ambiente

Após definir o tipo de autenticação, é necessário gerar o client, informando em qual environment você quer executar suas ações:

Client client = new Client(Client.SANDBOX, auth);

Agora você pode instanciar a Api:

API api = new API(client);

Pedidos

Criação

Order createdOrder = api.order().create(new OrderRequest()
  .ownId("order_own_id")
  .addItem("Nome do produto", 1, "Mais info...", 100)
  .customer(new CustomerRequest()
    .ownId("customer_own_id")
    .fullname("Jose da Silva")
    .email("josedasilva@email.com")
    .birthdate(new ApiDateRequest().date(new Date()))
    .taxDocument(TaxDocumentRequest.cpf("22222222222"))
    .phone(new PhoneRequest().setAreaCode("11").setNumber("55443322"))
    .shippingAddressRequest(new ShippingAddressRequest().street("Avenida Faria Lima")
      .streetNumber("3064")
      .complement("12 andar")
      .city("São Paulo")
      .state("SP")
      .district("Itaim")
      .country("BRA")
      .zipCode("01452-000")
    )
  )
);

Consulta

String orderId = "ORD-HPMZSOM611M2";
Order order = api.order().get(orderId);
System.out.println(order.toString());

Pagamentos

Cartão de crédito

Payment createdPayment = api.payment().create(new PaymentRequest()
  .orderId("ORD-HPMZSOM611M2")
  .installmentCount(1)
  .fundingInstrument(new FundingInstrumentRequest()
    .creditCard(new CreditCardRequest()
      .hash(CC_HASH)
      .holder(new HolderRequest()
        .fullname("Jose Portador da Silva")
        .birthdate("1988-10-10")
        .phone(new PhoneRequest().setAreaCode("11").setNumber("55667788"))
        .taxDocument(TaxDocumentRequest.cpf("22222222222"))
      )
    )
  )
);

Boleto

Payment createdPayment = api.payment().create(new PaymentRequest()
  .orderId("ORD-GOHHIF4Z6PLV")
  .installmentCount(1)
  .fundingInstrument(new FundingInstrumentRequest()
    .boleto(new BoletoRequest()
      .expirationDate(new ApiDateRequest().date(new GregorianCalendar(2020, Calendar.NOVEMBER, 10).getTime()))
      .logoUri("http://logo.com")
      .instructionLines(new InstructionLinesRequest()
        .first("Primeira linha")
        .second("Segunda linha")
        .third("Terceira linha")
      )
    )
  )
);

Clientes

Criação

Customer customer = api.customer().create(new CustomerRequest()
  .ownId("CUS-" + System.currentTimeMillis())
  .fullname("Jose da Silva")
  .email("josedasilva@email.com")
  .birthdate(new ApiDateRequest().date(new Date()))
  .taxDocument(TaxDocumentRequest.cpf("22222222222"))
  .phone(new PhoneRequest().setAreaCode("11").setNumber("55443322"))
  .shippingAddressRequest(new ShippingAddressRequest().street("Avenida Faria Lima")
    .streetNumber("3064")
    .complement("12 andar")
    .city("São Paulo")
    .state("SP")
    .district("Itaim")
    .country("BRA")
    .zipCode("01452-000")
  )
);
System.out.println(customer.toString());

Consulta

String customerId = "CUS-Q3BL0CAJ2G33";
Customer customer = api.customer().get(customerId);
System.out.println(customer.toString());

Tratamento de Exceções

Quando ocorre algum erro na API, você deve utilizar o método hasUnexpectedError() para tratar erros inesperados e para erros de validação,deverá utilizar o método hasValidationError().

Documentação

Documentação oficial

Licença

The MIT License