Moip API v2 Java SDK for client integration.
Index
Java v1.7ˆ 
Add the fallowing dependency to build.gradle in the project:
compile group: 'br.com.moip', name: 'java-sdk', version: 'x.y.z'Add the fallowing dependency to pom.xml in the project:
<dependency>
<groupId>br.com.moip</groupId>
<artifactId>java-sdk</artifactId>
<version>x.y.z</version>
</dependency>
Is necessary to configure your gradle.properties with these informations:
artifactory_username=developer
artifactory_password=AP5xrUuUbJEha1sZCWpJqDABhwA
ossrhUsername= moip
ossrhPassword=rtg32oue@MOIP!
signing.keyId=FEBFADD1
signing.password=ittafer
signing.secretKeyRingFile=secring.gpgAfter this just to run:
./gradlew buildToday the deploy is performed manually so you need to run:
./gradlew uploadArchives -PossrhUsername="${MVN_USERNAME}" -PossrhPassword="${MVN_PASSWORD}" -Psigning.keyId="${SIGNING_KEY_ID}" -Psigning.password="${SIGNING_PASSWORD}" -Psigning.secretKeyRingFile="${SIGNING_SECRET_KEY_RING_FILE}"After to execute this command you can see the deploy into Nexus
This step by step will exemplify the integration flow with simple usage examples.
Before making requests to Moip API it's necessary make a setup, defining the environment and the authentication that will be used.
There are two ways to authenticate the request, some endpoints require a "highest authorization level", it will depend on the endpoint and type of request.
The following set will generate a hash Base64 with your Moip account token and key to authenticate.
Authentication auth = new BasicAuth("TOKEN", "SECRET");💡 If you don't know how to get your token and key, click here (you must be logged in).
The following set will create an OAuth authentication object.
💡 Click here to know how to get your token OAuth.
Authentication auth = new OAuth("TOKEN_OAUTH");After defining your authentication method, you have to set the client specifying the environment where you want to run your application. To set the client, choose the environment and pass the authentication (previously settled) as argument.
The test environment. You can use this to simulate all of your business scenarios.
Client client = new Client(Client.SANDBOX, auth);"The environment of truth" 👀. This is the environment where the real transactions run.
Client client = new Client(Client.PRODUCTION, auth);💡 Before going to production, you need to request homologation of your application here.
To complete the setup, you have to create an API instance, passing the client (previously settled) as argument.
API api = new API(client);✅ Check the setup functional example.
With the setup created, you can make requests to Moip API. To start the basic e-commerce flow you need to create a customer. After all, it's whom will order your products or services.
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")
)
);✅ Click on the icon for more customer functional examples. Read more about customer on API reference.
Customer created! It's buy time! 🎉
Order createdOrder = api.order().create(new OrderRequest()
.ownId("ORD-" + System.currentTimeMillis())
.amount(new OrderAmountRequest()
.currency("BRL")
.subtotals(new SubtotalsRequest()
.shipping(1000)
.addition(100)
.discount(500)
)
)
.addItem("Nome do produto 1", 1, "Mais info...", 100)
.addItem("Nome do produto 2", 2, "Mais info...", 200)
.addItem("Nome do produto 3", 3, "Mais info...", 300)
.customer(new CustomerRequest()
.id("CUSTOMER_ID")
)
.addReceiver(new ReceiverRequest()
.secondary("MOIP_ACCOUNT_ID", new AmountRequest().percentual(50), false)
)
);✅ Click on the icon for more order functional examples. Read more about order on API reference.
Alright! Do you have all you need? So, lets pay this order. 💰
Payment createdPayment = api.payment().create(new PaymentRequest()
.orderId("ORDER_ID")
.installmentCount(1)
.fundingInstrument(new FundingInstrumentRequest()
.creditCard(new CreditCardRequest()
.number("5555666677778884")
.cvc(123)
.expirationMonth("12")
.expirationYear("20")
.holder(new HolderRequest()
.fullname("Jose Portador da Silva")
.birthdate("1988-10-10")
.phone(new PhoneRequest()
.setAreaCode("11")
.setNumber("55667788")
)
.taxDocument(TaxDocumentRequest.cpf("22222222222"))
)
.store(true)
)
)
);✅ Click on the icon for more payment functional examples. Read more about payment on API reference.
If you want to see other functional examples, check this folder. 📁
| errors | cause | status |
|---|---|---|
| UnautorizedException | to authentication errors | == 401 |
| ValidationException | to validation errors | >= 400 && <= 499 (except 401) |
| UnexpectedException | to unexpected errors | >= 500 |
⚠️ To catch these errors, use the bellow treatment:
try {
Payment createdPayment = api.payment().create(
//...
);
} catch(UnauthorizedException e) {
// StatusCode == 401
} catch(UnexpectedException e) {
// StatusCode >= 500
} catch(ValidationException e) {
// StatusCode entre 400 e 499 (exceto 401)
}To stay up to date about the Moip Products, check the documentation.
Read more about the Moip APIs in API reference.
We offer many ways to contact us, so if you have a question, do not hesitate, talk to us whatever you need. For questions about API or business rules, contact us by support or slack:slack:. But, if you have a question or suggestion about the SDK, feel free to open an issue or pull request.
Do you have an enhancement suggest or found something to fix? Go ahead, help us and let your mark on Moip, open pull requests and issues against this project. If you want to do it, please read the CONTRIBUTING.md to be sure everyone follows the same structure and planning of the project. Remember, we ❤️ contributions. 🚀