Xero's Bank Feeds Partner certification checkpoints
A guide to getting Xero's Bank Feeds Partner certification with Codat
To receive Xero Bank FeedsBank Feeds A Codat product that enables automatic synchronization of bank transaction data into a company's accounting software. Partner certification, you must comply with a list of technical checkpoints. Xero's technical requirements for Bank FeedsBank Feeds A Codat product that enables automatic synchronization of bank transaction data into a company's accounting software. differ from Xero’s standard checkpoints and are not available online. On request, your Codat account team can provide you with Xero's Bank FeedsBank Feeds A Codat product that enables automatic synchronization of bank transaction data into a company's accounting software. App Review Form, which documents the requirements in full.
Certification checkpoints
Codat handles many of the certification checkpoints for you. For those that require you to take action, we prepared this companion guide that helps you understand the steps you need to take. We also recommend that you work closely with your Codat account team during your implementation.
1. App name and portal settings
Action required: minimal
Xero calls any platforms connecting to the Xero APIAPI A set of rules and protocols that allows different software applications to communicate with each other. Codat provides APIs for accessing financial data from accounting, banking, and commerce platforms. "apps". You may not think of your offering as an app, but this is simply Xero's preferred terminology. Your app needs to comply with two requirements:
-
Your app's name must reflect the go-to-market name of your app or product and cannot include the word
Xero. This is important because the name is visible to end users at multiple points in the customer journey. You can edit your app's name in the My Apps section of your Xero Developer Portal. -
Your app's email address should be generic (for example,
[email protected]) and not be a specific employee's address. This will ensure you continue to have access to your Xero developer account even if a staff member leaves.
2. Branding
Action required: minimal
You must be compliant with Xero's guidance wherever you mention your Xero Partnership or use their brand assets. To ensure that, review Xero's Brand Guidelines and Branding how-to-guide.
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
Your application's UI must meet the following requirements:
| Requirement | Recommendations |
|---|---|
| Display the name of the tenant that has been connected | Use our Get company info endpoint to retrieve this detail. |
| 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 our Data connection status changed 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 identify 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. Error handling
Action required: none or some
If you use Codat's Bank FeedsBank Feeds A Codat product that enables automatic synchronization of bank transaction data into a company's accounting software. UI, your bank feed will satisfy this requirement. If you create your own bank feed UI, you must communicate any errors to your customers appropriately.
5. Offline access
Action required: none
Our Xero integration covers the requirements of this checkpoint in full.
6. Rate limit hit management
Action required: none
Our Xero integration covers the requirements of this checkpoint in full.
7. Scopes
Action required: none
Our Xero integration covers the requirements of this checkpoint in full.
8. Account mapping
Action required: none
If you use Codat's Bank FeedsBank Feeds A Codat product that enables automatic synchronization of bank transaction data into a company's accounting software. UI, your bank feed will satisfy this requirement. If you create your own bank feed UI, you must provide an appropriate account mapping functionality. Use our mapping page guide to build an account mapping UI with Codat.
9. Bank name, logos, and account number
Action required: some
This checkpoint is relevant when you set up your branding within Codat and again when you share your branding details with Xero at the end of the certification process.
Your Codat team will work with you to ensure your Bank Feed implementation complies with the following Xero checks:
- Your brand is correctly represented in Xero.
- You set appropriate names for the accounts you create.
- Your logo and account number are displayed correctly.
10. Scheduled refresh
Action required: none
Our Xero integration covers the requirements of this checkpoint in full.
11. Missed and rejected statements
Action required: moderate
Codat will communicate to you if a bank statement is missed or rejected. Include appropriate logic in your app to handle this outcome as you see fit.
Your Codat team will then work with you to ensure your Bank Feed implementation complies with the following Xero checks:
- Your app can handle rejected and missed statements.
- How your app compensates for a missed statement (for example, adds it to the next queue or performs a dedicated call).
- Your user is notified in case of missed or rejected statements.