https://github.com/stil4m/mollie-api
Mollie API for Java
https://github.com/stil4m/mollie-api
Last synced: about 1 month ago
JSON representation
Mollie API for Java
- Host: GitHub
- URL: https://github.com/stil4m/mollie-api
- Owner: stil4m
- Created: 2015-11-05T07:18:23.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2019-01-30T11:36:56.000Z (over 6 years ago)
- Last Synced: 2025-03-24T06:51:52.831Z (about 2 months ago)
- Language: Java
- Homepage:
- Size: 207 KB
- Stars: 14
- Watchers: 4
- Forks: 14
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
Travis says: 
# Mollie API Java
## License
The source code is licensed under the [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0).
## Java
This library requires Java 8.
## Dependencies
```
org.apache.httpcomponents:httpclient:4.5.X
com.fasterxml.jackson.core:jackson-annotations:2.8.X
com.fasterxml.jackson.core:jackson-databind:2.8.X
```
## Maven or Gradle
This library is available on my [personal maven repository](https://github.com/stil4m/maven-repository), which is hosted on GitHub.
To use this with library with Maven, add the following snippets to your `pom.xml` file:
```
...
stil4m-releases
stil4m-releases
https://github.com/stil4m/maven-repository/raw/master/releases/
...
nl.stil4m
mollie-api
2.7.0
...
```
To use this with library with Gradle, add the following snippets to your `build.gradle` file:
```
...
repositories {
...
maven {
url "https://github.com/stil4m/maven-repository/raw/master/releases/"
}
}
...
dependencies {
...
runtime 'nl.stil4m:mollie-api:2.7.0'
}
```
## Build the JAR
To build the `JAR` you can run `mvn install`.
## Usage
### Setup
You can use the API with a static defined Mollie API key `Client` or a dynamic key `DynamicClient`.
#### Static
```
Client client = new ClientBuilder()
.withApiKey("XXX")
.build();
```
#### Dynamic
```
DynamicClient client = new DynamicClientBuilder()
.build();
```
#### Configuration
Both clients make use of the Jackson `ObjectMapper` and the Apache HTTP `HttpClient`. These can be respectively configured using `withMapper` and `withClient`.
> Note 1: The library uses `jackson-datatype-jdk8`. To make sure that the `ObjectMapper` can serialise `java.util.Optional` the library registers the module in the `ObjectMapper`.
> Note 2: The `ObjectMapper` has the `FAIL_ON_UNKNOWN_PROPERTIES` property disabled by default to make the deserialisation more forgiving ([#25](https://github.com/stil4m/mollie-api/issues/25)). If you inject your own `ObjectMapper`, please consider disabling this property: When Mollie adds a property and you do not disable this, and they do this now and then, deserialisation will fail with an exception.
### API Calls
The API is separated into different concepts:
* Methods: Used to read the available payment methods.
* Issuers: Used to read the available issuers per payment method.
* Payments: Used to create read and delete payments
* Refunds: Used to create read and delete refunds on payments
* Status: Used to verify the validity of the used API key
All concepts can be retrieved from the client using the following format `client.()`.
For example you can create a payment as follows:
```
Client client = new ClientBuilder()
.withApiKey(""XXX")
.build();
client.payments().create(new CreatePayment(...));
```
## Bugs
When you find bugs, please report them in the issue tracker. I pursuit to fix them within a few days. If you like provide a pull request with the supporting unit tests.