Key Features & Screen Summaries
1. PowerTranz Provider Configuration
A dedicated provider configuration view within the Odoo Accounting / Invoicing module that allows administrators to configure, authenticate, and manage the gateway connection.
- Environment Mode: Allows switching between Test Mode (staging environment for sandbox testing) and Enabled (live production payments).
- PowerTranz ID: Secure merchant identifier provided by PowerTranz for account identification.
- PowerTranz Password: Password-masked credential field used for secure API request authentication.
Screen Summary & Navigation:
Menu Path: Accounting / Invoicing > Configuration > Payment Providers > Powertranz
(Alternative: Website > Configuration > Payment Providers > Powertranz)
Visible Fields & Controls:
- Provider Status: Radio/dropdown toggle for Disabled, Test Mode, or Enabled.
- Credentials Tab: Input fields for PowerTranz ID and PowerTranz Password.
- Configuration Tab: Display name, supported currencies, country restrictions, and payment icon options.
Outcome: Storing valid credentials enables the PowerTranz payment option for all online checkouts.
2. Inline Checkout Payment Form
A responsive credit/debit card payment form integrated directly into Odoo's checkout interface (website_sale and customer portal), enabling customers to enter payment details smoothly without leaving the storefront.
- Card Number: Accepts 15-digit and 16-digit card numbers with brand recognition.
- Expiration Date: Formatted date entry (YY/MM).
- Card CVV: Security code verification input with hidden masking.
- Cardholder Name: Name input matching the printed card details.
Built-in Card Validation:
- Validates 16 digits for Visa (starting with 4) and Mastercard (starting with 5).
- Validates 15 digits for American Express (starting with 3).
- Validates expiry date (valid month range 01–12 and non-expired year).
- Sanitizes cardholder names against invalid special characters.
Screen Summary & Navigation:
Location / URL: Odoo Website Checkout (/shop/payment)
Visible Fields & Controls:
- A selectable payment method radio button labeled Powertranz.
- An inline collapsible form containing four input boxes: Card Number, Expiry Date (YY/MM), CVV, and Cardholder Name.
- Primary call-to-action button: Pay Now.
Outcome: Form inputs are validated both client-side and server-side before initiating payment authorization.
3. Integrated 3D Secure (3DS) Authentication (Iframe)
Provides complete support for 3D Secure cardholder verification (SCA / PSD2 compliance) rendered seamlessly inside the Odoo website layout.
- SPI Authentication: Sends the initial authorization request (/api/spi/auth) with 3D Secure challenge instructions to the gateway.
- In-Page Challenge Rendering: Receives the bank's authentication HTML challenge (RedirectData) and renders it directly within the website layout (/shop/payment/iframe/<identifier>/<data>).
- Continuous Brand Experience: Customers complete their SMS OTP or mobile banking verification within the website's frame without full-page external redirects.
Screen Summary & Navigation:
Location / URL: /shop/payment/iframe/<identifier>/<data> (Loads automatically after clicking Pay Now)
Visible Fields & Controls:
- The merchant website's standard header, navigation bar, and footer remain intact.
- An embedded container displays the cardholder's issuing bank 3DS authentication interface (SMS One-Time Password prompt, biometric authorization request, or verification buttons).
Outcome: Cardholder completes two-factor authentication in a secure frame, protecting against fraud while maintaining merchant context.
4. Automated Payment Capture & Order Confirmation
Automatically processes the payment capture and reconciles the order once the customer passes the 3D Secure verification.
- Authentication Verification: Evaluates bank verification responses for IsoResponseCode: 3D0 and AuthenticationStatus: Y.
- SPI Token Capture: Submits the generated SpiToken to the PowerTranz payment capture endpoint (/api/spi/payment).
- Automated Reconciliation: Automatically transitions the Odoo payment.transaction record to Done, confirms the eCommerce Quotation into a Sale Order, and redirects the customer to the payment confirmation screen.
Screen Summary & Navigation:
Location / URL: /shop/confirmation or /payment/status (Redirected automatically upon authentication)
Visible Fields & Controls:
- Confirmation Banner: Displays a success message indicating the order has been placed.
- Order Reference: Shows confirmed Sales Order number (e.g., S00042).
- Summary Details: Itemized list of purchased products, amounts, billing/shipping addresses, and payment receipt status.
Outcome: Quotation state changes to confirmed Sales Order; invoice and delivery orders are generated automatically per database settings.
5. Payment Transaction Audit Trail
Provides a dedicated view within Odoo that logs every payment event and response received from the PowerTranz gateway, serving as a comprehensive audit trail for check-in and checkout reconciliation.
- Transaction Traceability: Links Odoo transaction references (OrderIdentifier) directly to gateway records.
- Detailed Status Log: Displays individual transaction states (Draft, Pending, Done, Error), customer names, linked sales orders, and authorization amounts.
Screen Summary & Navigation:
Menu Path: Accounting / Invoicing > Configuration > Payment Transactions
(Alternative: Website > Configuration > Payment Transactions)
Visible Fields & Controls:
- List Columns: Reference, Payment Provider (Powertranz), Customer Name, Amount, Currency, and Status badge (Done / Error).
- Form Details: Clicking any record opens the transaction form displaying raw gateway callback payloads, currency conversion, and matching sale order links.
Outcome: Offers complete transparency for finance and audit teams to reconcile settled merchant payouts.
6. Confirmed Sales Order & Transaction Link
Allows backend sales and accounting teams to inspect the confirmed sales order and view the linked payment transaction details directly from the chatter and transaction smart button.
- Smart Button Link: Access the associated payment transaction directly from the sales order form view.
- Chatter Tracking: Logs automatic confirmation messages, payment status updates, and linked invoices.
Screen Summary & Navigation:
Menu Path: Sales > Orders > Orders > [Open Confirmed Order]
Visible Fields & Controls:
- Header Status: Progress badge shows Sales Order (promoted automatically from Quotation).
- Stat Buttons: A Payment Transaction smart button on the top right showing linked transactions (1 Transaction).
- Chatter Feed: System message logging payment provider, transaction reference, amount paid, and time of confirmation.
Outcome: Customer service and operations teams can immediately verify payment without leaving the order screen.
End-to-End Workflow & Interface Summary Table
| Step |
Stage |
Screen / Location |
Primary Controls & Data |
Result |
| 1 |
Configuration |
Invoicing > Configuration > Payment Providers > Powertranz |
PowerTranz ID, Password, State toggle (Test/Enabled) |
Gateway is activated and ready for transactions. |
| 2 |
Checkout |
Website Shop (/shop/payment) |
Card Number, Expiry (YY/MM), CVV, Cardholder Name |
Details validated and sent to PowerTranz SPI auth. |
| 3 |
3DS Challenge |
Embedded Page (/shop/payment/iframe/<id>/<data>) |
Bank OTP / SMS verification challenge inside website layout |
Cardholder passes Strong Customer Authentication (SCA). |
| 4 |
Payment Capture |
Backend Controller (/shop/payment/iframe/status) |
Automated submission of SpiToken to /api/spi/payment |
Funds captured; Odoo transaction set to Done. |
| 5 |
Confirmation |
Website Confirmation (/shop/confirmation) |
Confirmed Order reference, product summary, payment status |
Customer receives receipt and confirmation. |
| 6 |
Audit & Tracking |
Invoicing > Configuration > Payment Transactions |
Transaction reference, amounts, timestamps, status badges |
Financial audit trail maintained for reconciliation. |