Merge branch 'main' into add-sdk-logs-screen

Author: jhadobe

src/pages/starter-kit/checkout/getting-started.md

@@ -29,6 +29,8 @@ You must install or have access to the following prerequisites to develop with t
 
 ## Install Commerce modules
 
+Before installing Commerce modules, ensure that you have the required credentials in `auth.json` with [access to the Adobe Commerce repository](https://experienceleague.adobe.com/en/docs/commerce-operations/installation-guide/prerequisites/authentication-keys).
+
 - Install the Out-of-Process Payment Extensions (OOPE) module on Adobe Commerce
 
     To enable out-of-process payment methods in Commerce, install the `magento/module-out-of-process-payment-methods`. This module enables out-of-process payment functionalities.

src/pages/starter-kit/checkout/use-cases.md

@@ -138,10 +138,83 @@ You can also enable webhook signature generation by following the [webhooks sign
 
 Refer to [`actions/validate-payment.js`](https://github.com/adobe/commerce-checkout-starter-kit/blob/main/actions/validate-payment/index.js) for an example of how to receive the request and validate the payment according to the payment gateway needs.
 
+## Payment methods: Filter out payment method
+
+In some cases, you may want to filter out a payment method based on the cart details or the customer's information. For example, you may want to disable a payment method based on customer group or product attributes in the cart.
+
+You can use the `plugin.magento.out_of_process_payment_methods.api.payment_method_filter.get_list` webhook to filter out a payment method. This webhook is triggered every time the list of available payment methods is requested, allowing you to filter out the payment methods based on the cart details or customer information.
+
+The following example demonstrates how to add a webhook to the `plugin.magento.out_of_process_payment_methods.api.payment_method_filter.get_list` method:
+
+```xml
+<method name="plugin.magento.out_of_process_payment_methods.api.payment_method_filter.get_list" type="after">
+    <hooks>
+        <batch name="check_product_stock">
+            <hook name="check_product_stock" url="https://<yourappbuilder>.runtime.adobe.io/api/v1/web/commerce-checkout-starter-kit/filter-payment" method="POST" timeout="20000" softTimeout="0">
+                <fields>
+                    <field name="payload" />
+                </fields>
+            </hook>
+        </batch>
+    </hooks>
+</method>
+```
+
+Payload example:
+
+```json
+{
+    "payload": {
+        "cart": {
+            "entity_id": "1",
+            "store_id": 1,
+            "converted_at": null,
+            "is_active": "1",
+            ...
+            "items": [
+                {
+                    "item_id": "4",
+                    "quote_id": "1",
+                    "product_id": "10",
+                    "store_id": 1,
+                    "weight": "124.000000",
+                    "qty": 2,
+                    "price": "600.0000",
+                    "base_price": "600.0000",
+                    ...
+                    "product": {
+                        "entity_id": "10",
+                        ...
+                        "attributes": {
+                            "manufacturer": "Two",
+                            "color": "Yellow",
+                            "country_origin": "France",
+                            ...
+                        }
+                    },
+                },
+                ...
+            ],
+        },
+        "customer": {
+            "entity_id": "1",
+            "website_id": "1",
+            "email": "test@example.com",
+            "group_id": "1",
+            ...
+        }
+    }
+}
+```
+
+You can find examples of how to filter out payment methods using customer data or product attributes in your App Builder application in [`actions/filter-payment.js`](https://github.com/adobe/commerce-checkout-starter-kit/blob/main/actions/filter-payment/index.js).
+
 ## Shipping methods
 
 You can add shipping methods to the checkout process by using [webhooks](../../webhooks/index.md).
 
+To add shipping methods, you must [run a script to automatically create shipping carriers](./configure.md#create-shipping-carriers) or [create shipping carriers manually](./shipping-reference.md#shipping-api-reference) using the REST API. Only shipping methods with registered carriers are available in the checkout process.
+
 After the webhook is registered, every time a shopping cart is requested, a synchronous call is dispatched to the App Builder application implementing the shipping method to calculate the shipping cost and provide the available shipping methods.
 
 Refer to [`actions/shipping-methods.js`](https://github.com/adobe/commerce-checkout-starter-kit/blob/main/actions/shipping-methods/index.js) for an example of how to process the request and return the list of available shipping methods.