The reference implementation for designing the international payments experience with the TransferWise API.
This implementation is based on the following documents:
Have a look at Bank Integrations Reference Implementation (Backend) for a reference backend implementation.
The reference application consists of three main modules:
app module
: simulates a demo banking application and doesn't contain any TransferWise reference codetransferwise module
: implementation of all code and screens to integrate the TransferWise for Banks APIdynamicform module
: reusable library that renders dynamic forms returned by the TransferWise for Banks APIThis module doesn't contain any TransferWise reference code and shouldn't be reused.
A very basic module that simulates a bank application and integrates the TransferWise component.
:point_right: Learn more about the App module.
This module can be copied to bootstrap your integration of the TransferWise for Banks API. Note that only the full flow can easily be reused, not the different steps independently.
This module represents the reference implementation of the TransferWise for Banks API and contains all screens to handle an international payment flow.
:point_right: Learn more about the TransferWise module and its architectural choices.
This module can reused to render dynamic forms returned by the TransferWise for Banks API. While it is fully tested and has a simple, generic API, its interface needs more polish to distribute it as a Maven artifact (e.g. thread safety, review contracts,...).
Some endpoints in the TransferWise API return a dynamic UI that needs to be rendered to the user.
These endpoints are:
Rendering such a dynamic UI is quite challenging and therefore, the reference implementation contains a separate module dynamicforms
that handles all that complexity for you.
:point_right: Learn more about the Dynamic forms module and how to integrate it.
The banks reference requires Android Studio version 3.6 or higher. The latest version can be downloaded from here.
This project uses the Gradle build system:
./gradlew assembleDebug
./gradlew testDebugUnitTest
For more resources on learning Android development, visit the Developer Guides at developer.android.com.
The banking reference implementation can be tested both offline and online.
Checkout the source code and install the application on an Android device. Make sure to check the "Enable offline demo mode" toggle and you can go through most of the flow without needing to set up an instance of the reference backend.
Limitations:
Checkout the source code and provide your own values of the following templated variables (found here)
DEFAULT_SERVER_URL
-> where the Bank Integrations Reference Implementation (Backend) is runningloginUrl
-> the reference example is pointing to TransferWise's Sandbox API. Change this to our production environment before making the code available to customers.LOGIN_CLIENT_ID
-> unique Id identifying your product (Please contact banks@transferwise.com
to get started.)This project uses ktlint, provided via the spotless gradle plugin.
Please run ./gradlew spotlessApply
before merging pull requests to format all code and apply the appropriate copyright headers.
Copyright 2019,2020 TransferWise Ltd.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.