> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Method name: getPaymentSettings(options: Options, context: Context)

# Method package: wixEcom

# Method menu location: wixEcom --> EcomPaymentSettings --> getPaymentSettings

# Method Link: https://dev.wix.com/docs/velo/events-service-plugins/e-commerce/service-plugins/ecom-payment-settings/get-payment-settings.md

# Method Description:

Retrieves the payment settings to apply to an order based on your custom logic. Wix passes these settings to the payment provider.

Add the custom logic to apply to an order in the `return` of the `getPaymentSettings()` function. Wix calls this function when an order is placed from the checkout page of your site.

Currently, the only payment setting available to customize is whether to apply [3 domain security](https://support.wix.com/en/article/about-3d-secure-3ds-payments-with-third-party-payment-providers) (3DS) 
to an order. Note that if the code fails then `requires3dSecure` sets to the value for `fallbackValueForRequires3dSecure` set in 
[`getConfig()`](https://www.wix.com/velo/reference/spis/wix-ecom/ecom-payment-settings/getconfig).

### Where to find `getPaymentSettings()`
When you [add the Payment Settings service plugin](https://dev.wix.com/docs/develop-websites/articles/wix-apps/wix-e-commerce-stores/tutorial-payment-settings-custom-extension.md#step-1-create-a-new-payment-settings-extension), 
a folder is automatically added to your site. Use the `.js` file in the folder to write the code to determine which payment settings to apply to an order. 

For more information on customizing your payment settings, see [Tutorial: Payment Settings Service Plugin](https://dev.wix.com/docs/develop-websites/articles/wix-apps/wix-e-commerce-stores/tutorial-payment-settings-custom-extension.md#require-3ds-50js).



# Method Code Examples:

*** Note: do not assume any prop names or enum values other than the ones in the example.

## Example of a `paymentSettings` return value

```javascript
export const getPaymentSettings = (options) => {

  return {
    "paymentSettings": {
      "requires3dSecure": true
    }
  };
};
```

## Require 3DS if the order is greater than $50

```javascript
export const getPaymentSettings = async (options) => {
  return {
    paymentSettings: {
      // Extract the subtotal price from the order, convert it to a number 
      // and check if the price is equal or greater than $50.
      requires3dSecure: parseFloat(options.order.priceSummary.subtotal.amount) >= 50
    }
  };
};

/* If the subtotal price is less than 50, the following payment settings are returned:
 *
 * {
 *   "paymentSettings": {
 *     "requires3dSecure": "false"
 *   }
 * }
 */
```

---