Building a Customer Portal in Odoo 19:
Quotes, Orders, Invoices & Support Tickets

# Enable online signature and payment
Settings > Sales > Quotations & Orders

  [x] Online Signature    — customers sign to accept
  [x] Online Payment       — customers pay a deposit/full amount
  [x] Quotation Validity   — set default expiry (e.g., 30 days)

# Per-quotation overrides (on the SO form):
Sales > Quotations > Select quote
  > "Other Info" tab
    > Online Signature: Yes/No
    > Online Payment: Yes/No
    > Prepayment Percentage: e.g., 30%

sale_order = self.env["sale.order"].browse(order_id)

# Add optional products that appear on the portal
sale_order.write({
    "sale_order_option_ids": [
        (0, 0, {
            "name": "Extended Warranty - 2 Years",
            "product_id": warranty_product.id,
            "price_unit": 499.00,
            "quantity": 1,
            "uom_id": warranty_product.uom_id.id,
        }),
        (0, 0, {
            "name": "Priority Support Package",
            "product_id": support_product.id,
            "price_unit": 1200.00,
            "quantity": 1,
            "uom_id": support_product.uom_id.id,
        }),
    ],
})

# 1. Enable a payment provider
Settings > Payment Providers > e.g., Stripe
  > State: Enabled
  > "Allow payments from the Customer Portal": [x]

# 2. Enable payment on invoices
Settings > Accounting > Customer Payments
  [x] Invoice Online Payment

# 3. The "Pay Now" button now appears on every
#    unpaid invoice in the portal

# 4. Partial payments are supported:
#    customer can enter a custom amount < invoice total

from odoo import models, api


class PaymentProvider(models.Model):
    _inherit = "payment.provider"

    @api.model
    def _get_compatible_providers(
        self, company_id, partner_id, amount,
        currency_id=None, **kwargs
    ):
        providers = super()._get_compatible_providers(
            company_id, partner_id, amount,
            currency_id=currency_id, **kwargs
        )
        partner = self.env["res.partner"].browse(
            partner_id
        )
        # If partner has restricted payment methods,
        # filter the provider list
        if partner.x_allowed_provider_ids:
            providers = providers.filtered(
                lambda p: p.id
                in partner.x_allowed_provider_ids.ids
            )
        return providers

<odoo>
  <template id="portal_layout_branded"
            inherit_id="portal.portal_layout">

    <xpath expr="//header" position="replace">
      <header class="o_portal_navbar">
        <nav class="navbar navbar-expand-lg"
             style="background-color: #1a5c2e;">
          <div class="container">
            <a class="navbar-brand" href="/my">
              <img src="/my_module/static/img/logo.svg"
                   alt="Company Logo"
                   height="40"/>
            </a>
            <span class="navbar-text text-white">
              Customer Portal
            </span>
          </div>
        </nav>
      </header>
    </xpath>

  </template>
</odoo>

from odoo.addons.portal.controllers.portal import (
    CustomerPortal,
)
from odoo.http import request


class CustomPortal(CustomerPortal):

    def _prepare_home_portal_values(
        self, counters
    ):
        values = super()._prepare_home_portal_values(
            counters
        )
        if "project_count" in counters:
            values["project_count"] = (
                request.env["project.project"]
                .search_count([
                    ("partner_id", "=",
                     request.env.user.partner_id.id),
                ])
            )
        return values

<odoo>
  <template id="portal_my_home_projects"
            inherit_id="portal.portal_my_home">
    <xpath expr="//div[hasclass('o_portal_docs')]"
           position="inside">
      <t t-call="portal.portal_docs_entry">
        <t t-set="icon" t-value="'/my_module/static/img/project_icon.svg'"/>
        <t t-set="title">Projects</t>
        <t t-set="url" t-value="'/my/projects'"/>
        <t t-set="text">View your active projects</t>
        <t t-set="count" t-value="project_count"/>
      </t>
    </xpath>
  </template>
</odoo>

/* ── Portal Brand Overrides ── */
.o_portal_navbar {
  background-color: #1a5c2e !important;

  .navbar-brand img {
    max-height: 40px;
  }
  .navbar-text {
    color: #ffffff;
    font-weight: 600;
  }
}

/* ── Dashboard Cards ── */
.o_portal_docs .o_portal_doc_entry {
  border-left: 3px solid #1a5c2e;
  transition: transform 0.15s ease;

  &:hover {
    transform: translateX(4px);
  }
}

/* ── Status Badges ── */
.badge-portal-success {
  background-color: #1a5c2e;
  color: #fff;
}
.badge-portal-warning {
  background-color: #e8a317;
  color: #fff;
}
.badge-portal-danger {
  background-color: #c0392b;
  color: #fff;
}