Update merchant settingsBeta

PUT

/v2/online-checkout/merchant-settings

Updates the merchant-level settings for a Square-hosted checkout page.

Permissions:PAYMENT_METHODS_READ, MERCHANT_PROFILE_READ, MERCHANT_PROFILE_WRITE

Guide

Checkout Settings

Try in API Explorer

Link to section

Request body

Example code

Link to section

merchant_settings

Required

Describe your updates using the merchant_settings object. Make sure it contains only the fields that have changed.

Link to section

Response fields

Link to section

errors

Any errors that occurred when updating the merchant settings.

Link to section

merchant_settings

The updated merchant settings.

Link to section

Examples

All versions ->

PUT /v2/online-checkout/merchant-settings

curl https://connect.squareup.com/v2/online-checkout/merchant-settings \
  -X PUT \
  -H 'Square-Version: 2024-12-18' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{}'

Response JSON

{
  "merchant_settings": {
    "merchant_id": "MERCHANT_ID",
    "updated_at": "2022-06-16T22:25:35Z",
    "payment_methods": {
      "apple_pay": {
        "enabled": false
      },
      "google_pay": {
        "enabled": true
      },
      "cash_app_pay": {
        "enabled": true
      },
      "afterpay_clearpay": {
        "enabled": true,
        "order_eligibility_range": {
          "min": {
            "amount": 100,
            "currency": "USD"
          },
          "max": {
            "amount": 10000,
            "currency": "USD"
          }
        },
        "item_eligibility_range": {
          "min": {
            "amount": 100,
            "currency": "USD"
          },
          "max": {
            "amount": 10000,
            "currency": "USD"
          }
        }
      }
    }
  }
}