Xero's Lending Partnership certification checkpoints
A guide to getting Xero's Lending Partnership certification with Codat
For lenders that want to become Xero Partners, Xero stipulates two technical requirements to comply with:
- Lending writeback, which is a lender-specific requirement.
- Xero's certification checkpoints, not all of which apply to lenders.
Lending writeback
The purpose of the lending writeback is to accurately maintain the financial position of a customer in Xero at any point of the lending cycle. This is typically done by recording the loan liability, any interest, fees, and repayments, and facilitating the reconciliation of the bank account.
Codat offers this guide on implementing lending write-back.
Certification checkpoints
1. Sign up with Xero
Action required: none
This checkpoint is not relevant to Lending Partnerships.
2. Xero App Store
Action required: none
This checkpoint is not relevant to Lending Partnerships.
3. ConnectionConnection A link between a Codat company and a data source (like an accounting platform). Each connection represents authorized access to pull or push data from that platform.
Action required: significant
While Codat handles the initial connectionConnection A link between a Codat company and a data source (like an accounting platform). Each connection represents authorized access to pull or push data from that platform. to Xero via the Codat LinkLink The authorization flow that allows end users to connect their accounting, banking, or commerce platforms to your application via Codat. UI, Xero requires that you enable your user to manage this connectionConnection A link between a Codat company and a data source (like an accounting platform). Each connection represents authorized access to pull or push data from that platform. on an ongoing basis. Best practice is to create an "Integration settings" page to satisfy these requirements.
| Requirement | Recommendations |
|---|---|
| Display the name of the tenant that has been connected | This can be retrieved from our Get company info endpoint. |
| Display the current status of the connectionConnection A link between a Codat company and a data source (like an accounting platform). Each connection represents authorized access to pull or push data from that platform.. If disconnected, provide a button to reconnect to Xero | Use our Get connection endpoint to check the status of the connectionConnection A link between a Codat company and a data source (like an accounting platform). Each connection represents authorized access to pull or push data from that platform. and use the linkUrl to reconnect |
| Provide a button to terminate the connectionConnection A link between a Codat company and a data source (like an accounting platform). Each connection represents authorized access to pull or push data from that platform. | When a user clicks on the button, use our Delete connection endpoint to disconnect from Xero. |
| Handle a disconnect from Xero's side | Use a webhookWebhook An automated notification sent from Codat to your application when specific events occur, such as when data syncs complete or connections change status. to listen to our connection.disconnected event that identifies when a disconnect happens. When the alert is triggered, change the connectionConnection A link between a Codat company and a data source (like an accounting platform). Each connection represents authorized access to pull or push data from that platform. status in your UI and display a "Reconnect" or "Connect" button. Xero recommends setting a regular daily syncSync The process of fetching the latest data from a connected data source. Syncs can be triggered manually or run automatically on a schedule. of light data types so you can check each connected companyCompany In Codat, a company represents your customer's business entity. Companies can have multiple connections to different data sources.'s connectionConnection A link between a Codat company and a data source (like an accounting platform). Each connection represents authorized access to pull or push data from that platform. status every day. |
| Support one-to-one or multi-organizational connectionConnection A link between a Codat company and a data source (like an accounting platform). Each connection represents authorized access to pull or push data from that platform. | Codat allows your customers to select their Xero organization using the native Xero UI. You can enable them to connect to multiple organizations within Xero by creating a separate Codat companyCompany In Codat, a company represents your customer's business entity. Companies can have multiple connections to different data sources. per organization. |
| Provide a disconnection process for off-boarding | Use our Delete connection endpoint to prevent further syncsSync The process of fetching the latest data from a connected data source. Syncs can be triggered manually or run automatically on a schedule. and querying of historically synced data. |
4. Branding and naming
Action required: minimal
You must be compliant with Xero's guidance wherever you mention your Xero Partnership or use their brand assets. To ensure compliance, review Xero's Brand Guidelines and their Branding how-to-guide.
Xero recommends you use their own Connect and Disconnect buttons, but you can use a standard set of buttons for consistency of style if your app has multiple integrations.
5. Scopes
Action required: minimal
Xero requires that apps have access strictly to the data they need, so you should only enable the scopes that are required to access data relevant to your use case. We provide a scopes guide to explain which scopes typically correspond to which use cases. Speak with your Codat implementation specialist and they will adjust your scopes appropriately once you have agreed on what is needed.
6. Error handling
Action required: moderate
If an error occurs, your app's UI should communicate that fact to the user. It is best practice to provide them with detailed error messages or logs. Codat provides detailed error messaging for any issues with the integration, including status codes, as listed in our Status codes and errors.
7. Data integrity
Action required: none
Codat handles this checkpoint for you.
8. Account and Payment mapping
Action required: none
This checkpoint is not relevant to Lending Partnerships.
9. Taxes
Action required: none
This checkpoint is not relevant to Lending Partnerships.