Skip to content


Folders and files

Last commit message
Last commit date

Latest commit


Repository files navigation


Java library for Recurly, originally developed for Kill Bill, an open-source subscription management and billing system.

Getting started

The library is distributed via Maven Central:


The easiest way to get started is by looking at the code examples in

⚠️ The underlying HTTP client has changed between 0.34.0 and 0.100.0, see PR#390.


  1. Make sure you can build the project by running the smoke tests: mvn clean test
  2. Go to and create an account. This account will be used as a sandbox environment for testing.
  3. In your Recurly account, click on API Credentials (bottom of the left menu), click the Enable API Access button and write down your API Key.
  4. Verify the setup by running the recurly-java-library integration tests (make sure to update your API Key and Subdomain): mvn clean test -Pintegration -Dkillbill.payment.recurly.apiKey=1234567689abcdef -Dkillbill.payment.recurly.subDomain=mycompany
  5. Go to your Recurly account, you should see some data (e.g. account created).
  6. Congrats! You're all set!

Java properties

  • Set -Drecurly.debug=true to output debug information in the info log file
  • Set to configure the page size for Recurly API calls
  • To run the tests, one can use -Dkillbill.payment.recurly.currency=EUR to override the default USD currency used
  • You may optionally pass the TLS protocol used with the setting -Dkillbill.payment.recurly.tlsProtocol. Keep in mind that Recurly only supports TLSv1.2 and above. This setting defaults to TLSv1.2.

Push notifications

See for an example on how to set it up.


To build the project, use maven:

mvn clean install