Generated PR for Release: 25.0.0.20221019

Author: autobot

doc/api/customers.md

@@ -107,7 +107,7 @@ CreateCustomerRequest body = new CreateCustomerRequest.Builder()
     .familyName("Earhart")
     .emailAddress("[email protected]")
     .address(bodyAddress)
-    .phoneNumber("1-212-555-4240")
+    .phoneNumber("+1-212-555-4240")
     .referenceId("YOUR_REFERENCE_ID")
     .note("a customer")
     .build();

doc/api/invoices.md

@@ -111,6 +111,7 @@ InvoiceAcceptedPaymentMethods invoiceAcceptedPaymentMethods = new InvoiceAccepte
     .card(true)
     .squareGiftCard(false)
     .bankAccount(false)
+    .buyNowPayLater(false)
     .build();
 List<InvoiceCustomField> bodyInvoiceCustomFields = new LinkedList<>();
 

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*: `"2022-09-21"` |
+| `squareVersion` | `String` | Square Connect API versions<br>*Default*: `"2022-10-19"` |
 | `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`** |
 | `httpClientConfig` | `ReadonlyHttpClientConfiguration` | Http Client Configuration instance. |
@@ -19,7 +19,7 @@ The API client can be initialized as follows:
 SquareClient client = new SquareClient.Builder()
     .httpClientConfig(configBuilder -> configBuilder
             .timeout(0))
-    .squareVersion("2022-09-21")
+    .squareVersion("2022-10-19")
     .accessToken("AccessToken")
     .environment(Environment.PRODUCTION)
     .customUrl("https://connect.squareup.com")
@@ -45,7 +45,7 @@ public class Program {
         SquareClient client = new SquareClient.Builder()
             .httpClientConfig(configBuilder -> configBuilder
                     .timeout(0))
-            .squareVersion("2022-09-21")
+            .squareVersion("2022-10-19")
             .accessToken("AccessToken")
             .build();
 

doc/models/activity-type.md

@@ -43,4 +43,5 @@
 | `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` | Balance change due to money transfer. |
 

doc/models/cancel-invoice-response.md

@@ -22,6 +22,7 @@ The response returned by the `CancelInvoice` request.
   "invoice": {
     "accepted_payment_methods": {
       "bank_account": false,
+      "buy_now_pay_later": false,
       "card": true,
       "square_gift_card": false
     },

doc/models/create-customer-request.md

@@ -13,16 +13,16 @@ Defines the body parameters that can be included in a request to the
 | Name | Type | Tags | Description | Getter |
 |  --- | --- | --- | --- | --- |
 | `IdempotencyKey` | `String` | Optional | The idempotency key for the request.	For more information, see<br>[Idempotency](https://developer.squareup.com/docs/build-basics/common-api-patterns/idempotency). | String getIdempotencyKey() |
-| `GivenName` | `String` | Optional | The given name (that is, the first name) associated with the customer profile. | String getGivenName() |
-| `FamilyName` | `String` | Optional | The family name (that is, the last name) associated with the customer profile. | String getFamilyName() |
-| `CompanyName` | `String` | Optional | A business name associated with the customer profile. | String getCompanyName() |
-| `Nickname` | `String` | Optional | A nickname for the customer profile. | String getNickname() |
-| `EmailAddress` | `String` | Optional | The email address associated with the customer profile. | String getEmailAddress() |
+| `GivenName` | `String` | Optional | The given name (that is, the first name) associated with the customer profile.<br><br>The maximum length for this value is 300 characters. | String getGivenName() |
+| `FamilyName` | `String` | Optional | The family name (that is, the last name) associated with the customer profile.<br><br>The maximum length for this value is 300 characters. | String getFamilyName() |
+| `CompanyName` | `String` | Optional | A business name associated with the customer profile.<br><br>The maximum length for this value is 500 characters. | String getCompanyName() |
+| `Nickname` | `String` | Optional | A nickname for the customer profile.<br><br>The maximum length for this value is 100 characters. | String getNickname() |
+| `EmailAddress` | `String` | Optional | The email address associated with the customer profile.<br><br>The maximum length for this value is 254 characters. | String getEmailAddress() |
 | `Address` | [`Address`](../../doc/models/address.md) | Optional | Represents a postal address in a country.<br>For more information, see [Working with Addresses](https://developer.squareup.com/docs/build-basics/working-with-addresses). | Address getAddress() |
-| `PhoneNumber` | `String` | Optional | The phone number associated with the customer profile. A phone number can contain 9–16 digits, with an optional `+` prefix. | String getPhoneNumber() |
-| `ReferenceId` | `String` | Optional | An optional second ID used to associate the customer profile with an<br>entity in another system. | String getReferenceId() |
+| `PhoneNumber` | `String` | Optional | The phone number associated with the customer profile. The phone number must be valid and can contain<br>9–16 digits, with an optional `+` prefix and country code. For more information, see<br>[Customer phone numbers](https://developer.squareup.com/docs/customers-api/use-the-api/keep-records#phone-number). | String getPhoneNumber() |
+| `ReferenceId` | `String` | Optional | An optional second ID used to associate the customer profile with an<br>entity in another system.<br><br>The maximum length for this value is 100 characters. | String getReferenceId() |
 | `Note` | `String` | Optional | A custom note associated with the customer profile. | String getNote() |
-| `Birthday` | `String` | Optional | The birthday associated with the customer profile, in RFC 3339 format. The year is optional. The timezone and time are not allowed.<br>For example, `0000-09-21T00:00:00-00:00` represents a birthday on September 21 and `1998-09-21T00:00:00-00:00` represents a birthday on September 21, 1998.<br>You can also specify this value in `YYYY-MM-DD` format. | String getBirthday() |
+| `Birthday` | `String` | Optional | The birthday associated with the customer profile, in `YYYY-MM-DD` or `MM-DD` format. For example,<br>specify `1998-09-21` for September 21, 1998, or `09-21` for September 21. Birthdays are returned in `YYYY-MM-DD`<br>format, where `YYYY` is the specified birth year or `0000` if a birth year is not specified. | String getBirthday() |
 | `TaxIds` | [`CustomerTaxIds`](../../doc/models/customer-tax-ids.md) | Optional | Represents the tax ID associated with a [customer profile](../../doc/models/customer.md). The corresponding `tax_ids` field is available only for customers of sellers in EU countries or the United Kingdom.<br>For more information, see [Customer tax IDs](https://developer.squareup.com/docs/customers-api/what-it-does#customer-tax-ids). | CustomerTaxIds getTaxIds() |
 
 ## Example (as JSON)
@@ -41,7 +41,7 @@ Defines the body parameters that can be included in a request to the
   "family_name": "Earhart",
   "given_name": "Amelia",
   "note": "a customer",
-  "phone_number": "1-212-555-4240",
+  "phone_number": "+1-212-555-4240",
   "reference_id": "YOUR_REFERENCE_ID"
 }
 ```

doc/models/create-customer-response.md

@@ -37,7 +37,7 @@ Either `errors` or `customer` is present in a given response (never both).
     "given_name": "Amelia",
     "id": "JDKYHBWT1D4F8MFH63DBMEN8Y4",
     "note": "a customer",
-    "phone_number": "1-212-555-4240",
+    "phone_number": "+1-212-555-4240",
     "preferences": {
       "email_unsubscribed": false
     },

doc/models/create-invoice-request.md

@@ -22,6 +22,7 @@ Describes a `CreateInvoice` request.
   "invoice": {
     "accepted_payment_methods": {
       "bank_account": false,
+      "buy_now_pay_later": false,
       "card": true,
       "square_gift_card": false
     },

doc/models/create-invoice-response.md

@@ -22,6 +22,7 @@ The response returned by the `CreateInvoice` request.
   "invoice": {
     "accepted_payment_methods": {
       "bank_account": false,
+      "buy_now_pay_later": false,
       "card": true,
       "square_gift_card": false
     },

doc/models/create-payment-request.md

@@ -22,7 +22,7 @@ Describes a request to create a payment using
 | `Autocomplete` | `Boolean` | Optional | If set to `true`, this payment will be completed when possible. If<br>set to `false`, this payment is held in an approved state until either<br>explicitly completed (captured) or canceled (voided). For more information, see<br>[Delayed capture](https://developer.squareup.com/docs/payments-api/take-payments/card-payments#delayed-capture-of-a-card-payment).<br><br>Default: true | Boolean getAutocomplete() |
 | `OrderId` | `String` | Optional | Associates a previously created order with this payment. | String getOrderId() |
 | `CustomerId` | `String` | Optional | The [Customer](../../doc/models/customer.md) ID of the customer associated with the payment.<br><br>This is required if the `source_id` refers to a card on file created using the Customers API. | String getCustomerId() |
-| `LocationId` | `String` | Optional | The location ID to associate with the payment. If not specified, the default location is<br>used. | String getLocationId() |
+| `LocationId` | `String` | Optional | The location ID to associate with the payment. If not specified, the [main location](https://developer.squareup.com/docs/locations-api#about-the-main-location) is<br>used. | String getLocationId() |
 | `TeamMemberId` | `String` | Optional | An optional [TeamMember](../../doc/models/team-member.md) ID to associate with<br>this payment. | String getTeamMemberId() |
 | `ReferenceId` | `String` | Optional | A user-defined ID to associate with the payment.<br><br>You can use this field to associate the payment to an entity in an external system<br>(for example, you might specify an order ID that is generated by a third-party shopping cart).<br>**Constraints**: *Maximum Length*: `40` | String getReferenceId() |
 | `VerificationToken` | `String` | Optional | An identifying token generated by [payments.verifyBuyer()](https://developer.squareup.com/reference/sdks/web/payments/objects/Payments#Payments.verifyBuyer).<br>Verification tokens encapsulate customer device information and 3-D Secure<br>challenge results to indicate that Square has verified the buyer identity.<br><br>For more information, see [SCA Overview](https://developer.squareup.com/docs/sca-overview). | String getVerificationToken() |