[IMP] payment_iyzico: support webhooks

This commit adds webhook support for the Iyzico payment provider.

task-5067754

closes #228969

Related: odoo/documentation#14702
Signed-off-by: Antoine Vandevenne (anv) <[email protected]>

Author: kcv-odoo

addons/payment_iyzico/const.py

@@ -1,6 +1,7 @@
 # Part of Odoo. See LICENSE file for full copyright and licensing details.
 
 PAYMENT_RETURN_ROUTE = '/payment/iyzico/return'
+WEBHOOK_ROUTE = '/payment/iyzico/webhook'
 
 # The currencies supported by Iyzico, in ISO 4217 format.
 SUPPORTED_CURRENCIES = [

addons/payment_iyzico/controllers/main.py

@@ -41,6 +41,25 @@ def iyzico_return_from_payment(self, tx_ref='', **data):
 
         return request.redirect('/payment/status')
 
+    @http.route(const.WEBHOOK_ROUTE, type='http', auth='public', methods=['POST'], csrf=False)
+    def iyzico_webhook(self):
+        """Process the payment data sent by Iyzico to the webhook.
+
+        See https://docs.iyzico.com/en/advanced/webhook.
+
+        :return: An empty response to acknowledge the notification.
+        :rtype: odoo.http.Response
+        """
+        data = request.get_json_data()
+        _logger.info("Notification received from Iyzico with data:\n%s", pprint.pformat(data))
+
+        if token := data.get('token'):
+            self._verify_and_process(data['paymentConversationId'], token)
+        else:
+            _logger.warning("Received webhook data with missing token.")
+
+        return request.make_json_response('')  # Acknowledge the notification.
+
     @staticmethod
     def _verify_and_process(tx_ref, token):
         """Verify and process the payment data sent by Iyzico.

addons/payment_iyzico/tests/common.py

@@ -25,3 +25,7 @@ def setUpClass(cls):
             'paymentStatus': 'SUCCESS',
             'token': 'dummy_token',
         }
+        cls.webhook_data = {
+            **cls.payment_data,
+            'paymentConversationId': cls.reference,
+        }

addons/payment_iyzico/tests/test_processing_flows.py

@@ -31,3 +31,18 @@ def test_redirect_notification_triggers_processing(self):
         ) as process_mock:
             self._make_http_post_request(url, data=self.return_data)
         self.assertEqual(process_mock.call_count, 1)
+
+    @mute_logger('odoo.addons.payment_iyzico.controllers.main')
+    def test_webhook_notification_triggers_processing(self):
+        """Test that receiving a valid webhook notification triggers the processing of the
+        payment data."""
+        self._create_transaction('redirect')
+        url = self._build_url(const.WEBHOOK_ROUTE)
+        with patch(
+            'odoo.addons.payment.models.payment_provider.PaymentProvider._send_api_request',
+            return_value=self.payment_data
+        ), patch(
+            'odoo.addons.payment.models.payment_transaction.PaymentTransaction._process'
+        ) as process_mock:
+            self._make_json_request(url, data=self.webhook_data)
+        self.assertEqual(process_mock.call_count, 1)