ERP API Integration Explained: REST, Webhooks, Auth and Idempotency
A plain-English explanation of ERP API integration: REST APIs, webhooks, authentication methods, idempotency, pagination, rate limits and error handling.
Integration · Payments
Overview
Odoo includes a Razorpay payment provider for online payments; we configure it and add the reconciliation and reporting finance teams need.
01Data
| Entity | Direction | Notes |
|---|---|---|
| Payments | App → ERP | Successful payments recorded against invoices or orders. |
| Payment links | ERP → App | Links created for invoices and sent by email or WhatsApp. |
| Refunds | ERP → App | Refunds triggered from credit notes. |
| Settlements | App → ERP | Settlement reports matched to payments, with fees and GST on fees posted. |
02Use cases
Payment links on every invoice.
UPI and card payments at eCommerce checkout.
Settlements matched to payments and bank deposits.
03 — Architecture
Payment events arrive by webhook, are verified with the webhook secret and processed idempotently. Settlement data is fetched daily and matched to payments and bank statement lines.
04Reliability
Razorpay key ID and secret plus a webhook secret, stored securely.
Unmatched payments go to a review queue; webhook signature failures are logged and rejected.
Razorpay retries webhooks; the integration also polls recent payments to catch any missed.
05 — Data mapping
| Razorpay | ERP |
|---|---|
| payment_id | Payment reference |
| order_id / notes | Invoice or sales order |
| settlement fees and tax | Bank charges and input GST |
06 — Automation
07 — Security
Card data never touches the ERP; webhooks verified; least-privilege API keys.
Related
Other integrations
Insights
A plain-English explanation of ERP API integration: REST APIs, webhooks, authentication methods, idempotency, pagination, rate limits and error handling.
How to integrate an ERP with eCommerce, CRM, payments and other systems: data ownership, integration patterns, middleware, error handling, monitoring and common failure modes.
How to integrate RFID readers with Odoo inventory: middleware design, mapping EPCs to products and serials, receiving and counting flows, performance and what to build vs buy.
FAQ
Yes, Odoo includes a Razorpay payment provider. Settlement reconciliation usually needs additional setup.
Yes, UPI is supported through Razorpay checkout and payment links.
Next step
Tell us your volumes, channels and data rules. We will outline the architecture and the risks before anything is built.