{"id":18716363,"url":"https://github.com/killbill/killbill-currency-plugin","last_synced_at":"2025-11-10T10:30:22.724Z","repository":{"id":180672701,"uuid":"665087028","full_name":"killbill/killbill-currency-plugin","owner":"killbill","description":"A default currency plugin based on a set of static currency conversion tables","archived":false,"fork":false,"pushed_at":"2023-08-03T22:17:09.000Z","size":43,"stargazers_count":0,"open_issues_count":2,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-12-28T10:28:59.961Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/killbill.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["killbill"]}},"created_at":"2023-07-11T12:05:01.000Z","updated_at":"2023-07-11T12:17:41.000Z","dependencies_parsed_at":"2024-11-07T13:12:30.906Z","dependency_job_id":"107c428b-6a99-4adb-961b-54147e2a0033","html_url":"https://github.com/killbill/killbill-currency-plugin","commit_stats":null,"previous_names":["killbill/killbill-currency-plugin"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/killbill%2Fkillbill-currency-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/killbill%2Fkillbill-currency-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/killbill%2Fkillbill-currency-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/killbill%2Fkillbill-currency-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/killbill","download_url":"https://codeload.github.com/killbill/killbill-currency-plugin/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239581802,"owners_count":19662958,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-07T13:12:26.879Z","updated_at":"2025-11-10T10:30:22.654Z","avatar_url":"https://github.com/killbill.png","language":"Java","funding_links":["https://github.com/sponsors/killbill"],"categories":[],"sub_categories":[],"readme":"# killbill-currency-plugin\n\nA default currency plugin based on a set of static currency conversion tables.\n\n## Kill Bill compatibility\n\n| Plugin version | Kill Bill version |\n|---------------:|------------------:|\n|          0.0.y |            0.22.z |\n|          1.0.y |            0.24.z |\n\n## Requirements\n\nThe plugin needs a database. The latest version of the schema can be found [here](https://github.com/killbill/killbill-currency-plugin/blob/master/src/main/resources/ddl.sql).\n\n## Development\n\nTo install the plugin from sources:\n\n```\nkpm install_java_plugin currency --from-source-file target/currency-*-SNAPSHOT.jar --destination /var/tmp/bundles\n```\n\n## REST API\n\nTo add currency conversion rates for a given base currency and date:\n\n```\ncurl -v \\\n     -X POST \\\n     -u admin:password \\\n     -H 'X-Killbill-ApiKey: bob' \\\n     -H 'X-Killbill-ApiSecret: lazar' \\\n     -H 'X-Killbill-CreatedBy: admin' \\\n     -H 'Content-Type: application/json' \\\n     -d '{\"baseCurrency\":\"USD\",\"conversionDate\":\"2013-10-10T20:41:09Z\",\"rates\":{\"BRL\":\"0.45721\",\"EUR\":\"1.38045\",\"GBP\":\"1.61650\"}}' \\\n     http://127.0.0.1:8080/plugins/killbill-currency/rates\n```\n\nTo get all current rates for a given base currency:\n\n```\ncurl -v \\\n     -u admin:password \\\n     -H 'X-Killbill-ApiKey: bob' \\\n     -H 'X-Killbill-ApiSecret: lazar' \\\n     'http://127.0.0.1:8080/plugins/killbill-currency/rates?baseCurrency=USD'\n```\n\n## Usage in a custom plugin\n\nCreate a `ServiceTracker` to track the `CurrencyPluginApi`:\n\n```\nServiceTracker\u003cCurrencyPluginApi, CurrencyPluginApi\u003e currencyPluginApiServiceTracker = new ServiceTracker\u003c\u003e(context, CurrencyPluginApi.class, null);\ncurrencyPluginApiServiceTracker.open();\n```\n\nThe API can then be used in your plugin, e.g.:\n\n```\ncurrencyPluginApiServiceTracker.getService().getBaseCurrencies()\n```\n\n## About\n\nKill Bill is the leading Open-Source Subscription Billing \u0026 Payments Platform. For more information about the project, go to https://killbill.io/.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkillbill%2Fkillbill-currency-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkillbill%2Fkillbill-currency-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkillbill%2Fkillbill-currency-plugin/lists"}