{"id":18521783,"url":"https://github.com/transferwise/banks-reference-backend","last_synced_at":"2025-04-09T09:33:26.998Z","repository":{"id":48377704,"uuid":"234570647","full_name":"transferwise/banks-reference-backend","owner":"transferwise","description":"Reference Backend code integrating TransferWise's services for a (Demo) Bank App","archived":true,"fork":false,"pushed_at":"2023-04-07T01:48:44.000Z","size":150,"stargazers_count":21,"open_issues_count":0,"forks_count":5,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-02-13T19:18:27.103Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://transferwise.github.io/api-docs-banks/#transferwise-for-banks-api","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/transferwise.png","metadata":{"files":{"readme":"README.MD","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2020-01-17T14:56:36.000Z","updated_at":"2024-12-06T14:29:08.000Z","dependencies_parsed_at":"2024-11-06T17:35:32.104Z","dependency_job_id":"89fbe76c-c8c4-4987-bbd0-12a4a9857eda","html_url":"https://github.com/transferwise/banks-reference-backend","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/transferwise%2Fbanks-reference-backend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/transferwise%2Fbanks-reference-backend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/transferwise%2Fbanks-reference-backend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/transferwise%2Fbanks-reference-backend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/transferwise","download_url":"https://codeload.github.com/transferwise/banks-reference-backend/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247694892,"owners_count":20980731,"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-06T17:27:36.550Z","updated_at":"2025-04-09T09:33:26.351Z","avatar_url":"https://github.com/transferwise.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bank Integrations Reference Implementation (Backend)\n\nThe reference implementation for designing the international payments experience with the TransferWise API.\n\nThis implementation is based on the following documents:\n\n- [TransferWise for Banks API](https://transferwise.github.io/api-docs-banks/#transferwise-for-banks-api)\n- [Bank Integrations Design Guide](https://www.notion.so/Bank-Integrations-Design-Guide-8c375c5c5f1e4c64953b4b601ff6abc6)\n\nHave a look at [Bank Integrations Reference Implementation (Android)](https://github.com/transferwise/banks-reference-android) for a reference Android App implementation.\n\n# Overview\n\nThe reference backend consists of:\n- Main Java Spring Boot application.\n- Database that represents the internal database of the Bank.\n- A set of unit and integration tests covering a variety of use cases.\n\n### Disclaimer\n\nThis repository contains a representation of a Bank's integration with TransferWise's API but this is NOT production-ready code.\n\n## Spring Boot application\n\nThe Spring Boot application will provide of a set of endpoints to be consumed by the Bank's Apps. You will find more information about this endpoints once you run the application and checkout the endpoint documentation powered by Swagger that you can find in http://localhost:8080/swagger-ui.html\n\nBefore running the server, you'll need to set the following values located in [application.properties](https://github.com/transferwise/banks-reference-backend/blob/master/src/main/resources/application.properties)\n\n- `twbank.clientId` -\u003e unique Id identifying your product (Please contact `banks@transferwise.com` to get started.)\n- `twbank.secret` -\u003e secret linked to the previous client id.\n\n## Database\n\nThis example database represents the internal database of the Bank and contains the following:\n- Bank's customer information\n- Supported currencies\n- Transfer history\n- A correlation between TransferWise and Banks customer IDs\n- Token management\n\n# Development setup\n\n## Tech dependencies\n\nIn order to run this server, you must have the following dependencies installed in your machine\n- Java 11+\n- Postgres DB\n\n** We provide a [docker compose file](https://github.com/transferwise/banks-reference-backend/blob/master/docker-compose.yml) that starts up all necessary dependencies with the command\n`docker-compose -d up`\n\n## Running the server\n\nOnce dependencies are running, to startup the Spring Boot application please run:\n\n`./gradlew bootRun`\n\n## Running the tests\n\nTo run the tests please run:\n\n`./gradlew test`\n\n# License\n```\nCopyright 2019,2020 TransferWise Ltd.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftransferwise%2Fbanks-reference-backend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftransferwise%2Fbanks-reference-backend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftransferwise%2Fbanks-reference-backend/lists"}