From 302ed50cef01a9fe0c913a5543a46bea540d8863 Mon Sep 17 00:00:00 2001
From: Damien Bouvy <dbo@odoo.com>
Date: Fri, 6 Sep 2019 13:58:13 +0000
Subject: [PATCH] [ADD] payment_stripe_sca: Stripe API changes following PSD2

With the PSD2 directive coming into effect on September 14th,
was had no choice but to switch our Stripe integration to use
newer APIs that support Strong Customer Authentication (SCA for short).

This meant switching from the old stripe.js implementation for
'redirection' flow to the Stripe Checkout API and from the
Charge API to the newer SetupIntent API for s2s flows.

This new modules introduce these changes in a non-intrusive way,
this means that installing this module is *not* required for
all customers (e.g. instances only accepting payment to and
from countries that are not part of the EU), that installing it
will support SCA flows and that uninstallation leaves you with
a working instance as well. Essentially a backport of 9f5f2fc
in a seperate module.

Task 2039100
---
 addons/payment_stripe_sca/__init__.py         |   4 +
 addons/payment_stripe_sca/__manifest__.py     |  38 ++
 .../controllers/__init__.py                   |   3 +
 addons/payment_stripe_sca/controllers/main.py |  68 ++++
 addons/payment_stripe_sca/models/__init__.py  |   3 +
 addons/payment_stripe_sca/models/payment.py   | 372 ++++++++++++++++++
 .../static/description/icon.png               | Bin 0 -> 25859 bytes
 .../static/description/icon.svg               |   1 +
 .../static/description/index.html             |  64 +++
 .../static/description/redirection_flow.png   | Bin 0 -> 39730 bytes
 .../static/description/s2s_flow.png           | Bin 0 -> 14935 bytes
 .../static/src/js/payment_form.js             | 188 +++++++++
 .../static/src/js/payment_processing.js       |  48 +++
 .../static/src/js/stripe_sca.js               |  82 ++++
 addons/payment_stripe_sca/views/assets.xml    |   8 +
 .../views/payment_templates.xml               |  42 ++
 16 files changed, 921 insertions(+)
 create mode 100644 addons/payment_stripe_sca/__init__.py
 create mode 100644 addons/payment_stripe_sca/__manifest__.py
 create mode 100644 addons/payment_stripe_sca/controllers/__init__.py
 create mode 100644 addons/payment_stripe_sca/controllers/main.py
 create mode 100644 addons/payment_stripe_sca/models/__init__.py
 create mode 100644 addons/payment_stripe_sca/models/payment.py
 create mode 100644 addons/payment_stripe_sca/static/description/icon.png
 create mode 100644 addons/payment_stripe_sca/static/description/icon.svg
 create mode 100644 addons/payment_stripe_sca/static/description/index.html
 create mode 100644 addons/payment_stripe_sca/static/description/redirection_flow.png
 create mode 100644 addons/payment_stripe_sca/static/description/s2s_flow.png
 create mode 100644 addons/payment_stripe_sca/static/src/js/payment_form.js
 create mode 100644 addons/payment_stripe_sca/static/src/js/payment_processing.js
 create mode 100644 addons/payment_stripe_sca/static/src/js/stripe_sca.js
 create mode 100644 addons/payment_stripe_sca/views/assets.xml
 create mode 100644 addons/payment_stripe_sca/views/payment_templates.xml

diff --git a/addons/payment_stripe_sca/__init__.py b/addons/payment_stripe_sca/__init__.py
new file mode 100644
index 00000000000..bb0aae7ee63
--- /dev/null
+++ b/addons/payment_stripe_sca/__init__.py
@@ -0,0 +1,4 @@
+# -*- coding: utf-8 -*-
+# Part of Odoo. See LICENSE file for full copyright and licensing details.
+from . import controllers
+from . import models
diff --git a/addons/payment_stripe_sca/__manifest__.py b/addons/payment_stripe_sca/__manifest__.py
new file mode 100644
index 00000000000..6a2a0cac556
--- /dev/null
+++ b/addons/payment_stripe_sca/__manifest__.py
@@ -0,0 +1,38 @@
+# -*- coding: utf-8 -*-
+# Part of Odoo. See LICENSE file for full copyright and licensing details.
+
+#  ____________________
+# /                    \
+# |   DO NOT FORWARD   |
+# |    PORT FURTHER    |
+# |     THAN 12.4      |
+# \____________________/
+#          !  !
+#          !  !
+#          L_ !
+#         / _)!
+#        / /__L
+#  _____/ (____)
+#         (____)
+#  _____  (____)
+#       \_(____)
+#          !  !
+#          !  !
+#          \__/
+#
+# Starting with 12.5, the payment_stripe module contains these changes OoB
+
+{
+    'name': 'Stripe Payment Acquirer - Strong Customer Authentication Update',
+    'category': 'Hidden',
+    'summary': 'Payment Acquirer: Stripe Implementation for the EU PSD2',
+    'version': '1.0',
+    'description': """Stripe Payment Acquirer - Strong Customer Authentication Update""",
+    'depends': ['payment_stripe'],
+    'auto_install': True,
+    'data': [
+        'views/assets.xml',
+        'views/payment_templates.xml',
+    ],
+    'images': ['static/description/icon.png'],
+}
diff --git a/addons/payment_stripe_sca/controllers/__init__.py b/addons/payment_stripe_sca/controllers/__init__.py
new file mode 100644
index 00000000000..7036966b1ce
--- /dev/null
+++ b/addons/payment_stripe_sca/controllers/__init__.py
@@ -0,0 +1,3 @@
+# -*- coding: utf-8 -*-
+# Part of Odoo. See LICENSE file for full copyright and licensing details.
+from . import main
\ No newline at end of file
diff --git a/addons/payment_stripe_sca/controllers/main.py b/addons/payment_stripe_sca/controllers/main.py
new file mode 100644
index 00000000000..a3037125301
--- /dev/null
+++ b/addons/payment_stripe_sca/controllers/main.py
@@ -0,0 +1,68 @@
+# -*- coding: utf-8 -*-
+# Part of Odoo. See LICENSE file for full copyright and licensing details.
+import logging
+import pprint
+import werkzeug
+
+from odoo.http import route, request
+from odoo.addons.payment_stripe.controllers.main import StripeController
+
+_logger = logging.getLogger(__name__)
+
+
+class StripeControllerSCA(StripeController):
+    _success_url = '/payment/stripe/success'
+    _cancel_url = '/payment/stripe/cancel'
+
+    @route(['/payment/stripe/success', '/payment/stripe/cancel'], type='http', auth='public')
+    def stripe_success(self, **kwargs):
+        request.env['payment.transaction'].sudo().form_feedback(kwargs, 'stripe')
+        return werkzeug.utils.redirect('/payment/process')
+
+    @route(['/payment/stripe/s2s/create_json_3ds'], type='json', auth='public', csrf=False)
+    def stripe_s2s_create_json_3ds(self, verify_validity=False, **kwargs):
+        if not kwargs.get('partner_id'):
+            kwargs = dict(kwargs, partner_id=request.env.user.partner_id.id)
+        token = request.env['payment.acquirer'].browse(int(kwargs.get('acquirer_id'))).s2s_process(kwargs)
+
+        if not token:
+            res = {
+                'result': False,
+            }
+            return res
+
+        res = {
+            'result': True,
+            'id': token.id,
+            'short_name': token.short_name,
+            '3d_secure': False,
+            'verified': False,
+        }
+
+        if verify_validity != False:
+            token.validate()
+            res['verified'] = token.verified
+
+        return res
+
+    @route('/payment/stripe/s2s/create_setup_intent', type='json', auth='public', csrf=False)
+    def stripe_s2s_create_setup_intent(self, acquirer_id, **kwargs):
+        acquirer = request.env['payment.acquirer'].browse(int(acquirer_id))
+        res = acquirer._create_setup_intent(kwargs)
+        return res.get('client_secret')
+
+
+    @route('/payment/stripe/s2s/process_payment_intent', type='json')
+    def stripe_s2s_process_payment_intent(self, **post):
+        return request.env['payment.transaction'].sudo().form_feedback(post, 'stripe')
+
+    
+    # These routes are deprecated, let's remove them for security's sake
+    def stripe_s2s_create_json(self, **post):
+        raise werkzeug.exceptions.NotFound()
+    
+    def stripe_s2s_create(self, **post):
+        raise werkzeug.exceptions.NotFound()
+
+    def stripe_create_charge(self, **post):
+        raise werkzeug.exceptions.NotFound()
diff --git a/addons/payment_stripe_sca/models/__init__.py b/addons/payment_stripe_sca/models/__init__.py
new file mode 100644
index 00000000000..df1092a4fa3
--- /dev/null
+++ b/addons/payment_stripe_sca/models/__init__.py
@@ -0,0 +1,3 @@
+# -*- coding: utf-8 -*-
+# Part of Odoo. See LICENSE file for full copyright and licensing details.
+from . import payment
\ No newline at end of file
diff --git a/addons/payment_stripe_sca/models/payment.py b/addons/payment_stripe_sca/models/payment.py
new file mode 100644
index 00000000000..453f3a2678b
--- /dev/null
+++ b/addons/payment_stripe_sca/models/payment.py
@@ -0,0 +1,372 @@
+# -*- coding: utf-8 -*-
+# Part of Odoo. See LICENSE file for full copyright and licensing details.
+import logging
+import requests
+import pprint
+from werkzeug import urls
+
+from odoo import api, models, fields, _
+from odoo.exceptions import ValidationError
+from odoo.addons.payment_stripe_sca.controllers.main import StripeControllerSCA as StripeController
+from odoo.addons.payment_stripe.models.payment import INT_CURRENCIES
+from odoo.tools.float_utils import float_round
+
+_logger = logging.getLogger(__name__)
+
+
+class PaymentAcquirerStripeSCA(models.Model):
+    _inherit = "payment.acquirer"
+
+    def stripe_form_generate_values(self, tx_values):
+        self.ensure_one()
+
+        base_url = self.env["ir.config_parameter"].sudo().get_param("web.base.url")
+        stripe_session_data = {
+            "payment_method_types[]": "card",
+            "line_items[][amount]": int(
+                tx_values["amount"]
+                if tx_values["currency"].name in INT_CURRENCIES
+                else float_round(tx_values["amount"] * 100, 2)
+            ),
+            "line_items[][currency]": tx_values["currency"].name,
+            "line_items[][quantity]": 1,
+            "line_items[][name]": tx_values["reference"],
+            "client_reference_id": tx_values["reference"],
+            "success_url": urls.url_join(base_url, StripeController._success_url)
+            + "?reference=%s" % tx_values["reference"],
+            "cancel_url": urls.url_join(base_url, StripeController._cancel_url)
+            + "?reference=%s" % tx_values["reference"],
+            "customer_email": tx_values["partner_email"],
+        }
+        tx_values["session_id"] = self._create_stripe_session(stripe_session_data)
+
+        return tx_values
+
+    def _stripe_request(self, url, data=False, method="POST"):
+        self.ensure_one()
+        url = urls.url_join(self._get_stripe_api_url(), url)
+        headers = {
+            "AUTHORIZATION": "Bearer %s" % self.sudo().stripe_secret_key,
+            "Stripe-Version": "2019-05-16",  # SetupIntent need a specific version
+        }
+        resp = requests.request(method, url, data=data, headers=headers)
+        try:
+            resp.raise_for_status()
+        except:
+            _logger.error(resp.text)
+            raise
+        return resp.json()
+
+    def _create_stripe_session(self, kwargs):
+        self.ensure_one()
+        resp = self._stripe_request("checkout/sessions", kwargs)
+        if resp.get("payment_intent") and kwargs.get("client_reference_id"):
+            tx = (
+                self.env["payment.transaction"]
+                .sudo()
+                .search([("reference", "=", kwargs["client_reference_id"])])
+            )
+            tx.stripe_payment_intent = resp["payment_intent"]
+        return resp["id"]
+
+    def _create_setup_intent(self, kwargs):
+        self.ensure_one()
+        params = {"usage": "off_session"}
+        _logger.info(
+            "_stripe_create_setup_intent: Sending values to stripe, values:\n%s",
+            pprint.pformat(params),
+        )
+
+        res = self._stripe_request("setup_intents", params)
+
+        _logger.info(
+            "_stripe_create_setup_intent: Values received:\n%s", pprint.pformat(res)
+        )
+        return res
+
+    @api.model
+    def _get_stripe_api_url(self):
+        return "https://api.stripe.com/v1/"
+
+    @api.model
+    def stripe_s2s_form_process(self, data):
+        last4 = data.get("card", {}).get("last4")
+        if not last4:
+            # PM was created with a setup intent, need to get last4 digits through
+            # yet another call -_-
+            acquirer_id = self.env["payment.acquirer"].browse(int(data["acquirer_id"]))
+            pm = data.get("payment_method")
+            res = acquirer_id._stripe_request(
+                "payment_methods/%s" % pm, data=False, method="GET"
+            )
+            last4 = res.get("card", {}).get("last4", "****")
+
+        payment_token = (
+            self.env["payment.token"]
+            .sudo()
+            .create(
+                {
+                    "acquirer_id": int(data["acquirer_id"]),
+                    "partner_id": int(data["partner_id"]),
+                    "stripe_payment_method": data.get("payment_method"),
+                    "name": "XXXXXXXXXXXX%s" % last4,
+                    "acquirer_ref": data.get("customer"),
+                }
+            )
+        )
+        return payment_token
+
+    def stripe_s2s_form_validate(self, data):
+        return True
+
+
+class PaymentTransactionStripeSCA(models.Model):
+    _inherit = "payment.transaction"
+
+    stripe_payment_intent = fields.Char(
+        string="Stripe Payment Intent ID", readonly=True
+    )
+    stripe_payment_intent_secret = fields.Char(string='Stripe Payment Intent Secret', readonly=True)
+
+    def _get_json_fields(self):
+        res = super()._get_json_fields()
+        res.append('stripe_payment_intent_secret')
+        return res
+
+    def _get_processing_info(self):
+        res = super()._get_processing_info()
+        if self.acquirer_id.provider == 'stripe':
+            stripe_info = {
+                'stripe_payment_intent': self.stripe_payment_intent,
+                'stripe_payment_intent_secret': self.stripe_payment_intent_secret,
+                'stripe_publishable_key': self.acquirer_id.stripe_publishable_key,
+            }
+            res.update(stripe_info)
+        return res
+
+    def _create_stripe_charge(self, acquirer_ref=None, tokenid=None, email=None):
+        raise NotImplementedError(
+            "This method can no longer be used with the payment_stripe_sca module."
+        )
+
+    def form_feedback(self, data, acquirer_name):
+        if data.get("reference") and acquirer_name == "stripe":
+            transaction = self.env["payment.transaction"].search(
+                [("reference", "=", data["reference"])]
+            )
+
+            url = "payment_intents/%s" % transaction.stripe_payment_intent
+            resp = transaction.acquirer_id._stripe_request(url)
+            if resp.get("charges") and resp.get("charges").get("total_count"):
+                resp = resp.get("charges").get("data")[0]
+
+            data.update(resp)
+            _logger.info(
+                "Stripe: entering form_feedback with post data %s"
+                % pprint.pformat(data)
+            )
+        # note: luckily, the base stripe module did not override this method, avoiding
+        # me from using a context key to avoid this call in the parent model
+        return super(PaymentTransactionStripeSCA, self).form_feedback(data, acquirer_name)
+
+    def _stripe_create_payment_intent(self, acquirer_ref=None, email=None):
+        if self.stripe_payment_intent:
+            _logger.info(
+                "_stripe_create_payment_intent: trying to create an intent when one already exists (tx #%s), refetching values for intent %s",
+                self.id, self.stripe_payment_intent
+            )
+            res =  self.acquirer_id._stripe_request("payment_intents/%s" % self.stripe_payment_intent, method="GET")
+            _logger.info(
+                "_stripe_create_payment_intent: Values received:\n%s", pprint.pformat(res)
+                )
+            return res
+        charge_params = {
+            "amount": int(
+                self.amount
+                if self.currency_id.name in INT_CURRENCIES
+                else float_round(self.amount * 100, 2)
+            ),
+            "currency": self.currency_id.name.lower(),
+            "confirm": True,
+            "off_session": True,
+            "payment_method": self.payment_token_id.stripe_payment_method,
+            "customer": self.payment_token_id.acquirer_ref,
+            "description": self.reference,
+        }
+        if not self.env.context.get('off_session'):
+            charge_params.update(setup_future_usage='off_session', off_session=False)
+        _logger.info(
+            "_stripe_create_payment_intent: Sending values to stripe, values:\n%s",
+            pprint.pformat(charge_params),
+        )
+
+        res = self.acquirer_id._stripe_request("payment_intents", charge_params)
+        if res.get("charges") and res.get("charges").get("total_count"):
+            res = res.get("charges").get("data")[0]
+
+        _logger.info(
+            "_stripe_create_payment_intent: Values received:\n%s", pprint.pformat(res)
+        )
+        return res
+
+    def stripe_s2s_do_transaction(self, **kwargs):
+        self.ensure_one()
+        result = self._stripe_create_payment_intent(
+            acquirer_ref=self.payment_token_id.acquirer_ref, email=self.partner_email
+        )
+        return self._stripe_s2s_validate_tree(result)
+
+    def _create_stripe_refund(self):
+        refund_params = {
+            "charge": self.acquirer_reference,
+            "amount": int(
+                float_round(self.amount * 100, 2)
+            ),  # by default, stripe refund the full amount (we don't really need to specify the value)
+            "metadata[reference]": self.reference,
+        }
+
+        _logger.info(
+            "_create_stripe_refund: Sending values to stripe URL, values:\n%s",
+            pprint.pformat(refund_params),
+        )
+        res = self.acquirer_id._stripe_request("refunds", refund_params)
+        _logger.info("_create_stripe_refund: Values received:\n%s", pprint.pformat(res))
+        return res
+
+    @api.model
+    def _stripe_form_get_tx_from_data(self, data):
+        """ Given a data dict coming from stripe, verify it and find the related
+        transaction record. """
+        reference = data.get("reference")
+        if not reference:
+            stripe_error = data.get("error", {}).get("message", "")
+            _logger.error(
+                "Stripe: invalid reply received from stripe API, looks like "
+                "the transaction failed. (error: %s)",
+                stripe_error or "n/a",
+            )
+            error_msg = _("We're sorry to report that the transaction has failed.")
+            if stripe_error:
+                error_msg += " " + (
+                    _("Stripe gave us the following info about the problem: '%s'")
+                    % stripe_error
+                )
+            error_msg += " " + _(
+                "Perhaps the problem can be solved by double-checking your "
+                "credit card details, or contacting your bank?"
+            )
+            raise ValidationError(error_msg)
+
+        tx = self.search([("reference", "=", reference)])
+        if not tx:
+            error_msg = _("Stripe: no order found for reference %s") % reference
+            _logger.error(error_msg)
+            raise ValidationError(error_msg)
+        elif len(tx) > 1:
+            error_msg = _("Stripe: %s orders found for reference %s") % (
+                len(tx),
+                reference,
+            )
+            _logger.error(error_msg)
+            raise ValidationError(error_msg)
+        return tx[0]
+
+    def _stripe_s2s_validate_tree(self, tree):
+        self.ensure_one()
+        if self.state not in ("draft", "pending"):
+            _logger.info(
+                "Stripe: trying to validate an already validated tx (ref %s)",
+                self.reference,
+            )
+            return True
+
+        status = tree.get("status")
+        tx_id = tree.get("id")
+        tx_secret = tree.get("client_secret")
+        vals = {"date": fields.datetime.now(), "acquirer_reference": tx_id, "stripe_payment_intent": tx_id, "stripe_payment_intent_secret": tx_secret}
+        if status == "succeeded":
+            self.write(vals)
+            self._set_transaction_done()
+            self.execute_callback()
+            if self.type == "form_save":
+                s2s_data = {
+                    "customer": tree.get("customer"),
+                    "payment_method": tree.get("payment_method"),
+                    "card": tree.get("payment_method_details").get("card"),
+                    "acquirer_id": self.acquirer_id.id,
+                    "partner_id": self.partner_id.id,
+                }
+                token = self.acquirer_id.stripe_s2s_form_process(s2s_data)
+                self.payment_token_id = token.id
+            if self.payment_token_id:
+                self.payment_token_id.verified = True
+            return True
+        if status in ("processing", "requires_action"):
+            self.write(vals)
+            self._set_transaction_pending()
+            return True
+        else:
+            error = tree.get("failure_message")
+            _logger.warn(error)
+            vals.update({"state_message": error})
+            self.write(vals)
+            self._set_transaction_cancel()
+            return False
+
+    def _stripe_form_get_invalid_parameters(self, data):
+        invalid_parameters = []
+        if data.get("amount") != int(
+            self.amount
+            if self.currency_id.name in INT_CURRENCIES
+            else float_round(self.amount * 100, 2)
+        ):
+            invalid_parameters.append(("Amount", data.get("amount"), self.amount * 100))
+        if data.get("currency").upper() != self.currency_id.name:
+            invalid_parameters.append(
+                ("Currency", data.get("currency"), self.currency_id.name)
+            )
+        if (
+            data.get("payment_intent")
+            and data.get("payment_intent") != self.stripe_payment_intent
+        ):
+            invalid_parameters.append(
+                (
+                    "Payment Intent",
+                    data.get("payment_intent"),
+                    self.stripe_payment_intent,
+                )
+            )
+        return invalid_parameters
+
+
+class PaymentTokenStripeSCA(models.Model):
+    _inherit = "payment.token"
+
+    stripe_payment_method = fields.Char("Payment Method ID")
+
+    @api.model
+    def stripe_create(self, values):
+        if values.get("stripe_payment_method") and not values.get("acquirer_ref"):
+            partner_id = self.env["res.partner"].browse(values.get("partner_id"))
+            payment_acquirer = self.env["payment.acquirer"].browse(
+                values.get("acquirer_id")
+            )
+
+            # create customer to stipe
+            customer_data = {"email": partner_id.email}
+            cust_resp = payment_acquirer._stripe_request("customers", customer_data)
+
+            # link customer with payment method
+            api_url_payment_method = (
+                "payment_methods/%s/attach" % values["stripe_payment_method"]
+            )
+            method_data = {"customer": cust_resp.get("id")}
+            payment_acquirer._stripe_request(api_url_payment_method, method_data)
+            return {"acquirer_ref": cust_resp["id"]}
+        return values
+
+    def _stripe_create_customer(self, token, description=None, acquirer_id=None):
+        raise NotImplementedError(
+            "This method can no longer be used with the payment_stripe_sca module."
+        )
+
diff --git a/addons/payment_stripe_sca/static/description/icon.png b/addons/payment_stripe_sca/static/description/icon.png
new file mode 100644
index 0000000000000000000000000000000000000000..497b2d65bd916dba91393a3143966e5d97ca004f
GIT binary patch
literal 25859
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
E10U#i$N&HU

literal 0
HcmV?d00001

diff --git a/addons/payment_stripe_sca/static/description/icon.svg b/addons/payment_stripe_sca/static/description/icon.svg
new file mode 100644
index 00000000000..f169bb0d45e
--- /dev/null
+++ b/addons/payment_stripe_sca/static/description/icon.svg
@@ -0,0 +1 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><!-- Generator: Gravit.io --><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" style="isolation:isolate" viewBox="0 0 70 70" width="70pt" height="70pt"><defs><clipPath id="_clipPath_9pLMMgitI8J1StLiEfUXLEx0UjEaF7gy"><rect width="70" height="70"/></clipPath></defs><g clip-path="url(#_clipPath_9pLMMgitI8J1StLiEfUXLEx0UjEaF7gy)"><clipPath id="_clipPath_oga5uuxx3E0gTH5lUvcUI2SkbTwzbdcf"><path d=" M 4 0 L 65 0 C 69 0 70 1 70 5 L 70 65 C 70 69 69 70 65 70 L 4 70 C 1 70 0 69 0 65 L 0 5 C 0 1 1 0 4 0 Z " fill="rgb(255,255,255)"/></clipPath><g clip-path="url(#_clipPath_oga5uuxx3E0gTH5lUvcUI2SkbTwzbdcf)"><g filter="url(#QtJFuMNyeHoJjoERoMTGiyMkEFlKPbey)"><linearGradient id="_lgradient_1" x1="0" y1="0.5" x2="0.7071067811865476" y2="-0.20710678118654746" gradientTransform="matrix(70,0,0,70,0,0)" gradientUnits="userSpaceOnUse"><stop offset="0%" stop-opacity="1" style="stop-color:rgb(106,158,186)"/><stop offset="100%" stop-opacity="1" style="stop-color:rgb(148,182,200)"/></linearGradient><path d=" M 0 0 L 70 0 L 70 70 L 0 70 L 0 0 Z " fill-rule="evenodd" fill="url(#_lgradient_1)"/><path d=" M 4 1 L 65 1 C 67.667 1 69.333 1.667 70 3 L 70 0 L 0 0 L 0 3 C 0.667 1.667 2 1 4 1 Z " fill-rule="evenodd" fill="rgb(255,255,255)" fill-opacity="0.383"/><g opacity="0.324"><path d=" M 4 69 C 2 69 0 68 0 65 L 0 33.916 L 14 17.5 L 27.818 22.703 L 37.25 22.703 L 48 23 L 51.576 24.968 L 51.34 46.978 L 39.224 69 L 4 69 L 4 69 Z " fill-rule="evenodd" fill="rgb(57,57,57)"/></g><path d=" M 4 69 L 65 69 C 67.667 69 69.333 68 70 66 L 70 70 L 0 70 L 0 66 C 0.667 68 2 69 4 69 Z " fill-rule="evenodd" fill="rgb(0,0,0)" fill-opacity="0.383"/><g opacity="0.3"><path d=" M 19.25 46 L 21.964 46 L 21.964 47.212 C 21.964 47.4 22.116 47.555 22.303 47.555 L 48.697 47.555 C 48.885 47.553 49.037 47.4 49.036 47.212 L 49.036 37.5 L 32.5 37.5 C 32.833 34.167 32.335 32 31.006 31 L 49.036 31 L 49.036 27.788 C 49.037 27.6 48.885 27.447 48.697 27.445 L 29.765 27.445 C 30.126 26.435 30.335 25.521 30.392 24.703 L 49.036 24.703 C 50.536 24.703 51.75 25.931 51.75 27.445 L 51.75 47.555 C 51.75 49.069 50.537 50.297 49.036 50.297 L 21.964 50.297 C 20.464 50.297 19.25 49.069 19.25 47.555 L 19.25 46 Z  M 15.46 55.642 L 14.423 55.642 L 14.423 55 L 17.256 55 L 17.256 55.642 L 16.219 55.642 L 16.219 58.474 L 15.459 58.474 L 15.459 55.642 L 15.46 55.642 Z  M 17.422 55 L 18.492 55 L 19.301 57.389 L 19.311 57.389 L 20.075 55 L 21.145 55 L 21.145 58.474 L 20.434 58.474 L 20.434 56.012 L 20.424 56.012 L 19.577 58.474 L 18.991 58.474 L 18.143 56.036 L 18.133 56.036 L 18.133 58.474 L 17.422 58.474 L 17.422 55 Z  M 23.082 27.008 C 27.338 28.531 29.978 30.335 29.978 34.657 C 29.978 37.269 29.077 39.29 27.338 40.658 C 25.785 41.902 23.486 42.555 20.722 42.555 C 17.242 42.555 13.888 41.498 12.087 40.471 L 13.019 34.657 C 15.131 35.901 18.361 36.864 20.318 36.864 C 21.902 36.864 22.772 36.274 22.772 35.248 C 22.772 34.19 21.871 33.506 19.169 32.542 C 14.976 31.019 12.398 29.215 12.398 24.986 C 12.398 22.654 13.236 20.726 14.851 19.389 C 16.404 18.114 18.579 17.43 21.188 17.43 C 24.884 17.43 27.555 18.457 28.859 19.079 L 27.928 24.831 C 26.281 24.023 23.89 23.121 21.56 23.121 C 20.287 23.121 19.572 23.618 19.572 24.489 C 19.572 25.515 20.815 26.169 23.082 27.008 L 23.082 27.008 Z " fill="rgb(0,0,0)"/></g><path d=" M 19.25 44 L 21.964 44 L 21.964 45.212 C 21.964 45.4 22.116 45.555 22.303 45.555 L 48.697 45.555 C 48.885 45.553 49.037 45.4 49.036 45.212 L 49.036 35.5 L 32.5 35.5 C 32.833 32.167 32.335 30 31.006 29 L 49.036 29 L 49.036 25.788 C 49.037 25.6 48.885 25.447 48.697 25.445 L 29.765 25.445 C 30.126 24.435 30.335 23.521 30.392 22.703 L 49.036 22.703 C 50.536 22.703 51.75 23.931 51.75 25.445 L 51.75 45.555 C 51.75 47.069 50.537 48.297 49.036 48.297 L 21.964 48.297 C 20.464 48.297 19.25 47.069 19.25 45.555 L 19.25 44 Z  M 15.46 53.642 L 14.423 53.642 L 14.423 53 L 17.256 53 L 17.256 53.642 L 16.219 53.642 L 16.219 56.474 L 15.459 56.474 L 15.459 53.642 L 15.46 53.642 Z  M 17.422 53 L 18.492 53 L 19.301 55.389 L 19.311 55.389 L 20.075 53 L 21.145 53 L 21.145 56.474 L 20.434 56.474 L 20.434 54.012 L 20.424 54.012 L 19.577 56.474 L 18.991 56.474 L 18.143 54.036 L 18.133 54.036 L 18.133 56.474 L 17.422 56.474 L 17.422 53 Z  M 23.082 25.008 C 27.338 26.531 29.978 28.335 29.978 32.657 C 29.978 35.269 29.077 37.29 27.338 38.658 C 25.785 39.902 23.486 40.555 20.722 40.555 C 17.242 40.555 13.888 39.498 12.087 38.471 L 13.019 32.657 C 15.131 33.901 18.361 34.864 20.318 34.864 C 21.902 34.864 22.772 34.274 22.772 33.248 C 22.772 32.19 21.871 31.506 19.169 30.542 C 14.976 29.019 12.398 27.215 12.398 22.986 C 12.398 20.654 13.236 18.726 14.851 17.389 C 16.404 16.114 18.579 15.43 21.188 15.43 C 24.884 15.43 27.555 16.457 28.859 17.079 L 27.928 22.831 C 26.281 22.023 23.89 21.121 21.56 21.121 C 20.287 21.121 19.572 21.618 19.572 22.489 C 19.572 23.515 20.815 24.169 23.082 25.008 L 23.082 25.008 Z " fill="rgb(255,255,255)"/></g><defs><filter id="QtJFuMNyeHoJjoERoMTGiyMkEFlKPbey" x="-200%" y="-200%" width="400%" height="400%" filterUnits="objectBoundingBox" color-interpolation-filters="sRGB"><feGaussianBlur xmlns="http://www.w3.org/2000/svg" in="SourceGraphic" stdDeviation="2.146804531419514"/><feOffset xmlns="http://www.w3.org/2000/svg" dx="0" dy="0" result="pf_100_offsetBlur"/><feFlood xmlns="http://www.w3.org/2000/svg" flood-color="#000000" flood-opacity="0.65"/><feComposite xmlns="http://www.w3.org/2000/svg" in2="pf_100_offsetBlur" operator="in" result="pf_100_dropShadow"/><feBlend xmlns="http://www.w3.org/2000/svg" in="SourceGraphic" in2="pf_100_dropShadow" mode="normal"/></filter></defs></g><image xlink:href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACkAAAATCAYAAAANgSQ9AAACLElEQVRIS+2VwU0cQRBF/4/AJgJMBEAEhgAsQwSICLxEYIgAkAOwffLRJgI4++J1BF4iwBmU9VrVo6Y1w+wBWVqJPu32Vne/+r+q1tqA5Q1g1Avkc7n0ouS6SkbEG0nvJa1s3/TnZpWMiIM8vJp6dJ2YmbNfJP2QtCfpwfZxGz8JGREcPGmCgTyzzWWKiNeSPks6morJuCtJHzKG83wfVkTcSbpq7l1KWthmv6xRyIhYSLqUdC8JWDJE0QPbywT8JQmbiOFCoIk5ah+ICJLjt1eSlrb3O0juxua/mRR3na8DSeBbSae2gSzKNRedS/qYgHvN/hCTZ1D5u6SvmRB37theZR3iRL8KtKQb27wzqWS1GumxaJA+H2d/t01irOaakjlNNXHn2vYiIgAgCVwbW7e2i9NTdmMjYNt5mjoEtjRPRETuH/YJdFZiITZvJeSftHYnISkfSoQ7e9vjSchqb2ZJpjzEg/tpVX18EjIiqtWlERIehxCAuuT3ApmA1DgWl0ZEiFnIqkg2Capi7wV1kh35qGZ7v0amQxtynUlXSBqrjKGmB56GZO51HVrHSFtPNA72o27pzMYBPj7k1kVDBwzjiHhAB7tHkpyFrMphFavUjaRj5lmqC2AtgzbuMC2lc+9tY++wIqKWyidJ71LBnpHvTJZydqpx6Lxai8QxCxmwZZA3iqEwCdQG+521xj5/c0X5DrJOjm+SfmZDjUFifUl+9m9x7PT/3tsIyH8quhYjfI9eKwAAAABJRU5ErkJggg==" x="-1" y="52" width="41" height="19" style=""/></g></svg>
\ No newline at end of file
diff --git a/addons/payment_stripe_sca/static/description/index.html b/addons/payment_stripe_sca/static/description/index.html
new file mode 100644
index 00000000000..284cee7c413
--- /dev/null
+++ b/addons/payment_stripe_sca/static/description/index.html
@@ -0,0 +1,64 @@
+<section class="oe_container">
+    <div class="oe_row oe_spaced">
+        <div class="oe_span12">
+            <h2 class="oe_slogan">Stripe - Strong Customer Authentication</h2>
+            <h3 class="oe_slogan">Add support for strong customer authentication as part of the EU PSD2</h3>
+        </div>
+        <div class="oe_span12">
+            <p class='oe_mt32'>
+                The PSD2 - the second edition of the Payment Services Directive - is coming into full effect in
+                the European Union (EU) and the European Economic Area (EEA) on September 14th, 2019. This
+                directive may indirectly impact your business by requiring stronger authentication mechanisms
+                for online payments.
+            </p>
+            <h2 class="oe_mt32">Am I impacted by the PSD2 directive?</h2>
+            <p>You are impacted by this change if all of these statements applies to your business:
+                <ul>
+                    <li>You are legally based in the EU/EEA</li>
+                    <li>You accept payments from customers based in the EU/EEA</li>
+                    <li>You accept payments via cards (credit/debit)</li>
+                </ul>
+            </p>
+            <h2 class="oe_mt32">What should I do if I am impacted?</h2>
+            <p>
+                This directive does not bind you legally to do anything in particular regarding
+                your business processes - it applies to payment processors, acquirers and banks.
+                Legally, you don't have to do anything to comply with this directive - it does not
+                apply to you.
+            </p>
+            <p>
+                You might however be indirectly impacted because some online payment flows will
+                change for customers that pay online - they might need to authenticate themselves during
+                a transaction that previously didn't require it. This is why Odoo is adapting some of
+                its integration with payment acquirers to avoid disruptions in your business flows.
+            </p>
+            <p>
+                If you use Stripe and are impacted by the PSD2 directive, then simply installing this
+                module will avoid problems for your online customers during their payment flow. No extra
+                configuration is needed once the module is installed.
+            </p>
+            <h2 class="oe_mt32">What happens if I don't install this update?</h2>
+            <p>If you don't install this update, some of your customers may be unable to pay you.
+                There is no reason not to install it if you are impacted by the directive.</p>
+            <h2 class="oe_mt32">I'm not impacted by the PSD2, should I install this module anyway?</h2>
+            <p>While not required, installing this module remains a good idea nonetheless since
+                it will switch your instance to newer - and thus more future-proof - APIs of the Stripe
+                payment acquirer.
+            </p>
+            <h2 class="oe_mt32">What will changes for my online customers</h2>
+            <p>The interface displayed to your customers will change when they pay you online.</p>
+            <p>If your Stripe acquirer is configured with the payment flow 'Redirection to the acquirer website'
+                in Odoo, the small payment overlay will be replaced by a full-screen interface.
+            </p>
+            <img src="redirection_flow.png" class="img-fluid">
+            <p>If your Stripe acquirer is configured with the payment flow 'Payment from Odoo'
+                    in Odoo, the credit card input form will look slightly different.
+            </p>
+            <img src="s2s_flow.png" class="img-fluid">
+            <p>The rest of the payment experience remains the same.</p>
+            </div>
+    </div>
+</section>
+
+
+
diff --git a/addons/payment_stripe_sca/static/description/redirection_flow.png b/addons/payment_stripe_sca/static/description/redirection_flow.png
new file mode 100644
index 0000000000000000000000000000000000000000..593fb5e1aab76e80ccfa047cd1502c5452a42ab2
GIT binary patch
literal 39730
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
P4s@DCB!^0acc1z<YALo`

literal 0
HcmV?d00001

diff --git a/addons/payment_stripe_sca/static/description/s2s_flow.png b/addons/payment_stripe_sca/static/description/s2s_flow.png
new file mode 100644
index 0000000000000000000000000000000000000000..1211a8deb239938543fe405d798b3594d7dd319e
GIT binary patch
literal 14935
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
E0G6z>3jhEB

literal 0
HcmV?d00001

diff --git a/addons/payment_stripe_sca/static/src/js/payment_form.js b/addons/payment_stripe_sca/static/src/js/payment_form.js
new file mode 100644
index 00000000000..e4f7b8f3257
--- /dev/null
+++ b/addons/payment_stripe_sca/static/src/js/payment_form.js
@@ -0,0 +1,188 @@
+odoo.define('payment_stripe.payment_form', function (require) {
+    "use strict";
+    
+    var ajax = require('web.ajax');
+    var core = require('web.core');
+    var rpc = require('web.rpc');
+    var Dialog = require('web.Dialog');
+    var PaymentForm = require('payment.payment_form');
+    
+    var _t = core._t;
+    
+    PaymentForm.include({
+    
+        willStart: function () {
+            return this._super.apply(this, arguments).then(function () {
+                return ajax.loadJS("https://js.stripe.com/v3/");
+            })
+        },
+    
+        //--------------------------------------------------------------------------
+        // Private
+        //--------------------------------------------------------------------------
+    
+        /**
+         * called when clicking on pay now or add payment event to create token for credit card/debit card.
+         *
+         * @private
+         * @param {Event} ev
+         * @param {DOMElement} checkedRadio
+         * @param {Boolean} addPmEvent
+         */
+        _createStripeToken: function (ev, $checkedRadio, addPmEvent) {
+            var self = this;
+            if (ev.type === 'submit') {
+                var button = $(ev.target).find('*[type="submit"]')[0]
+            } else {
+                var button = ev.target;
+            }
+            this.disableButton(button);
+            var acquirerID = this.getAcquirerIdFromRadio($checkedRadio);
+            var acquirerForm = this.$('#o_payment_add_token_acq_' + acquirerID);
+            var inputsForm = $('input', acquirerForm);
+            if (this.options.partnerId === undefined) {
+                console.warn('payment_form: unset partner_id when adding new token; things could go wrong');
+            }
+    
+            var formData = self.getFormData(inputsForm);
+            var stripe = this.stripe;
+            var card = this.stripe_card_element;
+            if (card._invalid) {
+                return;
+            }
+            return rpc.query({
+                route: '/payment/stripe/s2s/create_setup_intent',
+                params: {'acquirer_id': formData.acquirer_id}
+            }).then(function(intent_secret){
+                // need to convert between ES6 promises and jQuery 2 deferred \o/
+                return $.Deferred(function(defer) {
+                    stripe.handleCardSetup(intent_secret, card)
+                        .then(function(result) {defer.resolve(result)})
+                    });
+            }).then(function(result) {
+                if (result.error) {
+                    return $.Deferred().reject({"message": {"data": { "message": result.error.message}}});
+                } else {
+                    _.extend(formData, {"payment_method": result.setupIntent.payment_method});
+                    return rpc.query({
+                        route: formData.data_set,
+                        params: formData,
+                    })
+                }
+            }).then(function(result) {
+                if (addPmEvent) {
+                    if (formData.return_url) {
+                        window.location = formData.return_url;
+                    } else {
+                        window.location.reload();
+                    }
+                } else {
+                    $checkedRadio.val(result.id);
+                    self.el.submit();
+                }
+            }).fail(function (error, event) {
+                // if the rpc fails, pretty obvious
+                self.enableButton(button);
+                self.displayError(
+                    _t('Unable to save card'),
+                    _t("We are not able to add your payment method at the moment. ") +
+                        error.message.data.message
+                );
+            });
+        },
+        /**
+         * called when clicking a Stripe radio if configured for s2s flow; instanciates the card and bind it to the widget.
+         *
+         * @private
+         * @param {DOMElement} checkedRadio
+         */
+        _bindStripeCard: function ($checkedRadio) {
+            var acquirerID = this.getAcquirerIdFromRadio($checkedRadio);
+            var acquirerForm = this.$('#o_payment_add_token_acq_' + acquirerID);
+            var inputsForm = $('input', acquirerForm);
+            var formData = this.getFormData(inputsForm);
+            var stripe = Stripe(formData.stripe_publishable_key);
+            var element = stripe.elements();
+            var card = element.create('card', {hidePostalCode: true});
+            card.mount('#card-element');
+            card.on('ready', function(ev) {
+                card.focus();
+            });
+            card.addEventListener('change', function (event) {
+                var displayError = document.getElementById('card-errors');
+                displayError.textContent = '';
+                if (event.error) {
+                    displayError.textContent = event.error.message;
+                }
+            });
+            this.stripe = stripe;
+            this.stripe_card_element = card;
+        },
+        /**
+         * destroys the card element and any stripe instance linked to the widget.
+         *
+         * @private
+         */
+        _unbindStripeCard: function () {
+            if (this.stripe_card_element) {
+                this.stripe_card_element.destroy();
+            }
+            this.stripe = undefined;
+            this.stripe_card_element = undefined;
+        },
+        /**
+         * @override
+         */
+        updateNewPaymentDisplayStatus: function () {
+            var $checkedRadio = this.$('input[type="radio"]:checked');
+    
+            if ($checkedRadio.length !== 1) {
+                return;
+            }
+            var provider = $checkedRadio.data('provider')
+            if (provider === 'stripe') {
+                // always re-init stripe (in case of multiple acquirers for stripe, make sure the stripe instance is using the right key)
+                this._unbindStripeCard();
+                if (this.isNewPaymentRadio($checkedRadio)) {
+                    this._bindStripeCard($checkedRadio);
+                }
+            }
+            return this._super.apply(this, arguments);
+        },
+    
+        //--------------------------------------------------------------------------
+        // Handlers
+        //--------------------------------------------------------------------------
+    
+        /**
+         * @override
+         */
+        payEvent: function (ev) {
+            ev.preventDefault();
+            var $checkedRadio = this.$('input[type="radio"]:checked');
+    
+            // first we check that the user has selected a stripe as s2s payment method
+            if ($checkedRadio.length === 1 && $checkedRadio.data('provider') === 'stripe' && this.isNewPaymentRadio($checkedRadio)) {
+                return this._createStripeToken(ev, $checkedRadio);
+            } else {
+                return this._super.apply(this, arguments);
+            }
+        },
+        /**
+         * @override
+         */
+        addPmEvent: function (ev) {
+            ev.stopPropagation();
+            ev.preventDefault();
+            var $checkedRadio = this.$('input[type="radio"]:checked');
+    
+            // first we check that the user has selected a stripe as add payment method
+            if ($checkedRadio.length === 1 && this.isNewPaymentRadio($checkedRadio) && $checkedRadio.data('provider') === 'stripe') {
+                return this._createStripeToken(ev, $checkedRadio, true);
+            } else {
+                return this._super.apply(this, arguments);
+            }
+        },
+    });
+});
+    
\ No newline at end of file
diff --git a/addons/payment_stripe_sca/static/src/js/payment_processing.js b/addons/payment_stripe_sca/static/src/js/payment_processing.js
new file mode 100644
index 00000000000..adb57e6221a
--- /dev/null
+++ b/addons/payment_stripe_sca/static/src/js/payment_processing.js
@@ -0,0 +1,48 @@
+odoo.define('payment_stripe_sca.processing', function (require) {
+    'use strict';
+
+    var ajax = require('web.ajax');
+    var rpc = require('web.rpc')
+    var PaymentProcessing = require('payment.processing');
+
+    return PaymentProcessing.include({
+        init: function () {
+            this._super.apply(this, arguments);
+            this._authInProgress = false;
+        },
+        willStart: function () {
+            return this._super.apply(this, arguments).then(function () {
+                return ajax.loadJS("https://js.stripe.com/v3/");
+            })
+        },
+        _stripeAuthenticate: function (tx) {
+            var stripe = Stripe(tx.stripe_publishable_key);
+            return $.Deferred(function(defer) {
+                stripe.handleCardPayment(tx.stripe_payment_intent_secret)
+                    .then(function(result) {defer.resolve(result)})
+            }).then(function(result) {
+                if (result.error) {
+                    return $.Deferred().reject({"message": {"data": { "message": result.error.message}}});
+                }
+                return rpc.query({
+                    route: '/payment/stripe/s2s/process_payment_intent',
+                    params: _.extend({}, result.paymentIntent, {reference: tx.reference}),
+                });
+            }).then(function(result) {
+                window.location = '/payment/process';
+            }).fail(function (error) {
+                this._authInProgress = false;
+            });
+        },
+        processPolledData: function(transactions) {
+            this._super.apply(this, arguments);
+            for (var itx=0; itx < transactions.length; itx++) {
+                var tx = transactions[itx];
+                if (tx.acquirer_provider === 'stripe' && tx.state === 'pending' && tx.stripe_payment_intent_secret && !this._authInProgress) {
+                    this._authInProgress = true;
+                    this._stripeAuthenticate(tx);
+                }
+            }
+        },
+    });
+});
\ No newline at end of file
diff --git a/addons/payment_stripe_sca/static/src/js/stripe_sca.js b/addons/payment_stripe_sca/static/src/js/stripe_sca.js
new file mode 100644
index 00000000000..74aac900006
--- /dev/null
+++ b/addons/payment_stripe_sca/static/src/js/stripe_sca.js
@@ -0,0 +1,82 @@
+odoo.define('payment_stripe.stripe', function (require) {
+    "use strict";
+    
+    var ajax = require('web.ajax');
+    var core = require('web.core');
+    
+    var qweb = core.qweb;
+    var _t = core._t;
+    
+    ajax.loadXML('/payment_stripe/static/src/xml/stripe_templates.xml', qweb);
+    
+    if ($.blockUI) {
+        // our message needs to appear above the modal dialog
+        $.blockUI.defaults.baseZ = 2147483647; //same z-index as StripeCheckout
+        $.blockUI.defaults.css.border = '0';
+        $.blockUI.defaults.css["background-color"] = '';
+        $.blockUI.defaults.overlayCSS["opacity"] = '0.9';
+    }
+    
+    require('web.dom_ready');
+    if (!$('.o_payment_form').length) {
+        return Promise.reject("DOM doesn't contain '.o_payment_form'");
+    }
+    
+    var observer = new MutationObserver(function (mutations, observer) {
+        for (var i = 0; i < mutations.length; ++i) {
+            for (var j = 0; j < mutations[i].addedNodes.length; ++j) {
+                if (mutations[i].addedNodes[j].tagName.toLowerCase() === "form" && mutations[i].addedNodes[j].getAttribute('provider') === 'stripe') {
+                    _redirectToStripeCheckout($(mutations[i].addedNodes[j]));
+                }
+            }
+        }
+    });
+    
+    function displayError(message) {
+        var wizard = $(qweb.render('stripe.error', {'msg': message || _t('Payment error')}));
+        wizard.appendTo($('body')).modal({'keyboard': true});
+        if ($.blockUI) {
+            $.unblockUI();
+        }
+        $("#o_payment_form_pay").removeAttr('disabled');
+    }
+    
+    
+    function _redirectToStripeCheckout(providerForm) {
+        // Open Checkout with further options
+        if ($.blockUI) {
+            var msg = _t("Just one more second, we are redirecting you to Stripe...");
+            $.blockUI({
+                'message': '<h2 class="text-white"><img src="/web/static/src/img/spin.png" class="fa-pulse"/>' +
+                        '    <br />' + msg +
+                        '</h2>'
+            });
+        }
+    
+        var paymentForm = $('.o_payment_form');
+        if (!paymentForm.find('i').length) {
+            paymentForm.append('<i class="fa fa-spinner fa-spin"/>');
+            paymentForm.attr('disabled', 'disabled');
+        }
+    
+        var _getStripeInputValue = function (name) {
+            return providerForm.find('input[name="' + name + '"]').val();
+        };
+    
+        var stripe = Stripe(_getStripeInputValue('stripe_key'));
+    
+        stripe.redirectToCheckout({
+            sessionId: _getStripeInputValue('session_id')
+        }).then(function (result) {
+            if (result.error) {
+                displayError(result.error.message);
+            }
+        });
+    }
+    
+    $.getScript("https://js.stripe.com/v3/", function (data, textStatus, jqxhr) {
+        observer.observe(document.body, {childList: true});
+        _redirectToStripeCheckout($('form[provider="stripe"]'));
+    });
+    });
+    
\ No newline at end of file
diff --git a/addons/payment_stripe_sca/views/assets.xml b/addons/payment_stripe_sca/views/assets.xml
new file mode 100644
index 00000000000..6dd7fbab536
--- /dev/null
+++ b/addons/payment_stripe_sca/views/assets.xml
@@ -0,0 +1,8 @@
+<odoo>
+    <template id="assets_frontend" inherit_id="web.assets_frontend" name="Payment Stripe SCA Assets">
+        <xpath expr="." position="inside">
+            <script type="text/javascript" src="/payment_stripe_sca/static/src/js/payment_form.js"></script>
+            <script type="text/javascript" src="/payment_stripe_sca/static/src/js/payment_processing.js"></script>
+        </xpath>
+    </template>
+</odoo>
diff --git a/addons/payment_stripe_sca/views/payment_templates.xml b/addons/payment_stripe_sca/views/payment_templates.xml
new file mode 100644
index 00000000000..0590c2aae22
--- /dev/null
+++ b/addons/payment_stripe_sca/views/payment_templates.xml
@@ -0,0 +1,42 @@
+<?xml version="1.0" encoding="utf-8"?>
+<odoo>
+    <data>
+        <template id="stripe_form" inherit_id="payment_stripe.stripe_form">
+            <xpath expr="//script" position="before">
+                <input type='hidden' name='session_id' t-att-value='session_id'/>
+            </xpath>
+            <xpath expr="//script" position="replace">
+                <script type="text/javascript">
+                    odoo.define(function (require) {
+                        var ajax = require('web.ajax');
+                        ajax.loadJS("/payment_stripe_sca/static/src/js/stripe_sca.js");
+                    });
+                </script>
+            </xpath>
+        </template>
+
+        <template id="stripe_s2s_form" inherit_id="payment_stripe.stripe_s2s_form">
+            <xpath expr="//div" position="replace">
+                <input type="hidden" name="data_set" value="/payment/stripe/s2s/create_json_3ds"/>
+                <input type="hidden" name="acquirer_id" t-att-value="id"/>
+                <input type="hidden" name="stripe_publishable_key" t-att-value="acq.sudo().stripe_publishable_key"/>
+                <input type="hidden" name="currency_id" t-att-value="currency_id"/>
+                <input t-if="return_url" type="hidden" name="return_url" t-att-value="return_url"/>
+                <input t-if="partner_id" type="hidden" name="partner_id" t-att-value="partner_id"/>
+                <input type="hidden" name="csrf_token" t-att-value="request.csrf_token()"/>
+                <div id="payment-form">
+                    <div id="card-element" class="m-3"/>
+                    <div id="card-errors" class="m-3 text-danger"/>
+                </div>
+            </xpath>
+            <xpath expr="//input[@name='data_set']" position="replace"/>
+        </template>
+
+        <template inherit_id="payment.payment_tokens_list" id="payment_tokens_list" name="Payment Tokens list">
+            <!-- add the provider on saved tokens -->
+            <xpath expr="//t[@t-foreach='pms']//input[@name='pm_id'][@type='radio'][@t-att-value='pm.id']" position="attributes">
+                <attribute name="t-att-data-provider">pm.acquirer_id.provider</attribute>
+            </xpath>
+        </template>
+    </data>
+</odoo>
\ No newline at end of file