Wompi Payment Gateway for Odoo (Colombia)
Connect Odoo's native payment provider and transaction workflow to Wompi. The integration supports Colombian checkout methods while keeping orders, invoices, portal transactions, eligible card voids, and reconciliation inside Odoo.
Integration capabilities
- Sandbox and production provider configuration
- Hosted checkout or configured widget flow
- Cards, PSE, Nequi, and other methods enabled for the merchant account
- Server-generated checkout integrity signatures
- Signature-verified, idempotent webhook processing
- Wompi-to-Odoo transaction status mapping
- COP amount and currency-rounding reconciliation
- Role-restricted voids for eligible card transactions, with transaction audit history
- Website checkout and customer portal status visibility
Configuration sequence
- Confirm the target Odoo version and install the matching module release.
- In Payment Providers, open Wompi and start in test mode.
- Add the public key, private key, integrity secret, and events secret through protected configuration fields.
- Enable only the payment methods active on the Wompi merchant account.
- Register the displayed webhook URL in Wompi.
- Test approved, declined, duplicated-webhook, delayed-webhook, and eligible pre-settlement card-void scenarios.
- Reconcile the captured COP amount, then switch to production credentials under change control.
Protect payment credentials
Never place Wompi keys, the integrity secret, or the events secret in screenshots, tickets, source control, or this documentation. Rotate a credential immediately if it is exposed.
Compatibility
Use the module build that explicitly matches your Odoo major version and edition. Confirm the supported payment methods and card-void eligibility for your Wompi account before production activation. Settled-payment refunds are not included in the current connector and must be handled through Wompi's supported operational process.