square.rb 39.0.0.20240821 → 39.1.0.20240919

Sign up to get free protection for your applications and to get access to all the features.
Files changed (47) hide show
  1. checksums.yaml +4 -4
  2. data/lib/square/api/apple_pay_api.rb +1 -1
  3. data/lib/square/api/bank_accounts_api.rb +3 -3
  4. data/lib/square/api/base_api.rb +1 -1
  5. data/lib/square/api/booking_custom_attributes_api.rb +11 -11
  6. data/lib/square/api/bookings_api.rb +13 -13
  7. data/lib/square/api/cards_api.rb +4 -4
  8. data/lib/square/api/cash_drawers_api.rb +3 -3
  9. data/lib/square/api/catalog_api.rb +14 -14
  10. data/lib/square/api/checkout_api.rb +10 -10
  11. data/lib/square/api/customer_custom_attributes_api.rb +10 -10
  12. data/lib/square/api/customer_groups_api.rb +5 -5
  13. data/lib/square/api/customer_segments_api.rb +2 -2
  14. data/lib/square/api/customers_api.rb +14 -14
  15. data/lib/square/api/devices_api.rb +5 -5
  16. data/lib/square/api/disputes_api.rb +9 -9
  17. data/lib/square/api/employees_api.rb +2 -2
  18. data/lib/square/api/events_api.rb +4 -4
  19. data/lib/square/api/gift_card_activities_api.rb +2 -2
  20. data/lib/square/api/gift_cards_api.rb +7 -7
  21. data/lib/square/api/inventory_api.rb +13 -13
  22. data/lib/square/api/invoices_api.rb +10 -10
  23. data/lib/square/api/labor_api.rb +16 -16
  24. data/lib/square/api/location_custom_attributes_api.rb +11 -11
  25. data/lib/square/api/locations_api.rb +4 -4
  26. data/lib/square/api/loyalty_api.rb +18 -18
  27. data/lib/square/api/merchant_custom_attributes_api.rb +11 -11
  28. data/lib/square/api/merchants_api.rb +2 -2
  29. data/lib/square/api/mobile_authorization_api.rb +1 -1
  30. data/lib/square/api/o_auth_api.rb +3 -3
  31. data/lib/square/api/order_custom_attributes_api.rb +11 -11
  32. data/lib/square/api/orders_api.rb +8 -8
  33. data/lib/square/api/payments_api.rb +7 -7
  34. data/lib/square/api/payouts_api.rb +3 -3
  35. data/lib/square/api/refunds_api.rb +3 -3
  36. data/lib/square/api/sites_api.rb +1 -1
  37. data/lib/square/api/snippets_api.rb +3 -3
  38. data/lib/square/api/subscriptions_api.rb +12 -12
  39. data/lib/square/api/team_api.rb +8 -8
  40. data/lib/square/api/terminal_api.rb +15 -15
  41. data/lib/square/api/transactions_api.rb +4 -4
  42. data/lib/square/api/v1_transactions_api.rb +3 -3
  43. data/lib/square/api/vendors_api.rb +7 -7
  44. data/lib/square/api/webhook_subscriptions_api.rb +8 -8
  45. data/lib/square/client.rb +2 -2
  46. data/lib/square/configuration.rb +1 -1
  47. metadata +2 -2
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 1bda4ce1c716807ae293b2cacb11f2e9db303538ddd78828a1eca0a5464615e9
4
- data.tar.gz: 122c807617e5cc3f57766ef7f2af22b4fd1d24b08c6b56195d41e44cdd2c17ab
3
+ metadata.gz: 4b82da00c49c7711552f187854839f8ab615cc3c066d98ac7cd8ddf735655e3d
4
+ data.tar.gz: 0371cc7d2c09338e65e60d0dd553c24a8d48b640280d3a9d289dec3070908b38
5
5
  SHA512:
6
- metadata.gz: 5348106016605477e1878bb2c0397bb8c32445e58b74142cedc1aa26cf1587509dc98b3c5ab4f8fdc31f0d758b270367c776f1af97d8ef756468743fe2339bdd
7
- data.tar.gz: 212b361dc1a9414fffb346967520ccf74189c30851de9e1632d967fda0d7888dab1066fc1e620109511ad2dba13dcb6208fb99fc05f1279fa12aacdfc4a94afe
6
+ metadata.gz: 21f25423c2fb51a640d15792ab6611c1787c3d6213b6d66bbd8cef84692afaa84b075c9165f043809260b3eaf55863409df5f94bf989632a325ab40c5af064a1
7
+ data.tar.gz: 3362c8d3438ae2bbadf9d23a4fcb56ec1fcf2a0b1822403c52c60f9ee81018907be8a9d6db862ce4dfa0df29aa35f13e36239c6e908b50276a5d9e9e11647a5f
@@ -26,7 +26,7 @@ module Square
26
26
  # @param [RegisterDomainRequest] body Required parameter: An object
27
27
  # containing the fields to POST for the request. See the corresponding
28
28
  # object definition for field details.
29
- # @return [RegisterDomainResponse Hash] response from the API call
29
+ # @return [ApiResponse] the complete http response with raw body and status code.
30
30
  def register_domain(body:)
31
31
  new_api_call_builder
32
32
  .request(new_request_builder(HttpMethodEnum::POST,
@@ -15,7 +15,7 @@ module Square
15
15
  # @param [String] location_id Optional parameter: Location ID. You can
16
16
  # specify this optional filter to retrieve only the linked bank accounts
17
17
  # belonging to a specific location.
18
- # @return [ListBankAccountsResponse Hash] response from the API call
18
+ # @return [ApiResponse] the complete http response with raw body and status code.
19
19
  def list_bank_accounts(cursor: nil,
20
20
  limit: nil,
21
21
  location_id: nil)
@@ -42,7 +42,7 @@ module Square
42
42
  # account by using an ID issued by V1 Bank Accounts
43
43
  # API](https://developer.squareup.com/docs/bank-accounts-api#retrieve-a-bank
44
44
  # -account-by-using-an-id-issued-by-v1-bank-accounts-api).
45
- # @return [GetBankAccountByV1IdResponse Hash] response from the API call
45
+ # @return [ApiResponse] the complete http response with raw body and status code.
46
46
  def get_bank_account_by_v1_id(v1_bank_account_id:)
47
47
  new_api_call_builder
48
48
  .request(new_request_builder(HttpMethodEnum::GET,
@@ -63,7 +63,7 @@ module Square
63
63
  # linked to a Square account.
64
64
  # @param [String] bank_account_id Required parameter: Square-issued ID of
65
65
  # the desired `BankAccount`.
66
- # @return [GetBankAccountResponse Hash] response from the API call
66
+ # @return [ApiResponse] the complete http response with raw body and status code.
67
67
  def get_bank_account(bank_account_id:)
68
68
  new_api_call_builder
69
69
  .request(new_request_builder(HttpMethodEnum::GET,
@@ -5,7 +5,7 @@ module Square
5
5
  attr_accessor :config, :http_call_back
6
6
 
7
7
  def self.user_agent
8
- 'Square-Ruby-SDK/39.0.0.20240821 ({api-version}) {engine}/{engine-version} ({os-info}) {detail}'
8
+ 'Square-Ruby-SDK/39.1.0.20240919 ({api-version}) {engine}/{engine-version} ({os-info}) {detail}'
9
9
  end
10
10
 
11
11
  def self.user_agent_parameters
@@ -18,7 +18,7 @@ module Square
18
18
  # more information, see
19
19
  # [Pagination](https://developer.squareup.com/docs/build-basics/common-api-p
20
20
  # atterns/pagination).
21
- # @return [ListBookingCustomAttributeDefinitionsResponse Hash] response from the API call
21
+ # @return [ApiResponse] the complete http response with raw body and status code.
22
22
  def list_booking_custom_attribute_definitions(limit: nil,
23
23
  cursor: nil)
24
24
  new_api_call_builder
@@ -47,7 +47,7 @@ module Square
47
47
  # @param [CreateBookingCustomAttributeDefinitionRequest] body Required
48
48
  # parameter: An object containing the fields to POST for the request. See
49
49
  # the corresponding object definition for field details.
50
- # @return [CreateBookingCustomAttributeDefinitionResponse Hash] response from the API call
50
+ # @return [ApiResponse] the complete http response with raw body and status code.
51
51
  def create_booking_custom_attribute_definition(body:)
52
52
  new_api_call_builder
53
53
  .request(new_request_builder(HttpMethodEnum::POST,
@@ -75,7 +75,7 @@ module Square
75
75
  # or *Appointments Premium*.
76
76
  # @param [String] key Required parameter: The key of the custom attribute
77
77
  # definition to delete.
78
- # @return [DeleteBookingCustomAttributeDefinitionResponse Hash] response from the API call
78
+ # @return [ApiResponse] the complete http response with raw body and status code.
79
79
  def delete_booking_custom_attribute_definition(key:)
80
80
  new_api_call_builder
81
81
  .request(new_request_builder(HttpMethodEnum::DELETE,
@@ -106,7 +106,7 @@ module Square
106
106
  # the request, Square returns the specified version or a higher version if
107
107
  # one exists. If the specified version is higher than the current version,
108
108
  # Square returns a `BAD_REQUEST` error.
109
- # @return [RetrieveBookingCustomAttributeDefinitionResponse Hash] response from the API call
109
+ # @return [ApiResponse] the complete http response with raw body and status code.
110
110
  def retrieve_booking_custom_attribute_definition(key:,
111
111
  version: nil)
112
112
  new_api_call_builder
@@ -138,7 +138,7 @@ module Square
138
138
  # @param [UpdateBookingCustomAttributeDefinitionRequest] body Required
139
139
  # parameter: An object containing the fields to POST for the request. See
140
140
  # the corresponding object definition for field details.
141
- # @return [UpdateBookingCustomAttributeDefinitionResponse Hash] response from the API call
141
+ # @return [ApiResponse] the complete http response with raw body and status code.
142
142
  def update_booking_custom_attribute_definition(key:,
143
143
  body:)
144
144
  new_api_call_builder
@@ -170,7 +170,7 @@ module Square
170
170
  # @param [BulkDeleteBookingCustomAttributesRequest] body Required parameter:
171
171
  # An object containing the fields to POST for the request. See the
172
172
  # corresponding object definition for field details.
173
- # @return [BulkDeleteBookingCustomAttributesResponse Hash] response from the API call
173
+ # @return [ApiResponse] the complete http response with raw body and status code.
174
174
  def bulk_delete_booking_custom_attributes(body:)
175
175
  new_api_call_builder
176
176
  .request(new_request_builder(HttpMethodEnum::POST,
@@ -199,7 +199,7 @@ module Square
199
199
  # @param [BulkUpsertBookingCustomAttributesRequest] body Required parameter:
200
200
  # An object containing the fields to POST for the request. See the
201
201
  # corresponding object definition for field details.
202
- # @return [BulkUpsertBookingCustomAttributesResponse Hash] response from the API call
202
+ # @return [ApiResponse] the complete http response with raw body and status code.
203
203
  def bulk_upsert_booking_custom_attributes(body:)
204
204
  new_api_call_builder
205
205
  .request(new_request_builder(HttpMethodEnum::POST,
@@ -242,7 +242,7 @@ module Square
242
242
  # each custom attribute. Set this parameter to `true` to get the name and
243
243
  # description of each custom attribute, information about the data type, or
244
244
  # other definition details. The default value is `false`.
245
- # @return [ListBookingCustomAttributesResponse Hash] response from the API call
245
+ # @return [ApiResponse] the complete http response with raw body and status code.
246
246
  def list_booking_custom_attributes(booking_id:,
247
247
  limit: nil,
248
248
  cursor: nil,
@@ -279,7 +279,7 @@ module Square
279
279
  # delete. This key must match the `key` of a custom attribute definition in
280
280
  # the Square seller account. If the requesting application is not the
281
281
  # definition owner, you must use the qualified key.
282
- # @return [DeleteBookingCustomAttributeResponse Hash] response from the API call
282
+ # @return [ApiResponse] the complete http response with raw body and status code.
283
283
  def delete_booking_custom_attribute(booking_id:,
284
284
  key:)
285
285
  new_api_call_builder
@@ -322,7 +322,7 @@ module Square
322
322
  # Square returns the specified version or a higher version if one exists. If
323
323
  # the specified version is higher than the current version, Square returns a
324
324
  # `BAD_REQUEST` error.
325
- # @return [RetrieveBookingCustomAttributeResponse Hash] response from the API call
325
+ # @return [ApiResponse] the complete http response with raw body and status code.
326
326
  def retrieve_booking_custom_attribute(booking_id:,
327
327
  key:,
328
328
  with_definition: false,
@@ -363,7 +363,7 @@ module Square
363
363
  # @param [UpsertBookingCustomAttributeRequest] body Required parameter: An
364
364
  # object containing the fields to POST for the request. See the
365
365
  # corresponding object definition for field details.
366
- # @return [UpsertBookingCustomAttributeResponse Hash] response from the API call
366
+ # @return [ApiResponse] the complete http response with raw body and status code.
367
367
  def upsert_booking_custom_attribute(booking_id:,
368
368
  key:,
369
369
  body:)
@@ -26,7 +26,7 @@ module Square
26
26
  # @param [String] start_at_max Optional parameter: The RFC 3339 timestamp
27
27
  # specifying the latest of the start time. If this is not set, the time of
28
28
  # 31 days after `start_at_min` is used.
29
- # @return [ListBookingsResponse Hash] response from the API call
29
+ # @return [ApiResponse] the complete http response with raw body and status code.
30
30
  def list_bookings(limit: nil,
31
31
  cursor: nil,
32
32
  customer_id: nil,
@@ -71,7 +71,7 @@ module Square
71
71
  # @param [CreateBookingRequest] body Required parameter: An object
72
72
  # containing the fields to POST for the request. See the corresponding
73
73
  # object definition for field details.
74
- # @return [CreateBookingResponse Hash] response from the API call
74
+ # @return [ApiResponse] the complete http response with raw body and status code.
75
75
  def create_booking(body:)
76
76
  new_api_call_builder
77
77
  .request(new_request_builder(HttpMethodEnum::POST,
@@ -97,7 +97,7 @@ module Square
97
97
  # @param [SearchAvailabilityRequest] body Required parameter: An object
98
98
  # containing the fields to POST for the request. See the corresponding
99
99
  # object definition for field details.
100
- # @return [SearchAvailabilityResponse Hash] response from the API call
100
+ # @return [ApiResponse] the complete http response with raw body and status code.
101
101
  def search_availability(body:)
102
102
  new_api_call_builder
103
103
  .request(new_request_builder(HttpMethodEnum::POST,
@@ -123,7 +123,7 @@ module Square
123
123
  # @param [BulkRetrieveBookingsRequest] body Required parameter: An object
124
124
  # containing the fields to POST for the request. See the corresponding
125
125
  # object definition for field details.
126
- # @return [BulkRetrieveBookingsResponse Hash] response from the API call
126
+ # @return [ApiResponse] the complete http response with raw body and status code.
127
127
  def bulk_retrieve_bookings(body:)
128
128
  new_api_call_builder
129
129
  .request(new_request_builder(HttpMethodEnum::POST,
@@ -142,7 +142,7 @@ module Square
142
142
  end
143
143
 
144
144
  # Retrieves a seller's booking profile.
145
- # @return [RetrieveBusinessBookingProfileResponse Hash] response from the API call
145
+ # @return [ApiResponse] the complete http response with raw body and status code.
146
146
  def retrieve_business_booking_profile
147
147
  new_api_call_builder
148
148
  .request(new_request_builder(HttpMethodEnum::GET,
@@ -163,7 +163,7 @@ module Square
163
163
  # @param [String] cursor Optional parameter: The pagination cursor from the
164
164
  # preceding response to return the next page of the results. Do not set this
165
165
  # when retrieving the first page of the results.
166
- # @return [ListLocationBookingProfilesResponse Hash] response from the API call
166
+ # @return [ApiResponse] the complete http response with raw body and status code.
167
167
  def list_location_booking_profiles(limit: nil,
168
168
  cursor: nil)
169
169
  new_api_call_builder
@@ -184,7 +184,7 @@ module Square
184
184
  # Retrieves a seller's location booking profile.
185
185
  # @param [String] location_id Required parameter: The ID of the location to
186
186
  # retrieve the booking profile.
187
- # @return [RetrieveLocationBookingProfileResponse Hash] response from the API call
187
+ # @return [ApiResponse] the complete http response with raw body and status code.
188
188
  def retrieve_location_booking_profile(location_id:)
189
189
  new_api_call_builder
190
190
  .request(new_request_builder(HttpMethodEnum::GET,
@@ -213,7 +213,7 @@ module Square
213
213
  # @param [String] location_id Optional parameter: Indicates whether to
214
214
  # include only team members enabled at the given location in the returned
215
215
  # result.
216
- # @return [ListTeamMemberBookingProfilesResponse Hash] response from the API call
216
+ # @return [ApiResponse] the complete http response with raw body and status code.
217
217
  def list_team_member_booking_profiles(bookable_only: false,
218
218
  limit: nil,
219
219
  cursor: nil,
@@ -239,7 +239,7 @@ module Square
239
239
  # @param [BulkRetrieveTeamMemberBookingProfilesRequest] body Required
240
240
  # parameter: An object containing the fields to POST for the request. See
241
241
  # the corresponding object definition for field details.
242
- # @return [BulkRetrieveTeamMemberBookingProfilesResponse Hash] response from the API call
242
+ # @return [ApiResponse] the complete http response with raw body and status code.
243
243
  def bulk_retrieve_team_member_booking_profiles(body:)
244
244
  new_api_call_builder
245
245
  .request(new_request_builder(HttpMethodEnum::POST,
@@ -260,7 +260,7 @@ module Square
260
260
  # Retrieves a team member's booking profile.
261
261
  # @param [String] team_member_id Required parameter: The ID of the team
262
262
  # member to retrieve.
263
- # @return [RetrieveTeamMemberBookingProfileResponse Hash] response from the API call
263
+ # @return [ApiResponse] the complete http response with raw body and status code.
264
264
  def retrieve_team_member_booking_profile(team_member_id:)
265
265
  new_api_call_builder
266
266
  .request(new_request_builder(HttpMethodEnum::GET,
@@ -285,7 +285,7 @@ module Square
285
285
  # @param [String] booking_id Required parameter: The ID of the
286
286
  # [Booking](entity:Booking) object representing the to-be-retrieved
287
287
  # booking.
288
- # @return [RetrieveBookingResponse Hash] response from the API call
288
+ # @return [ApiResponse] the complete http response with raw body and status code.
289
289
  def retrieve_booking(booking_id:)
290
290
  new_api_call_builder
291
291
  .request(new_request_builder(HttpMethodEnum::GET,
@@ -315,7 +315,7 @@ module Square
315
315
  # @param [UpdateBookingRequest] body Required parameter: An object
316
316
  # containing the fields to POST for the request. See the corresponding
317
317
  # object definition for field details.
318
- # @return [UpdateBookingResponse Hash] response from the API call
318
+ # @return [ApiResponse] the complete http response with raw body and status code.
319
319
  def update_booking(booking_id:,
320
320
  body:)
321
321
  new_api_call_builder
@@ -350,7 +350,7 @@ module Square
350
350
  # @param [CancelBookingRequest] body Required parameter: An object
351
351
  # containing the fields to POST for the request. See the corresponding
352
352
  # object definition for field details.
353
- # @return [CancelBookingResponse Hash] response from the API call
353
+ # @return [ApiResponse] the complete http response with raw body and status code.
354
354
  def cancel_booking(booking_id:,
355
355
  body:)
356
356
  new_api_call_builder
@@ -19,7 +19,7 @@ module Square
19
19
  # @param [SortOrder] sort_order Optional parameter: Sorts the returned list
20
20
  # by when the card was created with the specified order. This field defaults
21
21
  # to ASC.
22
- # @return [ListCardsResponse Hash] response from the API call
22
+ # @return [ApiResponse] the complete http response with raw body and status code.
23
23
  def list_cards(cursor: nil,
24
24
  customer_id: nil,
25
25
  include_disabled: false,
@@ -47,7 +47,7 @@ module Square
47
47
  # @param [CreateCardRequest] body Required parameter: An object containing
48
48
  # the fields to POST for the request. See the corresponding object
49
49
  # definition for field details.
50
- # @return [CreateCardResponse Hash] response from the API call
50
+ # @return [ApiResponse] the complete http response with raw body and status code.
51
51
  def create_card(body:)
52
52
  new_api_call_builder
53
53
  .request(new_request_builder(HttpMethodEnum::POST,
@@ -68,7 +68,7 @@ module Square
68
68
  # Retrieves details for a specific Card.
69
69
  # @param [String] card_id Required parameter: Unique ID for the desired
70
70
  # Card.
71
- # @return [RetrieveCardResponse Hash] response from the API call
71
+ # @return [ApiResponse] the complete http response with raw body and status code.
72
72
  def retrieve_card(card_id:)
73
73
  new_api_call_builder
74
74
  .request(new_request_builder(HttpMethodEnum::GET,
@@ -89,7 +89,7 @@ module Square
89
89
  # Disabling an already disabled card is allowed but has no effect.
90
90
  # @param [String] card_id Required parameter: Unique ID for the desired
91
91
  # Card.
92
- # @return [DisableCardResponse Hash] response from the API call
92
+ # @return [ApiResponse] the complete http response with raw body and status code.
93
93
  def disable_card(card_id:)
94
94
  new_api_call_builder
95
95
  .request(new_request_builder(HttpMethodEnum::POST,
@@ -16,7 +16,7 @@ module Square
16
16
  # events in a page of results (200 by default, 1000 max).
17
17
  # @param [String] cursor Optional parameter: Opaque cursor for fetching the
18
18
  # next page of results.
19
- # @return [ListCashDrawerShiftsResponse Hash] response from the API call
19
+ # @return [ApiResponse] the complete http response with raw body and status code.
20
20
  def list_cash_drawer_shifts(location_id:,
21
21
  sort_order: nil,
22
22
  begin_time: nil,
@@ -48,7 +48,7 @@ module Square
48
48
  # @param [String] location_id Required parameter: The ID of the location to
49
49
  # retrieve cash drawer shifts from.
50
50
  # @param [String] shift_id Required parameter: The shift ID.
51
- # @return [RetrieveCashDrawerShiftResponse Hash] response from the API call
51
+ # @return [ApiResponse] the complete http response with raw body and status code.
52
52
  def retrieve_cash_drawer_shift(location_id:,
53
53
  shift_id:)
54
54
  new_api_call_builder
@@ -75,7 +75,7 @@ module Square
75
75
  # returned in a page of results (200 by default, 1000 max).
76
76
  # @param [String] cursor Optional parameter: Opaque cursor for fetching the
77
77
  # next page of results.
78
- # @return [ListCashDrawerShiftEventsResponse Hash] response from the API call
78
+ # @return [ApiResponse] the complete http response with raw body and status code.
79
79
  def list_cash_drawer_shift_events(location_id:,
80
80
  shift_id:,
81
81
  limit: nil,
@@ -20,7 +20,7 @@ module Square
20
20
  # @param [BatchDeleteCatalogObjectsRequest] body Required parameter: An
21
21
  # object containing the fields to POST for the request. See the
22
22
  # corresponding object definition for field details.
23
- # @return [BatchDeleteCatalogObjectsResponse Hash] response from the API call
23
+ # @return [ApiResponse] the complete http response with raw body and status code.
24
24
  def batch_delete_catalog_objects(body:)
25
25
  new_api_call_builder
26
26
  .request(new_request_builder(HttpMethodEnum::POST,
@@ -47,7 +47,7 @@ module Square
47
47
  # @param [BatchRetrieveCatalogObjectsRequest] body Required parameter: An
48
48
  # object containing the fields to POST for the request. See the
49
49
  # corresponding object definition for field details.
50
- # @return [BatchRetrieveCatalogObjectsResponse Hash] response from the API call
50
+ # @return [ApiResponse] the complete http response with raw body and status code.
51
51
  def batch_retrieve_catalog_objects(body:)
52
52
  new_api_call_builder
53
53
  .request(new_request_builder(HttpMethodEnum::POST,
@@ -87,7 +87,7 @@ module Square
87
87
  # @param [BatchUpsertCatalogObjectsRequest] body Required parameter: An
88
88
  # object containing the fields to POST for the request. See the
89
89
  # corresponding object definition for field details.
90
- # @return [BatchUpsertCatalogObjectsResponse Hash] response from the API call
90
+ # @return [ApiResponse] the complete http response with raw body and status code.
91
91
  def batch_upsert_catalog_objects(body:)
92
92
  new_api_call_builder
93
93
  .request(new_request_builder(HttpMethodEnum::POST,
@@ -115,7 +115,7 @@ module Square
115
115
  # JPEG, PJPEG, PNG, or GIF format. The maximum file size is 15MB.
116
116
  # @param [CreateCatalogImageRequest] request Optional parameter: Example:
117
117
  # @param [File | UploadIO] image_file Optional parameter: Example:
118
- # @return [CreateCatalogImageResponse Hash] response from the API call
118
+ # @return [ApiResponse] the complete http response with raw body and status code.
119
119
  def create_catalog_image(request: nil,
120
120
  image_file: nil)
121
121
  new_api_call_builder
@@ -144,7 +144,7 @@ module Square
144
144
  # object to update the encapsulated image file.
145
145
  # @param [UpdateCatalogImageRequest] request Optional parameter: Example:
146
146
  # @param [File | UploadIO] image_file Optional parameter: Example:
147
- # @return [UpdateCatalogImageResponse Hash] response from the API call
147
+ # @return [ApiResponse] the complete http response with raw body and status code.
148
148
  def update_catalog_image(image_id:,
149
149
  request: nil,
150
150
  image_file: nil)
@@ -169,7 +169,7 @@ module Square
169
169
 
170
170
  # Retrieves information about the Square Catalog API, such as batch size
171
171
  # limits that can be used by the `BatchUpsertCatalogObjects` endpoint.
172
- # @return [CatalogInfoResponse Hash] response from the API call
172
+ # @return [ApiResponse] the complete http response with raw body and status code.
173
173
  def catalog_info
174
174
  new_api_call_builder
175
175
  .request(new_request_builder(HttpMethodEnum::GET,
@@ -218,7 +218,7 @@ module Square
218
218
  # matched against the [CatalogObject]($m/CatalogObject)s' `version`
219
219
  # attribute. If not included, results will be from the current version of
220
220
  # the catalog.
221
- # @return [ListCatalogResponse Hash] response from the API call
221
+ # @return [ApiResponse] the complete http response with raw body and status code.
222
222
  def list_catalog(cursor: nil,
223
223
  types: nil,
224
224
  catalog_version: nil)
@@ -247,7 +247,7 @@ module Square
247
247
  # @param [UpsertCatalogObjectRequest] body Required parameter: An object
248
248
  # containing the fields to POST for the request. See the corresponding
249
249
  # object definition for field details.
250
- # @return [UpsertCatalogObjectResponse Hash] response from the API call
250
+ # @return [ApiResponse] the complete http response with raw body and status code.
251
251
  def upsert_catalog_object(body:)
252
252
  new_api_call_builder
253
253
  .request(new_request_builder(HttpMethodEnum::POST,
@@ -282,7 +282,7 @@ module Square
282
282
  # to be deleted. When an object is deleted, other objects in the graph that
283
283
  # depend on that object will be deleted as well (for example, deleting a
284
284
  # catalog item will delete its catalog item variations).
285
- # @return [DeleteCatalogObjectResponse Hash] response from the API call
285
+ # @return [ApiResponse] the complete http response with raw body and status code.
286
286
  def delete_catalog_object(object_id:)
287
287
  new_api_call_builder
288
288
  .request(new_request_builder(HttpMethodEnum::DELETE,
@@ -336,7 +336,7 @@ module Square
336
336
  # root category. If the returned category is a top-level category, the
337
337
  # `path_to_root` list is empty and is not returned in the response
338
338
  # payload.
339
- # @return [RetrieveCatalogObjectResponse Hash] response from the API call
339
+ # @return [ApiResponse] the complete http response with raw body and status code.
340
340
  def retrieve_catalog_object(object_id:,
341
341
  include_related_objects: false,
342
342
  catalog_version: nil,
@@ -379,7 +379,7 @@ module Square
379
379
  # @param [SearchCatalogObjectsRequest] body Required parameter: An object
380
380
  # containing the fields to POST for the request. See the corresponding
381
381
  # object definition for field details.
382
- # @return [SearchCatalogObjectsResponse Hash] response from the API call
382
+ # @return [ApiResponse] the complete http response with raw body and status code.
383
383
  def search_catalog_objects(body:)
384
384
  new_api_call_builder
385
385
  .request(new_request_builder(HttpMethodEnum::POST,
@@ -417,7 +417,7 @@ module Square
417
417
  # @param [SearchCatalogItemsRequest] body Required parameter: An object
418
418
  # containing the fields to POST for the request. See the corresponding
419
419
  # object definition for field details.
420
- # @return [SearchCatalogItemsResponse Hash] response from the API call
420
+ # @return [ApiResponse] the complete http response with raw body and status code.
421
421
  def search_catalog_items(body:)
422
422
  new_api_call_builder
423
423
  .request(new_request_builder(HttpMethodEnum::POST,
@@ -441,7 +441,7 @@ module Square
441
441
  # @param [UpdateItemModifierListsRequest] body Required parameter: An object
442
442
  # containing the fields to POST for the request. See the corresponding
443
443
  # object definition for field details.
444
- # @return [UpdateItemModifierListsResponse Hash] response from the API call
444
+ # @return [ApiResponse] the complete http response with raw body and status code.
445
445
  def update_item_modifier_lists(body:)
446
446
  new_api_call_builder
447
447
  .request(new_request_builder(HttpMethodEnum::POST,
@@ -465,7 +465,7 @@ module Square
465
465
  # @param [UpdateItemTaxesRequest] body Required parameter: An object
466
466
  # containing the fields to POST for the request. See the corresponding
467
467
  # object definition for field details.
468
- # @return [UpdateItemTaxesResponse Hash] response from the API call
468
+ # @return [ApiResponse] the complete http response with raw body and status code.
469
469
  def update_item_taxes(body:)
470
470
  new_api_call_builder
471
471
  .request(new_request_builder(HttpMethodEnum::POST,
@@ -13,7 +13,7 @@ module Square
13
13
  # @param [CreateCheckoutRequest] body Required parameter: An object
14
14
  # containing the fields to POST for the request. See the corresponding
15
15
  # object definition for field details.
16
- # @return [CreateCheckoutResponse Hash] response from the API call
16
+ # @return [ApiResponse] the complete http response with raw body and status code.
17
17
  def create_checkout(location_id:,
18
18
  body:)
19
19
  warn 'Endpoint create_checkout in CheckoutApi is deprecated'
@@ -38,7 +38,7 @@ module Square
38
38
  # Retrieves the location-level settings for a Square-hosted checkout page.
39
39
  # @param [String] location_id Required parameter: The ID of the location for
40
40
  # which to retrieve settings.
41
- # @return [RetrieveLocationSettingsResponse Hash] response from the API call
41
+ # @return [ApiResponse] the complete http response with raw body and status code.
42
42
  def retrieve_location_settings(location_id:)
43
43
  new_api_call_builder
44
44
  .request(new_request_builder(HttpMethodEnum::GET,
@@ -61,7 +61,7 @@ module Square
61
61
  # @param [UpdateLocationSettingsRequest] body Required parameter: An object
62
62
  # containing the fields to POST for the request. See the corresponding
63
63
  # object definition for field details.
64
- # @return [UpdateLocationSettingsResponse Hash] response from the API call
64
+ # @return [ApiResponse] the complete http response with raw body and status code.
65
65
  def update_location_settings(location_id:,
66
66
  body:)
67
67
  new_api_call_builder
@@ -83,7 +83,7 @@ module Square
83
83
  end
84
84
 
85
85
  # Retrieves the merchant-level settings for a Square-hosted checkout page.
86
- # @return [RetrieveMerchantSettingsResponse Hash] response from the API call
86
+ # @return [ApiResponse] the complete http response with raw body and status code.
87
87
  def retrieve_merchant_settings
88
88
  new_api_call_builder
89
89
  .request(new_request_builder(HttpMethodEnum::GET,
@@ -102,7 +102,7 @@ module Square
102
102
  # @param [UpdateMerchantSettingsRequest] body Required parameter: An object
103
103
  # containing the fields to POST for the request. See the corresponding
104
104
  # object definition for field details.
105
- # @return [UpdateMerchantSettingsResponse Hash] response from the API call
105
+ # @return [ApiResponse] the complete http response with raw body and status code.
106
106
  def update_merchant_settings(body:)
107
107
  new_api_call_builder
108
108
  .request(new_request_builder(HttpMethodEnum::PUT,
@@ -132,7 +132,7 @@ module Square
132
132
  # might return more or less results. If the supplied limit is negative,
133
133
  # zero, or greater than the maximum limit of 1000, it is ignored. Default
134
134
  # value: `100`
135
- # @return [ListPaymentLinksResponse Hash] response from the API call
135
+ # @return [ApiResponse] the complete http response with raw body and status code.
136
136
  def list_payment_links(cursor: nil,
137
137
  limit: nil)
138
138
  new_api_call_builder
@@ -155,7 +155,7 @@ module Square
155
155
  # @param [CreatePaymentLinkRequest] body Required parameter: An object
156
156
  # containing the fields to POST for the request. See the corresponding
157
157
  # object definition for field details.
158
- # @return [CreatePaymentLinkResponse Hash] response from the API call
158
+ # @return [ApiResponse] the complete http response with raw body and status code.
159
159
  def create_payment_link(body:)
160
160
  new_api_call_builder
161
161
  .request(new_request_builder(HttpMethodEnum::POST,
@@ -176,7 +176,7 @@ module Square
176
176
  # Deletes a payment link.
177
177
  # @param [String] id Required parameter: The ID of the payment link to
178
178
  # delete.
179
- # @return [DeletePaymentLinkResponse Hash] response from the API call
179
+ # @return [ApiResponse] the complete http response with raw body and status code.
180
180
  def delete_payment_link(id:)
181
181
  new_api_call_builder
182
182
  .request(new_request_builder(HttpMethodEnum::DELETE,
@@ -195,7 +195,7 @@ module Square
195
195
 
196
196
  # Retrieves a payment link.
197
197
  # @param [String] id Required parameter: The ID of link to retrieve.
198
- # @return [RetrievePaymentLinkResponse Hash] response from the API call
198
+ # @return [ApiResponse] the complete http response with raw body and status code.
199
199
  def retrieve_payment_link(id:)
200
200
  new_api_call_builder
201
201
  .request(new_request_builder(HttpMethodEnum::GET,
@@ -221,7 +221,7 @@ module Square
221
221
  # @param [UpdatePaymentLinkRequest] body Required parameter: An object
222
222
  # containing the fields to POST for the request. See the corresponding
223
223
  # object definition for field details.
224
- # @return [UpdatePaymentLinkResponse Hash] response from the API call
224
+ # @return [ApiResponse] the complete http response with raw body and status code.
225
225
  def update_payment_link(id:,
226
226
  body:)
227
227
  new_api_call_builder
@@ -24,7 +24,7 @@ module Square
24
24
  # more information, see
25
25
  # [Pagination](https://developer.squareup.com/docs/build-basics/common-api-p
26
26
  # atterns/pagination).
27
- # @return [ListCustomerCustomAttributeDefinitionsResponse Hash] response from the API call
27
+ # @return [ApiResponse] the complete http response with raw body and status code.
28
28
  def list_customer_custom_attribute_definitions(limit: nil,
29
29
  cursor: nil)
30
30
  new_api_call_builder
@@ -61,7 +61,7 @@ module Square
61
61
  # @param [CreateCustomerCustomAttributeDefinitionRequest] body Required
62
62
  # parameter: An object containing the fields to POST for the request. See
63
63
  # the corresponding object definition for field details.
64
- # @return [CreateCustomerCustomAttributeDefinitionResponse Hash] response from the API call
64
+ # @return [ApiResponse] the complete http response with raw body and status code.
65
65
  def create_customer_custom_attribute_definition(body:)
66
66
  new_api_call_builder
67
67
  .request(new_request_builder(HttpMethodEnum::POST,
@@ -87,7 +87,7 @@ module Square
87
87
  # Only the definition owner can delete a custom attribute definition.
88
88
  # @param [String] key Required parameter: The key of the custom attribute
89
89
  # definition to delete.
90
- # @return [DeleteCustomerCustomAttributeDefinitionResponse Hash] response from the API call
90
+ # @return [ApiResponse] the complete http response with raw body and status code.
91
91
  def delete_customer_custom_attribute_definition(key:)
92
92
  new_api_call_builder
93
93
  .request(new_request_builder(HttpMethodEnum::DELETE,
@@ -121,7 +121,7 @@ module Square
121
121
  # the request, Square returns the specified version or a higher version if
122
122
  # one exists. If the specified version is higher than the current version,
123
123
  # Square returns a `BAD_REQUEST` error.
124
- # @return [RetrieveCustomerCustomAttributeDefinitionResponse Hash] response from the API call
124
+ # @return [ApiResponse] the complete http response with raw body and status code.
125
125
  def retrieve_customer_custom_attribute_definition(key:,
126
126
  version: nil)
127
127
  new_api_call_builder
@@ -154,7 +154,7 @@ module Square
154
154
  # @param [UpdateCustomerCustomAttributeDefinitionRequest] body Required
155
155
  # parameter: An object containing the fields to POST for the request. See
156
156
  # the corresponding object definition for field details.
157
- # @return [UpdateCustomerCustomAttributeDefinitionResponse Hash] response from the API call
157
+ # @return [ApiResponse] the complete http response with raw body and status code.
158
158
  def update_customer_custom_attribute_definition(key:,
159
159
  body:)
160
160
  new_api_call_builder
@@ -200,7 +200,7 @@ module Square
200
200
  # @param [BulkUpsertCustomerCustomAttributesRequest] body Required
201
201
  # parameter: An object containing the fields to POST for the request. See
202
202
  # the corresponding object definition for field details.
203
- # @return [BulkUpsertCustomerCustomAttributesResponse Hash] response from the API call
203
+ # @return [ApiResponse] the complete http response with raw body and status code.
204
204
  def bulk_upsert_customer_custom_attributes(body:)
205
205
  new_api_call_builder
206
206
  .request(new_request_builder(HttpMethodEnum::POST,
@@ -248,7 +248,7 @@ module Square
248
248
  # each custom attribute. Set this parameter to `true` to get the name and
249
249
  # description of each custom attribute, information about the data type, or
250
250
  # other definition details. The default value is `false`.
251
- # @return [ListCustomerCustomAttributesResponse Hash] response from the API call
251
+ # @return [ApiResponse] the complete http response with raw body and status code.
252
252
  def list_customer_custom_attributes(customer_id:,
253
253
  limit: nil,
254
254
  cursor: nil,
@@ -284,7 +284,7 @@ module Square
284
284
  # delete. This key must match the `key` of a custom attribute definition in
285
285
  # the Square seller account. If the requesting application is not the
286
286
  # definition owner, you must use the qualified key.
287
- # @return [DeleteCustomerCustomAttributeResponse Hash] response from the API call
287
+ # @return [ApiResponse] the complete http response with raw body and status code.
288
288
  def delete_customer_custom_attribute(customer_id:,
289
289
  key:)
290
290
  new_api_call_builder
@@ -333,7 +333,7 @@ module Square
333
333
  # Square returns the specified version or a higher version if one exists. If
334
334
  # the specified version is higher than the current version, Square returns a
335
335
  # `BAD_REQUEST` error.
336
- # @return [RetrieveCustomerCustomAttributeResponse Hash] response from the API call
336
+ # @return [ApiResponse] the complete http response with raw body and status code.
337
337
  def retrieve_customer_custom_attribute(customer_id:,
338
338
  key:,
339
339
  with_definition: false,
@@ -381,7 +381,7 @@ module Square
381
381
  # @param [UpsertCustomerCustomAttributeRequest] body Required parameter: An
382
382
  # object containing the fields to POST for the request. See the
383
383
  # corresponding object definition for field details.
384
- # @return [UpsertCustomerCustomAttributeResponse Hash] response from the API call
384
+ # @return [ApiResponse] the complete http response with raw body and status code.
385
385
  def upsert_customer_custom_attribute(customer_id:,
386
386
  key:,
387
387
  body:)