metatroncubeswdev 7e860b65c5 feat(community_interac): Interac e-Transfer payment provider (Phase 5)
The plan flags this as the highest-risk module since the payment provider
API is strict and version-sensitive. Before writing any code, read Odoo
19's own payment_custom module (its wire-transfer provider) end to end as
a reference, since it's the closest first-party analog to a manual/
offline payment flow - this avoided the trial-and-error that hit the
other modules and got the core logic right on the first install attempt.

payment.provider gains code='interac' (via selection_add, same pattern
payment_custom uses for 'custom') plus interac_recipient_email
(required_if_provider='interac' - Odoo only enforces this when the
provider's state is enabled/test, so the module ships a disabled,
unconfigured provider record and the deployment layer configures + enables
it, keeping client specifics out of product code) and a configurable
interac_deadline_hours.

Flow: selecting Interac at checkout calls _apply_updates, which sets the
transaction 'pending' and emails instructions (recipient address, amount,
reference, deadline) via a mail.template - no dynamic per-transaction data
needs to live in the static provider-level pending_msg field, since the
reference/amount are already shown on Odoo's generic payment status page.
A "Pending Interac Payments" admin list (Interac Payment Verifier group)
has a one-click "Payment Received" button calling action_confirm_interac_
payment (-> _set_done, which triggers Odoo's normal order/invoice
reconciliation - no need to reimplement that). An hourly cron cancels
unconfirmed pending transactions past the deadline and emails a
cancellation notice.

Verified against a live Odoo 19 + Postgres 16 container: 4/4 automated
tests pass, plus a full manual live run of both cycles the plan's gate
asks for - drove a transaction through the actual /payment/interac/process
controller to pending (confirmed the instructions email), used the
treasurer action to confirm it to 'done', and separately backdated a
second transaction's last_state_change and triggered the auto-cancel cron
via ir.cron's method_direct_trigger, confirming both the state change to
'cancel' and the cancellation email.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-08-17 21:59:15 -04:00

45 lines
2.3 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<odoo>
<data noupdate="1">
<record id="mail_template_interac_instructions" model="mail.template">
<field name="name">Interac: Payment Instructions</field>
<field name="model_id" ref="payment.model_payment_transaction"/>
<field name="subject">{{ object.company_id.name }}: Interac e-Transfer instructions</field>
<field name="partner_to">{{ object.partner_id.id }}</field>
<field name="auto_delete" eval="True"/>
<field name="body_html" type="html">
<div style="margin: 0px; padding: 0px; font-size: 13px;">
<p>Dear <t t-out="object.partner_id.name or ''">Customer</t>,</p>
<p>To complete your order with <t t-out="object.company_id.name or ''"/>, please send an Interac e-Transfer:</p>
<ul>
<li><strong>Send to:</strong> <t t-out="object.provider_id.interac_recipient_email or ''"/></li>
<li><strong>Amount:</strong> <t t-out="format_amount(object.amount, object.currency_id)"/></li>
<li><strong>Reference code (use as the e-transfer message/security question if possible):</strong>
<t t-out="object.reference"/></li>
<li><strong>Please send within:</strong> <t t-out="object.provider_id.interac_deadline_hours"/> hours,
or the order will be automatically cancelled.</li>
</ul>
</div>
</field>
</record>
<record id="mail_template_interac_cancelled" model="mail.template">
<field name="name">Interac: Payment Cancelled</field>
<field name="model_id" ref="payment.model_payment_transaction"/>
<field name="subject">{{ object.company_id.name }}: Interac e-Transfer window expired</field>
<field name="partner_to">{{ object.partner_id.id }}</field>
<field name="auto_delete" eval="True"/>
<field name="body_html" type="html">
<div style="margin: 0px; padding: 0px; font-size: 13px;">
<p>Dear <t t-out="object.partner_id.name or ''">Customer</t>,</p>
<p>
We did not receive confirmation of your Interac e-Transfer for order reference
<t t-out="object.reference"/> within the payment window, so it has been cancelled.
Please place your order again if you would still like to proceed.
</p>
</div>
</field>
</record>
</data>
</odoo>