Payhawk × Odoo 17 — Quick Start
This guide takes you from a fresh Odoo 17 instance to a working, two-way Payhawk integration. Follow the steps in order. The whole process takes about 20–30 minutes.
Odoo 17 specifics
- Group ID / Group Key are global (not company-dependent — that changed in v19).
- No reimbursement batching option (added in v18).
- Module version
17.0.x.
See the full list in version differences.
Download the guide
Prefer to read offline, or working in an environment where docs.planapulse.com isn't reachable? Get the entire guide as a single PDF.
The full Payhawk × Odoo 17.0 integration guide as a single offline PDF — covers prerequisites, installation, configuration, sync, webhooks, and going live. Useful for environments where docs.planapulse.com isn't reachable.
Video walkthrough
Four short, topic-scoped demos — watch the general walkthrough first, then dive into the specifics.
1 General walkthrough 14 min
End-to-end overview of the integration.
Watch online: youtube.com/watch?v=-Vmy-1UZFQU
2 Settings passed between Payhawk and Odoo 7 min
What configuration syncs in each direction and how to set it up.
Watch online: youtube.com/watch?v=v82Rwu6oo18
3 Expenses in Payhawk 5 min
Capturing and reviewing expenses on the Payhawk side.
Watch online: youtube.com/watch?v=y_MC9O6jru4
4 How the info is transformed into Odoo 2 min
How reviewed expenses become bills, receipts, and bank statement lines.
Watch online: youtube.com/watch?v=CyIILbFXz94
Download the module
Get the latest packaged build of the connector for Odoo 17.0. Unzip into your Odoo addons path, then update the apps list and install.
The Payhawk × PLANA connector is proprietary software. We send the package to licensed customers on request — usually within one business day.
At a glance
| Step | What you do | Where |
|---|---|---|
| 1 | Check prerequisites | Odoo apps + server |
| 2 | Install the module | Odoo Apps |
| 3 | Get an API key | Payhawk portal |
| 4 | Configure the connection | Settings → Payhawk |
| 5 | Run the first sync | Settings → Payhawk |
| 6 | Enable webhooks | Odoo + Payhawk |
| 7 | Go live | Switch to Production |
Start with Prerequisites →