Railz Connect™ is a plug-and-play widget that provides a secure, elegant authentication flow for each integration that Railz supports. Railz Connect™ makes it secure and easy for business customers to connect their financial data to Railz.
You also don't have to worry about maintenance since all new supported integrations are added automatically. The design and the user flow can be customized, depending on your use case and customer experience.
Railz Connect™ is a component of your app that needs to be added in a web view. No hosting or additional server is needed.
Already using our old iFrame version of the widget?
We are planning to deprecate the original Railz widget in the coming months. At this point, we are offering our existing clients the possibility to try out and smoothly transition to the new Railz Connect™.
Railz Connect is only supported using the latest version of Google Chrome, Safari, Firefox and Microsoft Edge. If you have issues using Railz Connect in other browsers, please try again using one of our supported browsers.
As you might have noticed, you use both a server and a client-side component to create a connection and access the Railz APIs. The business authorization flow looks like this:
- A business customer will follow the online authorization process as established by each service provider. This process will redirect the user to the service provider's website to validate their login credentials and explicitly authorize consent for your app to access their data.
Authorization requires a user with an administrator or account owner role.
- Upon successful authorization, Railz will encrypt and store the business' connection credentials which creates a new
connectionIdassociated with the
serviceName. Typically, connection credentials are valid for 12 months after authorization.
Sandbox has No Authorization
Business authorization is not required when testing Railz Cloud Accounting in Railz Connect™ on the sandbox.
- Once the service provider is successfully authenticated and authorized, Railz Connect™ will redirect the end-user to the success page. You will be able to choose what that page is to ensure a seamless experience for your users.
Reauthorizing a Connection
To reauthorize a connection you need to ask your business customers to go through the authorization flow again through Railz Connect. You can do so by loading Railz Connect with the
widgetId is provided to you in the Railz Dashboard and identifies your instance of Railz Connect™.
businessName corresponds to a unique business name that you provide to identify the business authorizing access to their service providers. This will allow you to specify which businesses you want to request data on when calling the API.
businessName was provided when initiating Railz Connect™, Railz will generate a unique identifier.
We recommend using the POST /businesses endpoint to create a
newbusiness, then using it as a value for the
businessNameparameter when initiating Railz Connect™. If your application workflow doesn't support identifying a business name when initiating Railz Connect™, we recommend you assign a temporary value then updating the business name using POST /businesses.
Updated 8 days ago