Release 2024-11-20

square · Nov 20, 2024 · e8c7b53 · e8c7b53
1 parent bb7bddd
commit e8c7b53
Show file tree

Hide file tree

Showing 387 changed files with 1,511 additions and 893 deletions.
diff --git a/composer.json b/composer.json
@@ -1,7 +1,7 @@
 {
     "name": "square/square",
     "description": "Use Square APIs to manage and run business including payment, customer, product, inventory, and employee management.",
-    "version": "38.2.0.20241017",
+    "version": "39.0.0.20241120",
     "type": "library",
     "keywords": [
         "Square",

diff --git a/doc/apis/location-custom-attributes.md b/doc/apis/location-custom-attributes.md
@@ -278,15 +278,9 @@ This method returns a `Square\Utils\ApiResponse` instance. The `getResult()` met
 ```php
 $body = BulkDeleteLocationCustomAttributesRequestBuilder::init(
     [
-        'id1' => BulkDeleteLocationCustomAttributesRequestLocationCustomAttributeDeleteRequestBuilder::init()
-            ->key('bestseller')
-            ->build(),
-        'id2' => BulkDeleteLocationCustomAttributesRequestLocationCustomAttributeDeleteRequestBuilder::init()
-            ->key('bestseller')
-            ->build(),
-        'id3' => BulkDeleteLocationCustomAttributesRequestLocationCustomAttributeDeleteRequestBuilder::init()
-            ->key('phone-number')
-            ->build()
+        'id1' => BulkDeleteLocationCustomAttributesRequestLocationCustomAttributeDeleteRequestBuilder::init()->build(),
+        'id2' => BulkDeleteLocationCustomAttributesRequestLocationCustomAttributeDeleteRequestBuilder::init()->build(),
+        'id3' => BulkDeleteLocationCustomAttributesRequestLocationCustomAttributeDeleteRequestBuilder::init()->build()
     ]
 )->build();
 

diff --git a/doc/apis/merchant-custom-attributes.md b/doc/apis/merchant-custom-attributes.md
@@ -278,12 +278,8 @@ This method returns a `Square\Utils\ApiResponse` instance. The `getResult()` met
 ```php
 $body = BulkDeleteMerchantCustomAttributesRequestBuilder::init(
     [
-        'id1' => BulkDeleteMerchantCustomAttributesRequestMerchantCustomAttributeDeleteRequestBuilder::init()
-            ->key('alternative_seller_name')
-            ->build(),
-        'id2' => BulkDeleteMerchantCustomAttributesRequestMerchantCustomAttributeDeleteRequestBuilder::init()
-            ->key('has_seen_tutorial')
-            ->build()
+        'id1' => BulkDeleteMerchantCustomAttributesRequestMerchantCustomAttributeDeleteRequestBuilder::init()->build(),
+        'id2' => BulkDeleteMerchantCustomAttributesRequestMerchantCustomAttributeDeleteRequestBuilder::init()->build()
     ]
 )->build();
 

diff --git a/doc/apis/order-custom-attributes.md b/doc/apis/order-custom-attributes.md
@@ -294,14 +294,10 @@ $body = BulkDeleteOrderCustomAttributesRequestBuilder::init(
     [
         'cover-count' => BulkDeleteOrderCustomAttributesRequestDeleteCustomAttributeBuilder::init(
             '7BbXGEIWNldxAzrtGf9GPVZTwZ4F'
-        )
-            ->key('cover-count')
-            ->build(),
+        )->build(),
         'table-number' => BulkDeleteOrderCustomAttributesRequestDeleteCustomAttributeBuilder::init(
             '7BbXGEIWNldxAzrtGf9GPVZTwZ4F'
-        )
-            ->key('table-number')
-            ->build()
+        )->build()
     ]
 )->build();
 

diff --git a/doc/apis/team.md b/doc/apis/team.md
@@ -200,7 +200,6 @@ $body = BulkUpdateTeamMembersRequestBuilder::init(
             ->teamMember(
                 TeamMemberBuilder::init()
                     ->referenceId('reference_id_2')
-                    ->isOwner(false)
                     ->status(TeamMemberStatus::ACTIVE)
                     ->givenName('Jane')
                     ->familyName('Smith')
@@ -218,7 +217,6 @@ $body = BulkUpdateTeamMembersRequestBuilder::init(
             ->teamMember(
                 TeamMemberBuilder::init()
                     ->referenceId('reference_id_1')
-                    ->isOwner(false)
                     ->status(TeamMemberStatus::ACTIVE)
                     ->givenName('Joe')
                     ->familyName('Doe')

diff --git a/doc/client.md b/doc/client.md
@@ -5,7 +5,7 @@ The following parameters are configurable for the API Client:
 
 | Parameter | Type | Description |
 |  --- | --- | --- |
-| `squareVersion` | `string` | Square Connect API versions<br>*Default*: `'2024-10-17'` |
+| `squareVersion` | `string` | Square Connect API versions<br>*Default*: `'2024-11-20'` |
 | `customUrl` | `string` | Sets the base URL requests are made to. Defaults to `https://connect.squareup.com`<br>*Default*: `'https://connect.squareup.com'` |
 | `environment` | `string` | The API environment. <br> **Default: `production`** |
 | `timeout` | `int` | Timeout for API calls in seconds.<br>*Default*: `60` |
@@ -30,7 +30,7 @@ $client = SquareClientBuilder::init()
             'AccessToken'
         )
     )
-    ->squareVersion('2024-10-17')
+    ->squareVersion('2024-11-20')
     ->environment(Environment::PRODUCTION)
     ->customUrl('https://connect.squareup.com')
     ->build();
@@ -61,7 +61,7 @@ $client = SquareClientBuilder::init()
             'AccessToken'
         )
     )
-    ->squareVersion('2024-10-17')
+    ->squareVersion('2024-11-20')
     ->environment(Environment::PRODUCTION)
     ->customUrl('https://connect.squareup.com')
     ->build();

diff --git a/doc/models/accept-dispute-response.md b/doc/models/accept-dispute-response.md
@@ -42,19 +42,19 @@ Defines the fields in an `AcceptDispute` response.
   "errors": [
     {
       "category": "MERCHANT_SUBSCRIPTION_ERROR",
-      "code": "MAP_KEY_LENGTH_TOO_LONG",
+      "code": "INVALID_EXPIRATION",
       "detail": "detail6",
       "field": "field4"
     },
     {
       "category": "MERCHANT_SUBSCRIPTION_ERROR",
-      "code": "MAP_KEY_LENGTH_TOO_LONG",
+      "code": "INVALID_EXPIRATION",
       "detail": "detail6",
       "field": "field4"
     },
     {
       "category": "MERCHANT_SUBSCRIPTION_ERROR",
-      "code": "MAP_KEY_LENGTH_TOO_LONG",
+      "code": "INVALID_EXPIRATION",
       "detail": "detail6",
       "field": "field4"
     }

diff --git a/doc/models/accumulate-loyalty-points-response.md b/doc/models/accumulate-loyalty-points-response.md
@@ -57,7 +57,7 @@ Represents an [AccumulateLoyaltyPoints](../../doc/apis/loyalty.md#accumulate-loy
   "errors": [
     {
       "category": "MERCHANT_SUBSCRIPTION_ERROR",
-      "code": "MAP_KEY_LENGTH_TOO_LONG",
+      "code": "INVALID_EXPIRATION",
       "detail": "detail6",
       "field": "field4"
     }

diff --git a/doc/models/activity-type.md b/doc/models/activity-type.md
@@ -15,7 +15,8 @@
 | `AUTOMATIC_SAVINGS` | An automatic transfer from the payment processing balance to the Square Savings account. These are generally proportional to the seller's sales. |
 | `AUTOMATIC_SAVINGS_REVERSED` | An automatic transfer from the Square Savings account back to the processing balance. These are generally proportional to the seller's refunds. |
 | `CHARGE` | A credit card payment capture. |
-| `DEPOSIT_FEE` | Any fees involved with deposits such as instant deposits. |
+| `DEPOSIT_FEE` | A fee assessed because of a deposit, such as an instant deposit. |
+| `DEPOSIT_FEE_REVERSED` | Indicates that Square returned a fee that was previously assessed because of a deposit, such as an instant deposit, back to the seller's account. |
 | `DISPUTE` | The balance change due to a dispute event. |
 | `ESCHEATMENT` | An escheatment entry for remittance. |
 | `FEE` | The cost plus adjustment fee. |
@@ -43,7 +44,7 @@
 | `TAX_ON_FEE` | The tax paid on fee amounts. |
 | `THIRD_PARTY_FEE` | Fees collected by a third-party platform. |
 | `THIRD_PARTY_FEE_REFUND` | Refunded fees from a third-party platform. |
-| `PAYOUT` | The balance change due to money transfer. |
+| `PAYOUT` | The balance change due to a money transfer. Note that this type is never returned by the Payouts API. |
 | `AUTOMATIC_BITCOIN_CONVERSIONS` | Indicates that the portion of each payment withheld by Square was automatically converted into bitcoin using Cash App. The seller manages their bitcoin in their Cash App account. |
 | `AUTOMATIC_BITCOIN_CONVERSIONS_REVERSED` | Indicates that a withheld payment, which was scheduled to be converted into bitcoin using Cash App, was deposited back to the Square payments balance. |
 | `CREDIT_CARD_REPAYMENT` | Indicates that a repayment toward the outstanding balance on the seller's Square credit card was made. |
@@ -64,4 +65,6 @@
 | `BALANCE_FOLDERS_TRANSFER_REVERSED` | A reversal of transfer of funds from a banking folder. In the United States, the folder name is 'Checking Folder'; in Canada, it's 'Balance Folder.' |
 | `GIFT_CARD_POOL_TRANSFER` | A transfer of gift card funds to a central gift card pool account. In franchises, when gift cards are loaded or reloaded at any location, the money transfers to the franchisor's account. |
 | `GIFT_CARD_POOL_TRANSFER_REVERSED` | A reversal of transfer of gift card funds from a central gift card pool account. In franchises, when gift cards are loaded or reloaded at any location, the money transfers to the franchisor's account. |
+| `SQUARE_PAYROLL_TRANSFER` | A payroll payment that was transferred to a team member’s bank account. |
+| `SQUARE_PAYROLL_TRANSFER_REVERSED` | A payroll payment to a team member’s bank account that was deposited back to the seller’s account by Square. |
 
diff --git a/doc/models/add-group-to-customer-response.md b/doc/models/add-group-to-customer-response.md
@@ -21,7 +21,7 @@ a request to the [AddGroupToCustomer](../../doc/apis/customers.md#add-group-to-c
   "errors": [
     {
       "category": "MERCHANT_SUBSCRIPTION_ERROR",
-      "code": "MAP_KEY_LENGTH_TOO_LONG",
+      "code": "INVALID_EXPIRATION",
       "detail": "detail6",
       "field": "field4"
     }

diff --git a/doc/models/additional-recipient.md b/doc/models/additional-recipient.md
@@ -24,7 +24,7 @@ Represents an additional recipient (other than the merchant) receiving a portion
   "description": "description2",
   "amount_money": {
     "amount": 186,
-    "currency": "TZS"
+    "currency": "AUD"
   },
   "receivable_id": "receivable_id8"
 }

diff --git a/doc/models/adjust-loyalty-points-response.md b/doc/models/adjust-loyalty-points-response.md
@@ -53,7 +53,7 @@ Represents an [AdjustLoyaltyPoints](../../doc/apis/loyalty.md#adjust-loyalty-poi
   "errors": [
     {
       "category": "MERCHANT_SUBSCRIPTION_ERROR",
-      "code": "MAP_KEY_LENGTH_TOO_LONG",
+      "code": "INVALID_EXPIRATION",
       "detail": "detail6",
       "field": "field4"
     }

diff --git a/doc/models/bank-account.md b/doc/models/bank-account.md
@@ -38,7 +38,7 @@ linking a bank account to a Square account, see
   "id": "id2",
   "account_number_suffix": "account_number_suffix6",
   "country": "TT",
-  "currency": "SLL",
+  "currency": "MVR",
   "account_type": "OTHER",
   "holder_name": "holder_name8",
   "primary_bank_identification_number": "primary_bank_identification_number0",

diff --git a/doc/models/batch-delete-catalog-objects-response.md b/doc/models/batch-delete-catalog-objects-response.md
@@ -25,7 +25,7 @@
   "errors": [
     {
       "category": "MERCHANT_SUBSCRIPTION_ERROR",
-      "code": "MAP_KEY_LENGTH_TOO_LONG",
+      "code": "INVALID_EXPIRATION",
       "detail": "detail6",
       "field": "field4"
     }

diff --git a/doc/models/batch-retrieve-catalog-objects-response.md b/doc/models/batch-retrieve-catalog-objects-response.md
@@ -254,19 +254,19 @@
   "errors": [
     {
       "category": "MERCHANT_SUBSCRIPTION_ERROR",
-      "code": "MAP_KEY_LENGTH_TOO_LONG",
+      "code": "INVALID_EXPIRATION",
       "detail": "detail6",
       "field": "field4"
     },
     {
       "category": "MERCHANT_SUBSCRIPTION_ERROR",
-      "code": "MAP_KEY_LENGTH_TOO_LONG",
+      "code": "INVALID_EXPIRATION",
       "detail": "detail6",
       "field": "field4"
     },
     {
       "category": "MERCHANT_SUBSCRIPTION_ERROR",
-      "code": "MAP_KEY_LENGTH_TOO_LONG",
+      "code": "INVALID_EXPIRATION",
       "detail": "detail6",
       "field": "field4"
     }

diff --git a/doc/models/batch-retrieve-orders-response.md b/doc/models/batch-retrieve-orders-response.md
@@ -99,19 +99,19 @@ a request to the `BatchRetrieveOrders` endpoint.
   "errors": [
     {
       "category": "MERCHANT_SUBSCRIPTION_ERROR",
-      "code": "MAP_KEY_LENGTH_TOO_LONG",
+      "code": "INVALID_EXPIRATION",
       "detail": "detail6",
       "field": "field4"
     },
     {
       "category": "MERCHANT_SUBSCRIPTION_ERROR",
-      "code": "MAP_KEY_LENGTH_TOO_LONG",
+      "code": "INVALID_EXPIRATION",
       "detail": "detail6",
       "field": "field4"
     },
     {
       "category": "MERCHANT_SUBSCRIPTION_ERROR",
-      "code": "MAP_KEY_LENGTH_TOO_LONG",
+      "code": "INVALID_EXPIRATION",
       "detail": "detail6",
       "field": "field4"
     }

diff --git a/doc/models/batch-upsert-catalog-objects-response.md b/doc/models/batch-upsert-catalog-objects-response.md
@@ -329,7 +329,7 @@
   "errors": [
     {
       "category": "MERCHANT_SUBSCRIPTION_ERROR",
-      "code": "MAP_KEY_LENGTH_TOO_LONG",
+      "code": "INVALID_EXPIRATION",
       "detail": "detail6",
       "field": "field4"
     }

diff --git a/doc/models/booking-custom-attribute-upsert-response.md b/doc/models/booking-custom-attribute-upsert-response.md
@@ -42,19 +42,19 @@ Represents a response for an individual upsert request in a [BulkUpsertBookingCu
   "errors": [
     {
       "category": "MERCHANT_SUBSCRIPTION_ERROR",
-      "code": "MAP_KEY_LENGTH_TOO_LONG",
+      "code": "INVALID_EXPIRATION",
       "detail": "detail6",
       "field": "field4"
     },
     {
       "category": "MERCHANT_SUBSCRIPTION_ERROR",
-      "code": "MAP_KEY_LENGTH_TOO_LONG",
+      "code": "INVALID_EXPIRATION",
       "detail": "detail6",
       "field": "field4"
     },
     {
       "category": "MERCHANT_SUBSCRIPTION_ERROR",
-      "code": "MAP_KEY_LENGTH_TOO_LONG",
+      "code": "INVALID_EXPIRATION",
       "detail": "detail6",
       "field": "field4"
     }

diff --git a/doc/models/bulk-create-customers-response.md b/doc/models/bulk-create-customers-response.md
@@ -57,19 +57,19 @@ Defines the fields included in the response body from the
       "errors": [
         {
           "category": "MERCHANT_SUBSCRIPTION_ERROR",
-          "code": "MAP_KEY_LENGTH_TOO_LONG",
+          "code": "INVALID_EXPIRATION",
           "detail": "detail6",
           "field": "field4"
         },
         {
           "category": "MERCHANT_SUBSCRIPTION_ERROR",
-          "code": "MAP_KEY_LENGTH_TOO_LONG",
+          "code": "INVALID_EXPIRATION",
           "detail": "detail6",
           "field": "field4"
         },
         {
           "category": "MERCHANT_SUBSCRIPTION_ERROR",
-          "code": "MAP_KEY_LENGTH_TOO_LONG",
+          "code": "INVALID_EXPIRATION",
           "detail": "detail6",
           "field": "field4"
         }
@@ -112,19 +112,19 @@ Defines the fields included in the response body from the
       "errors": [
         {
           "category": "MERCHANT_SUBSCRIPTION_ERROR",
-          "code": "MAP_KEY_LENGTH_TOO_LONG",
+          "code": "INVALID_EXPIRATION",
           "detail": "detail6",
           "field": "field4"
         },
         {
           "category": "MERCHANT_SUBSCRIPTION_ERROR",
-          "code": "MAP_KEY_LENGTH_TOO_LONG",
+          "code": "INVALID_EXPIRATION",
           "detail": "detail6",
           "field": "field4"
         },
         {
           "category": "MERCHANT_SUBSCRIPTION_ERROR",
-          "code": "MAP_KEY_LENGTH_TOO_LONG",
+          "code": "INVALID_EXPIRATION",
           "detail": "detail6",
           "field": "field4"
         }
@@ -134,13 +134,13 @@ Defines the fields included in the response body from the
   "errors": [
     {
       "category": "MERCHANT_SUBSCRIPTION_ERROR",
-      "code": "MAP_KEY_LENGTH_TOO_LONG",
+      "code": "INVALID_EXPIRATION",
       "detail": "detail6",
       "field": "field4"
     },
     {
       "category": "MERCHANT_SUBSCRIPTION_ERROR",
-      "code": "MAP_KEY_LENGTH_TOO_LONG",
+      "code": "INVALID_EXPIRATION",
       "detail": "detail6",
       "field": "field4"
     }

diff --git a/doc/models/bulk-create-team-members-response.md b/doc/models/bulk-create-team-members-response.md
@@ -40,13 +40,13 @@ Represents a response from a bulk create request containing the created `TeamMem
       "errors": [
         {
           "category": "MERCHANT_SUBSCRIPTION_ERROR",
-          "code": "MAP_KEY_LENGTH_TOO_LONG",
+          "code": "INVALID_EXPIRATION",
           "detail": "detail6",
           "field": "field4"
         },
         {
           "category": "MERCHANT_SUBSCRIPTION_ERROR",
-          "code": "MAP_KEY_LENGTH_TOO_LONG",
+          "code": "INVALID_EXPIRATION",
           "detail": "detail6",
           "field": "field4"
         }
@@ -69,13 +69,13 @@ Represents a response from a bulk create request containing the created `TeamMem
       "errors": [
         {
           "category": "MERCHANT_SUBSCRIPTION_ERROR",
-          "code": "MAP_KEY_LENGTH_TOO_LONG",
+          "code": "INVALID_EXPIRATION",
           "detail": "detail6",
           "field": "field4"
         },
         {
           "category": "MERCHANT_SUBSCRIPTION_ERROR",
-          "code": "MAP_KEY_LENGTH_TOO_LONG",
+          "code": "INVALID_EXPIRATION",
           "detail": "detail6",
           "field": "field4"
         }
@@ -85,7 +85,7 @@ Represents a response from a bulk create request containing the created `TeamMem
   "errors": [
     {
       "category": "MERCHANT_SUBSCRIPTION_ERROR",
-      "code": "MAP_KEY_LENGTH_TOO_LONG",
+      "code": "INVALID_EXPIRATION",
       "detail": "detail6",
       "field": "field4"
     }