WiPay Payment Provider for Odoo 19

Accept credit and debit card payments in Jamaica, Trinidad & Tobago, and Barbados — directly inside Odoo's eCommerce checkout, customer portal, and invoicing flow.

Developed by M Mobile Lab Limited — www.mobile-lab.org

Key Features

Supported Platforms & Currencies

Payment Flow

WiPay uses a redirect-based hosted-page model:

1. Customer clicks Pay on the checkout or invoice page.
2. Odoo builds a signed POST form and redirects to the WiPay API endpoint.
3. Customer enters card details on WiPay's Secure Hosted Page (FAC or FGB).
4. WiPay redirects browser back to /payment/wipay/return with result parameters.
5. Simultaneously, WiPay sends an IPN POST to /payment/wipay/webhook.
6. Odoo verifies the MD5 hash, marks transaction done, creates accounting payment.

Security — Response Hash Verification

Every successful WiPay transaction response includes a hash that this module verifies automatically:

hash = md5(transaction_id + total + api_key)

A mismatch sets the transaction to error state and logs a warning — protecting you from forged payment confirmations.

Configuration Fields

Sandbox Test Cards

Jamaica / FGB

Trinidad & Tobago / FAC

Any expiry date and any 3-digit CVV work with all test cards.

Recovering Missing Payments

Three options if payment records are ever missing:

• UI Button: Provider form → "Create Missing Payments" button
• Cron Job: Runs automatically every 6 hours (last 30 days)
• Shell Script: ./odoo-bin shell -d mydb < tools/create_missing_payments.py

Technical Details