Merge pull request #134 from square/release/39.0.0.20240821

Generated PR for Release: 39.0.0.20240821

Author: Esawyer25

doc/api/booking-custom-attributes.md

@@ -258,11 +258,11 @@ This method returns a `\ApiResponse` instance. The `data` property in this insta
 ```ruby
 body = {
   :values => {
-    'key0': {
+    'key0' => {
       :booking_id => 'booking_id4',
       :key => 'key0'
     },
-    'key1': {
+    'key1' => {
       :booking_id => 'booking_id4',
       :key => 'key0'
     }
@@ -309,11 +309,11 @@ This method returns a `\ApiResponse` instance. The `data` property in this insta
 ```ruby
 body = {
   :values => {
-    'key0': {
+    'key0' => {
       :booking_id => 'booking_id4',
       :custom_attribute => {}
     },
-    'key1': {
+    'key1' => {
       :booking_id => 'booking_id4',
       :custom_attribute => {}
     }

doc/api/catalog.md

@@ -39,7 +39,7 @@ children.
 IDs can be deleted. The response will only include IDs that were
 actually deleted.
 
-To ensure consistency, only one delete request is processed at a time per seller account.  
+To ensure consistency, only one delete request is processed at a time per seller account.
 While one (batch or non-batch) delete request is being processed, other (batched and non-batched)
 delete requests are rejected with the `429` error code.
 
@@ -135,7 +135,7 @@ batches will be processed in order as long as the total object count for the
 request (items, variations, modifier lists, discounts, and taxes) is no more
 than 10,000.
 
-To ensure consistency, only one update request is processed at a time per seller account.  
+To ensure consistency, only one update request is processed at a time per seller account.
 While one (batch or non-batch) update request is being processed, other (batched and non-batched)
 update requests are rejected with the `429` error code.
 
@@ -449,7 +449,7 @@ end
 
 Creates a new or updates the specified [CatalogObject](../../doc/models/catalog-object.md).
 
-To ensure consistency, only one update request is processed at a time per seller account.  
+To ensure consistency, only one update request is processed at a time per seller account.
 While one (batch or non-batch) update request is being processed, other (batched and non-batched)
 update requests are rejected with the `429` error code.
 
@@ -527,7 +527,7 @@ are also deleted. For example, deleting a [CatalogItem](../../doc/models/catalog
 will also delete all of its
 [CatalogItemVariation](../../doc/models/catalog-item-variation.md) children.
 
-To ensure consistency, only one delete request is processed at a time per seller account.  
+To ensure consistency, only one delete request is processed at a time per seller account.
 While one (batch or non-batch) delete request is being processed, other (batched and non-batched)
 delete requests are rejected with the `429` error code.
 

doc/api/customer-custom-attributes.md

@@ -278,11 +278,11 @@ This method returns a `\ApiResponse` instance. The `data` property in this insta
 ```ruby
 body = {
   :values => {
-    'key0': {
+    'key0' => {
       :customer_id => 'customer_id8',
       :custom_attribute => {}
     },
-    'key1': {
+    'key1' => {
       :customer_id => 'customer_id8',
       :custom_attribute => {}
     }

doc/api/customers.md

@@ -163,7 +163,7 @@ This method returns a `\ApiResponse` instance. The `data` property in this insta
 ```ruby
 body = {
   :customers => {
-    '8bb76c4f-e35d-4c5b-90de-1194cd9179f0': {
+    '8bb76c4f-e35d-4c5b-90de-1194cd9179f0' => {
       :given_name => 'Amelia',
       :family_name => 'Earhart',
       :email_address => '[email protected]',
@@ -179,7 +179,7 @@ body = {
       :reference_id => 'YOUR_REFERENCE_ID',
       :note => 'a customer'
     },
-    'd1689f23-b25d-4932-b2f0-aed00f5e2029': {
+    'd1689f23-b25d-4932-b2f0-aed00f5e2029' => {
       :given_name => 'Marie',
       :family_name => 'Curie',
       :email_address => '[email protected]',
@@ -320,13 +320,13 @@ This method returns a `\ApiResponse` instance. The `data` property in this insta
 ```ruby
 body = {
   :customers => {
-    '8DDA5NZVBZFGAX0V3HPF81HHE0': {
+    '8DDA5NZVBZFGAX0V3HPF81HHE0' => {
       :email_address => '[email protected]',
       :phone_number => 'phone_number2',
       :note => 'updated customer note',
       :version => 2
     },
-    'N18CPRVXR5214XPBBA6BZQWF3C': {
+    'N18CPRVXR5214XPBBA6BZQWF3C' => {
       :given_name => 'Marie',
       :family_name => 'Curie',
       :version => 0

doc/api/gift-card-activities.md

@@ -65,8 +65,7 @@ end
 # Create Gift Card Activity
 
 Creates a gift card activity to manage the balance or state of a [gift card](../../doc/models/gift-card.md).
-For example, you create an `ACTIVATE` activity to activate a gift card with an initial balance
-before the gift card can be used.
+For example, create an `ACTIVATE` activity to activate a gift card with an initial balance before first use.
 
 ```ruby
 def create_gift_card_activity(body:)

doc/api/gift-cards.md

@@ -61,9 +61,11 @@ end
 
 # Create Gift Card
 
-Creates a digital gift card or registers a physical (plastic) gift card. After the gift card
-is created, you must call [CreateGiftCardActivity](../../doc/api/gift-card-activities.md#create-gift-card-activity)
-to activate the card with an initial balance before it can be used for payment.
+Creates a digital gift card or registers a physical (plastic) gift card. The resulting gift card
+has a `PENDING` state. To activate a gift card so that it can be redeemed for purchases, call
+[CreateGiftCardActivity](../../doc/api/gift-card-activities.md#create-gift-card-activity) and create an `ACTIVATE`
+activity with the initial balance. Alternatively, you can use [RefundPayment](../../doc/api/refunds.md#refund-payment)
+to refund a payment to the new gift card.
 
 ```ruby
 def create_gift_card(body:)

doc/api/location-custom-attributes.md

@@ -257,13 +257,13 @@ This method returns a `\ApiResponse` instance. The `data` property in this insta
 ```ruby
 body = {
   :values => {
-    'id1': {
+    'id1' => {
       :key => 'bestseller'
     },
-    'id2': {
+    'id2' => {
       :key => 'bestseller'
     },
-    'id3': {
+    'id3' => {
       :key => 'phone-number'
     }
   }
@@ -312,11 +312,11 @@ This method returns a `\ApiResponse` instance. The `data` property in this insta
 ```ruby
 body = {
   :values => {
-    'key0': {
+    'key0' => {
       :location_id => 'location_id4',
       :custom_attribute => {}
     },
-    'key1': {
+    'key1' => {
       :location_id => 'location_id4',
       :custom_attribute => {}
     }

doc/api/merchant-custom-attributes.md

@@ -257,10 +257,10 @@ This method returns a `\ApiResponse` instance. The `data` property in this insta
 ```ruby
 body = {
   :values => {
-    'id1': {
+    'id1' => {
       :key => 'alternative_seller_name'
     },
-    'id2': {
+    'id2' => {
       :key => 'has_seen_tutorial'
     }
   }
@@ -309,11 +309,11 @@ This method returns a `\ApiResponse` instance. The `data` property in this insta
 ```ruby
 body = {
   :values => {
-    'key0': {
+    'key0' => {
       :merchant_id => 'merchant_id0',
       :custom_attribute => {}
     },
-    'key1': {
+    'key1' => {
       :merchant_id => 'merchant_id0',
       :custom_attribute => {}
     }

doc/api/o-auth.md

@@ -148,29 +148,18 @@ where `ACCESS_TOKEN` is a
 
 If the access token is expired or not a valid access token, the endpoint returns an `UNAUTHORIZED` error.
 
-:information_source: **Note** This endpoint does not require authentication.
-
 ```ruby
-def retrieve_token_status(authorization:)
+def retrieve_token_status
 ```
 
-## Parameters
-
-| Parameter | Type | Tags | Description |
-|  --- | --- | --- | --- |
-| `authorization` | `String` | Header, Required | Client APPLICATION_SECRET |
-
 ## Response Type
 
 This method returns a `\ApiResponse` instance. The `data` property in this instance returns the response data which is of type [`Retrieve Token Status Response Hash`](../../doc/models/retrieve-token-status-response.md).
 
 ## Example Usage
 
 ```ruby
-authorization = 'Client CLIENT_SECRET'
-
-
-result = o_auth_api.retrieve_token_status(authorization: authorization)
+result = o_auth_api.retrieve_token_status
 
 if result.success?
   puts result.data

doc/api/order-custom-attributes.md

@@ -271,11 +271,11 @@ This method returns a `\ApiResponse` instance. The `data` property in this insta
 ```ruby
 body = {
   :values => {
-    'cover-count': {
+    'cover-count' => {
       :order_id => '7BbXGEIWNldxAzrtGf9GPVZTwZ4F',
       :key => 'cover-count'
     },
-    'table-number': {
+    'table-number' => {
       :order_id => '7BbXGEIWNldxAzrtGf9GPVZTwZ4F',
       :key => 'table-number'
     }
@@ -329,11 +329,11 @@ This method returns a `\ApiResponse` instance. The `data` property in this insta
 ```ruby
 body = {
   :values => {
-    'key0': {
+    'key0' => {
       :custom_attribute => {},
       :order_id => 'order_id4'
     },
-    'key1': {
+    'key1' => {
       :custom_attribute => {},
       :order_id => 'order_id4'
     }