PayU Europe payment page supports in OPF

postman/payu-europe/PAYMENT_PAGE/README.md

@@ -0,0 +1,143 @@
+## Introduction 
+This Postman Collection aids in integrating [PayU Europe Payment Page](https://developers.payu.com/europe/docs/get-started/integration-overview/accept-payment/#example) into the Open Payment Framework (OPF).
+
+The integration supports:
+
+* Authorize card
+* Settlement
+* Refund
+* Reversal
+
+### In summary 
+In summary, to import the [Postman Collection](mapping_configuration.json), this page will guide you through the following steps:
+
+a) [Create your PayU Europe test account](https://registration-merch-prod.snd.payu.com/boarding/#/registerSandbox/).
+
+b) Create a PayU Europe integration in OPF.
+
+c) Get the credentials for your PayU Europe integration.
+
+d) Prepare the [Postman Environment](environment_configuration.json) file so the collection can be imported with all your OPF Tenant and PayU Europe Test Account unique values. 
+
+f) Update Configuration for ``Immediate Capture``
+
+g) 
+
+### Creating a PayU Europe Account 
+You can sign up for a free PayU Europe test account by following this document [Registering with PayU](https://developers.payu.com/europe/docs/get-started/set-up-account/register/).
+
+Once registered, you can log in to your Sandbox [Merchant Panel ](https://merch-prod.snd.payu.com/user/login).
+
+For more information about the Merchant Panel and its features, see this [documentation](https://developers.payu.com/europe/docs/get-started/set-up-account/management-panel/)
+
+### Creating a PayU Europe Payment Integration 
+Create a PayU Europe  payment integration in the OPF workbench. For reference, see [Creating Payment Integration
+](https://help.sap.com/docs/OPEN_PAYMENT_FRAMEWORK/3580ff1b17144b8780c055bbb7c2bed3/20a64f954df1425391757759011e7e6b.html).
+
+For step 6:
+a) The suggestion value of Merchant ID is the PSP ID, You can found it in your [Merchant Panel](https://merch-prod.snd.payu.com/user/login).
+
+![](./images/payU_merchant_Id.png)
+
+b) For the capture method, if you don't want Immediate Capture in OPF, you must disable auto-receive on your POS in the PayU Europe Merchant Panel:
+
+Go to ``Online payments`` > ``My shops`` >`` POS`` tab, and click on the POS name corresponding to the item you want to use.
+
+![](./images/payU_captureMethod_1.png)
+
+At the bottom of the ``Available payment methods`` section, you will find the ``Automatic collection``toggle. Click the ``Disable`` button to disable automatic collection for all payment methods simultaneously.
+
+![](./images/payU_capturemethod_2.png)
+
+### Get the credentials for your PayU Europe  integration 
+Authentication involves generating an OAuth token, which is used for further communication with PayU servers. To create a standard OAuth token, you will need the `client_id` and `client_secret` keys, which can be found in your merchant panel.
+
+To retrieve your credentials:
+Go to **Online payments** > **My shops** > **POS** tab, click on your POS name, and you will find the ``client_id`` and ``client_secret`` keys.
+
+![](./images/payU_credentials.png)
+
+
+### Preparing the Postman environment_configuration file 
+
+**1. Token**
+
+Get your access token by [creating an external app](https://help.sap.com/docs/OPEN_PAYMENT_FRAMEWORK/8ccca5bb539a49258e924b467ee4e1c2/d927d21974fe4b368e063f72733bf0fe.html) and [making authorized API calls](https://help.sap.com/docs/OPEN_PAYMENT_FRAMEWORK/8ccca5bb539a49258e924b467ee4e1c2/40c792e66e2942209dc853a43533d78d.html).
+
+Copy the value of the access_token field (it’s a JWT) and set as the ``token`` value in the environment file.
+
+**IMPORTANT**: Ensure the value is prefixed with **Bearer**. e.g. ``Bearer {{token}}``.
+
+**2. Root url**
+
+The ``rootUrl`` is the **BASE URL** of your OPF tenant.
+
+E.g. if your workbench/OPF cockpit url was this …
+
+<https://opf-iss-d0.uis.commerce.stage.context.cloud.sap/opf-workbench>.
+
+The base Url would be
+
+https://opf-iss-d0.uis.commerce.stage.context.cloud.sap.
+
+
+**3. Integration ID and Configuration ID**
+
+The ``integrationId`` and ``configurationId`` values identify the payment integration and payment configuration, which can be found in the top left of your **Configuration Details** page in the OPF workbench.
+
+* ``integrationId`` maps to ``accountGroupId`` in Postman
+* ``configurationId`` maps to ``accountId`` in Postman
+
+**4. authentication_outbound_oauth2_client_secret_export_1053 and  authentication_outbound_oauth2_client_secret_export_1053**
+
+Obtain your ``apiKey`` and ``apiSecret`` during the [Get the credentials for your PayU Europe  integration](#get-the-credentials-for-your-payu-europe--integration-) step.
+
+**5. capturePattern**
+values can be : ``AUTO_CAPTURE``, ``CAPTURE_PER_SHIPMENT``, ``PARTIAL_CAPTURE``
+
+**6. posId**
+Retrieve your POS ID from your  [Merchant Panel](https://merch-prod.snd.payu.com/user/login).
+![](images/payu_posId.png)
+
+**7. refundType**
+
+The following refund types are available:
+
+``REFUND_PAYMENT_STANDARD`` – Standard refund procedure
+``FAST`` – Expedited refund process with potentially higher fees. Available only to merchants operating through PayU GPO Romania
+
+
+
+### Allowlist
+Add the following domains to the domain allowlist in OPF workbench. For instructions, see [Adding Tenant-specific Domain to Allowlist
+](https://help.sap.com/docs/OPEN_PAYMENT_FRAMEWORK/3580ff1b17144b8780c055bbb7c2bed3/a6836485b4494cfaad4033b4ee7a9c64.html).
+
+``secure.payu.com`` for Production
+``secure.snd.payu.com`` for Sandbox test
+
+
+### Update Configuration for Immediate Capture
+If you are using the ``Immediate Capture`` configuration, you must update your Notification configuration after importing the Postman collection into your workbench.
+
+**Steps:**
+1. Navigate to the **Notification** tab
+2. Update both **Request Type** and **Transaction Status** values from ``WAITING_FOR_CONFIRMATION`` to ``COMPLETED``
+![](images/payu_immediateCapture.png)
+
+### Summary
+
+The environment file is now ready for importing into Postman together with the Mapping Configuration Collection file. Ensure you select the correct environment before running the collection.
+
+In summary, you should have edited the following variables: 
+
+#### Common
+- ``token``
+- ``rootUrl``
+- ``accountGroupId``
+- ``accountId`` 
+
+#### PayU Europe Specific
+- ``authentication_outbound_oauth2_client_id_export_1053``
+- ``authentication_outbound_oauth2_client_secret_export_1053``
+- ``posId`` 
+

postman/payu-europe/PAYMENT_PAGE/environment_configuration.json

@@ -0,0 +1,106 @@
+{
+  "id": "497c0fd2-9d80-49e3-800f-ac302f147f0f",
+  "name": "PayU Europe",
+  "values": [
+    {
+      "key": "token",
+      "value": "",
+      "enabled": true
+    },
+    {
+      "key": "rootUrl",
+      "value": "https:\/\/opf-iss-d0.opf.commerce.stage.context.cloud.sap",
+      "enabled": true
+    },
+    {
+      "key": "service",
+      "value": "opf",
+      "enabled": true
+    },
+    {
+      "key": "accountGroupId",
+      "value": "5356",
+      "enabled": true
+    },
+    {
+      "key": "accountId",
+      "value": "4287",
+      "enabled": true
+    },
+    {
+      "key": "authentication_outbound_oauth2_token_url_export_1053",
+      "value": "https:\/\/secure.snd.payu.com\/pl\/standard\/user\/oauth\/authorize",
+      "enabled": true
+    }
+    ,
+    {
+      "key": "authentication_outbound_oauth2_client_id_export_1053",
+      "value": "PayU Romania_clientId",
+      "enabled": true
+    }
+    ,
+    {
+      "key": "authentication_outbound_oauth2_client_secret_export_1053",
+      "value": "PayU Romania_clientSecret",
+      "enabled": true
+    }
+    ,
+    {
+      "key": "authentication_outbound_oauth2_use_basic_auth_export_1053",
+      "value": "false",
+      "enabled": true
+    }
+    ,
+    {
+      "key": "capturePattern",
+      "value": "PARTIAL_CAPTURE",
+      "enabled": true
+    }
+    ,
+    {
+      "key": "enableOverCapture",
+      "value": "false",
+      "enabled": true
+    }
+    ,
+    {
+      "key": "enableCaptureReAuth",
+      "value": "false",
+      "enabled": true
+    }
+    ,
+    {
+      "key": "authorizationTimeoutDays",
+      "value": "7",
+      "enabled": true
+    }
+    ,
+    {
+      "key": "apiDomain",
+      "value": "secure.snd.payu.com",
+      "enabled": true
+    }
+    ,
+    {
+      "key": "posId",
+      "value": "511868",
+      "enabled": true
+    }
+    ,
+    {
+      "key": "apiVersion",
+      "value": "v2_1",
+      "enabled": true
+    }
+    ,
+    {
+      "key": "refundType",
+      "value": "REFUND_PAYMENT_STANDARD",
+      "enabled": true
+    }
+
+  ],
+  "_postman_variable_scope": "environment",
+  "_postman_exported_at": "",
+  "_postman_exported_using": "Postman\/7.35.0"
+}