v1

latestOpenAPI 3.0.0Apache 2.02026-07-143281,4552.1 MB
Checkout

UpdateLocationSettings

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

put/v2/online-checkout/location-settings/{location_id}

Path parameters

location_idstring required

The ID of the location for which to retrieve settings.

Request body

Response

Success

Example response

{
  "location_settings": {
    "branding": {
      "button_color": "#00b23b",
      "button_shape": "ROUNDED",
      "header_type": "FRAMED_LOGO"
    },
    "customer_notes_enabled": false,
    "location_id": "LOCATION_ID_1",
    "policies": [
      {
        "description": "This is my Return Policy",
        "title": "Return Policy",
        "uid": "POLICY_ID_1"
      },
      {
        "description": "Items may be returned within 30 days of purchase.",
        "title": "Return Policy",
        "uid": "POLICY_ID_2"
      }
    ],
    "tipping": {
      "default_percent": 20,
      "default_whole_amount_money": {
        "amount": 100,
        "currency": "USD"
      },
      "percentages": [
        15,
        20,
        25
      ],
      "smart_tipping_enabled": true,
      "whole_amounts": [
        {
          "amount": 1000,
          "currency": "USD"
        },
        {
          "amount": 1500,
          "currency": "USD"
        },
        {
          "amount": 2000,
          "currency": "USD"
        }
      ]
    },
    "updated_at": "2022-06-16T22:25:35Z"
  }
}