peddler 5.3.1 → 5.4.0

data/lib/peddler/apis/seller_wallet_2024_03_01/transaction_account.rb

@@ -9,26 +9,26 @@ module Peddler
     class SellerWallet20240301
       # Details of the bank account involved in the transaction.
       TransactionAccount = Structure.new do
-        # @return [String] The currency code in ISO 4217 format
+        # @return [String] The currency code in ISO 4217 format.
         attribute(:bank_account_currency, String, null: false, from: "bankAccountCurrency")
 
-        # @return [String] Bank account format
+        # @return [String] The format for the bank account number.
         attribute(:bank_account_number_format, String, null: false, from: "bankAccountNumberFormat")
 
-        # @return [String] The name of the bank
+        # @return [String] The name of the bank.
         attribute(:bank_name, String, null: false, from: "bankName")
 
-        # @return [String] The unique identifier provided by Amazon to identify the account
+        # @return [String] The unique identifier provided by Amazon to identify the account.
         attribute?(:account_id, String, from: "accountId")
 
-        # @return [String] The two digit country code, in ISO 3166 format. This field is OPTIONAL for
-        #   transactionSourceAccount object but is MANDATORY field for transactionDestinationAccount
+        # @return [String] The two-digit country code, in ISO 3166 format. This field is optional for
+        #   `transactionSourceAccount`, but is mandatory for `transactionDestinationAccount`.
         attribute?(:bank_account_country_code, String, from: "bankAccountCountryCode")
 
-        # @return [String] BankAccount holder's name
+        # @return [String] The account holder's name.
         attribute?(:bank_account_holder_name, String, from: "bankAccountHolderName")
 
-        # @return [String] Last 3 digit of the bank account number
+        # @return [String] The last three digits of the bank account number.
         attribute?(:bank_account_number_tail, String, from: "bankAccountNumberTail")
       end
     end

data/lib/peddler/apis/seller_wallet_2024_03_01/transaction_initiation_request.rb

@@ -8,16 +8,18 @@ require "time"
 module Peddler
   module APIs
     class SellerWallet20240301
-      # Request body to initiate a transaction from a SW bank account to another customer defined bank account
+      # Request body to initiate a transaction from a Seller Wallet bank account to another customer-defined bank
+      # account.
       TransactionInitiationRequest = Structure.new do
-        # @return [TransactionInstrumentDetails] Destination bank account details of the transaction request
+        # @return [TransactionInstrumentDetails] Details of the destination bank account in the transaction request.
         attribute(:destination_transaction_instrument, TransactionInstrumentDetails, null: false, from: "destinationTransactionInstrument")
 
-        # @return [Time] The transaction initiation request time in date-time format
+        # @return [Time] The time at which the transaction was initiated in [ISO 8601 date time
+        #   format](https://developer-docs.amazon.com/sp-api/docs/iso-8601).
         attribute(:request_time, Time, null: false, from: "requestTime")
 
-        # @return [String] The unique identifier of the source Amazon SW bank account from where the money needs to be
-        #   debited
+        # @return [String] The unique identifier of the source Amazon Seller Wallet bank account from which the money is
+        #   debited.
         attribute(:source_account_id, String, null: false, from: "sourceAccountId")
 
         # @return [Money] The transaction amount in the source account's currency format. Requests that use a currency
@@ -29,8 +31,7 @@ module Peddler
         #   sensitive information other than VAT-ID.
         attribute?(:customer_payment_reference, String, from: "customerPaymentReference")
 
-        # @return [String] Optional field to specify the unique identifier of the destination bank account where the
-        #   money needs to be deposited
+        # @return [String] The unique identifier of the destination bank account where the money is deposited.
         attribute?(:destination_account_id, String, from: "destinationAccountId")
 
         # @return [PayeeContactInformation] The contact information of a payee.

data/lib/peddler/apis/seller_wallet_2024_03_01/transaction_instrument_details.rb

@@ -7,9 +7,7 @@ require "structure"
 module Peddler
   module APIs
     class SellerWallet20240301
-      # Request body to create transaction instrument, Amazon performs validation and screening (anti-money laundering
-      # measuers) on all the transaction instruments before executing a transaction thus it requires transaction
-      # instrument holder's contact details as well
+      # Details of the destination bank account in the transaction request.
       TransactionInstrumentDetails = Structure.new do
         # @return [String] The bank account holder's name (expected to be an Amazon customer).
         #
@@ -17,12 +15,13 @@ module Peddler
         #   `destAccountDigitalSignature`, and should not be included in the request signature.
         attribute(:account_holder_name, String, null: false, from: "accountHolderName")
 
-        # @return [BankAccount] Specifies the destination bank account details where the money needs to be deposited
+        # @return [BankAccount] Details of the destination bank account.
         attribute(:bank_account, BankAccount, null: false, from: "bankAccount")
 
-        # @return [String] This field would be used to populate the bank account number of the destination payment
-        #   method. The field is intentionally not included in any other Schemas since Amazon internal systems will
-        #   never receive it in unencrypted format, so field won't be part of the request signature
+        # @return [String] The bank account number of the destination payment method.
+        #
+        # **Note:** This field is encrypted before Amazon receives it, so should not be used to generate
+        #   `destAccountDigitalSignature`, and should not be included in the request signature.
         attribute(:bank_account_number, String, null: false, from: "bankAccountNumber")
       end
     end

data/lib/peddler/apis/seller_wallet_2024_03_01/transaction_listing.rb

@@ -7,14 +7,15 @@ require "structure"
 module Peddler
   module APIs
     class SellerWallet20240301
-      # Struct that holds collection of transactions.
+      # A list of transactions.
       TransactionListing = Structure.new do
-        # @return [Array<Transaction>] Collection that holds Transaction
+        # @return [Array<Transaction>] A list of transactions.
         attribute(:transactions, [Transaction], null: false)
 
-        # @return [String] If present, use this pagination token to retrieve the next page of supply sources, if not
-        #   provided the API will return same response. The field will only be provided when the list is greater than
-        #   100.
+        # @return [String] A token that you use to retrieve the next page of results. The response includes
+        #   `nextPageToken` when the number of results exceeds 100. To get the next page of results, call the operation
+        #   with this token and include the same arguments as the call that produced the token. To get a complete list,
+        #   call this operation until `nextPageToken` is null. Note that this operation can return empty pages.
         attribute?(:next_page_token, String, from: "nextPageToken")
       end
     end

data/lib/peddler/apis/seller_wallet_2024_03_01/transfer_rate_preview.rb

@@ -18,16 +18,17 @@ module Peddler
       # In the preceding expressions, **fees** is equal to the sum of all `feeAmount.currencyAmount` values in the
       # `fees` array.
       TransferRatePreview = Structure.new do
-        # @return [Money] Base amount of the transaction.
+        # @return [Money] The base amount of the transaction.
         attribute(:base_amount, Money, null: false, from: "baseAmount")
 
-        # @return [Array<Fee>] List of fees
+        # @return [Array<Fee>] A list of fees.
         attribute(:fees, [Fee], null: false)
 
         # @return [FxRateDetails] The foreign exchange rate value of the transaction.
         attribute(:fx_rate_details, FxRateDetails, null: false, from: "fxRateDetails")
 
-        # @return [Money] The final amount reflects both the fee deduction and currency conversion rate exchange
+        # @return [Money] The final amount transferred, which includes both the fee deduction and currency conversion
+        #   rate.
         attribute(:transfer_amount, Money, null: false, from: "transferAmount")
       end
     end

data/lib/peddler/apis/seller_wallet_2024_03_01/transfer_schedule.rb

@@ -9,33 +9,32 @@ module Peddler
     class SellerWallet20240301
       # Transfer schedule details and related historical details.
       TransferSchedule = Structure.new do
-        # @return [TransactionAccount] Destination bank account details in the scheduled transfer. Here
-        #   bankAccountCountryCode is a MANDATORY field
+        # @return [TransactionAccount] Details of the destination bank account in the scheduled transfer. Here
+        #   `bankAccountCountryCode` is a required field.
         attribute(:transaction_destination_account, TransactionAccount, null: false, from: "transactionDestinationAccount")
 
-        # @return [String] Type of the transfer
+        # @return [String] The type of transfer.
         attribute(:transaction_type, String, null: false, from: "transactionType")
 
-        # @return [Array<TransferScheduleFailures>] Collection that holds Transfer Schedules that has been cancelled or
-        #   failed due to certain reasons.
+        # @return [Array<TransferScheduleFailures>] A list of transfer schedule failures.
         attribute(:transfer_schedule_failures, [TransferScheduleFailures], null: false, from: "transferScheduleFailures")
 
-        # @return [String] The unique identifier provided by Amazon to the scheduled transfer
+        # @return [String] The unique identifier provided by Amazon to the scheduled transfer.
         attribute(:transfer_schedule_id, String, null: false, from: "transferScheduleId")
 
-        # @return [TransferScheduleInformation] Fields required for the scheduled transfer. This information can be
-        #   modified when updating a transfer schedule.
+        # @return [TransferScheduleInformation] The fields required for the scheduled transfer. This information can be
+        #   modified when you update a transfer schedule.
         attribute(:transfer_schedule_information, TransferScheduleInformation, null: false, from: "transferScheduleInformation")
 
-        # @return [String] Type of the transfer schedule. This information can be modified when updating a transfer
+        # @return [String] The type of transfer schedule. This information can be modified when you update a transfer
         #   schedule.
         attribute(:transfer_schedule_status, String, null: false, from: "transferScheduleStatus")
 
-        # @return [PaymentPreference] Payment preference of the scheduled transfer. This information can be modified
-        #   when updating a transfer schedule.
+        # @return [PaymentPreference] The payment preference of the scheduled transfer. This information can be modified
+        #   when you update a transfer schedule.
         attribute?(:payment_preference, PaymentPreference, from: "paymentPreference")
 
-        # @return [TransactionAccount] Source bank account details in the scheduled transfer
+        # @return [TransactionAccount] Details of the source bank account in the scheduled transfer.
         attribute?(:transaction_source_account, TransactionAccount, from: "transactionSourceAccount")
       end
     end

data/lib/peddler/apis/seller_wallet_2024_03_01/transfer_schedule_failures.rb

@@ -8,12 +8,12 @@ require "time"
 module Peddler
   module APIs
     class SellerWallet20240301
-      # Specifies the balance amount in the Amazon SW bank account
+      # The time of and reason for the transfer schedule failure.
       TransferScheduleFailures = Structure.new do
-        # @return [Time] The transfer schedule cancellation date
+        # @return [Time] The transfer schedule failure date.
         attribute(:transfer_schedule_failure_date, Time, null: false, from: "transferScheduleFailureDate")
 
-        # @return [String] The statement/reasoning listed for the cancellation of the transfer schedule
+        # @return [String] The reason listed for the failure of the transfer schedule.
         attribute(:transfer_schedule_failure_reason, String, null: false, from: "transferScheduleFailureReason")
       end
     end

data/lib/peddler/apis/seller_wallet_2024_03_01/transfer_schedule_information.rb

@@ -8,19 +8,18 @@ require "time"
 module Peddler
   module APIs
     class SellerWallet20240301
-      # Parameters containing information required for initiating a schedule transfer
+      # Mandatory information for initiating a schedule transfer.
       TransferScheduleInformation = Structure.new do
-        # @return [Time] Field to specify end date of the scheduled transfer
+        # @return [Time] The end date of the scheduled transfer.
         attribute?(:schedule_end_date, Time, from: "scheduleEndDate")
 
-        # @return [ScheduleExpression] Field to specify expression for how often the schedule transfer repeats. Refer to
-        #   this documentation: https://docs.aws.amazon.com/scheduler/latest/APIReference/API_CreateSchedule.html
+        # @return [ScheduleExpression] How often the scheduled transfer repeats.
         attribute?(:schedule_expression, ScheduleExpression, from: "scheduleExpression")
 
-        # @return [Time] Field to specify start date of the scheduled transfer
+        # @return [Time] The start date of the scheduled transfer.
         attribute?(:schedule_start_date, Time, from: "scheduleStartDate")
 
-        # @return [String] Field to specify type of the transfer being scheduled
+        # @return [String] The type of schedule.
         attribute?(:schedule_type, String, from: "scheduleType")
       end
     end

data/lib/peddler/apis/seller_wallet_2024_03_01/transfer_schedule_listing.rb

@@ -7,14 +7,15 @@ require "structure"
 module Peddler
   module APIs
     class SellerWallet20240301
-      # Struct that holds collection of transfer schedules.
+      # A list of transfer schedules.
       TransferScheduleListing = Structure.new do
-        # @return [Array<TransferSchedule>] Collection that holds list of Transfer Schedules
+        # @return [Array<TransferSchedule>] A list of transfer schedules.
         attribute(:transfer_schedules, [TransferSchedule], null: false, from: "transferSchedules")
 
-        # @return [String] If present, use this pagination token to retrieve the next page of supply sources, if not
-        #   provided the API will return same response. The field will only be provided when the list is greater than
-        #   100.
+        # @return [String] A token that you use to retrieve the next page of results. The response includes
+        #   `nextPageToken` when the number of results exceeds 100. To get the next page of results, call the operation
+        #   with this token and include the same arguments as the call that produced the token. To get a complete list,
+        #   call this operation until `nextPageToken` is null. Note that this operation can return empty pages.
         attribute?(:next_page_token, String, from: "nextPageToken")
       end
     end

data/lib/peddler/apis/seller_wallet_2024_03_01/transfer_schedule_request.rb

@@ -7,34 +7,32 @@ require "structure"
 module Peddler
   module APIs
     class SellerWallet20240301
-      # Request body to initiate a scheduled transfer from a SW bank account to another customer defined bank account
+      # Request body to initiate a scheduled transfer from a Seller Wallet bank account to another customer-defined bank
+      # account.
       TransferScheduleRequest = Structure.new do
-        # @return [String] Optional field to specify the unique identifier of the destination bank account where the
-        #   money needs to be deposited
+        # @return [String] The unique identifier of the destination bank account where the money is deposited.
         attribute(:destination_account_id, String, null: false, from: "destinationAccountId")
 
-        # @return [TransactionInstrumentDetails] Destination bank account details of the transaction request
+        # @return [TransactionInstrumentDetails] Details of the destination bank account in the transaction request.
         attribute(:destination_transaction_instrument, TransactionInstrumentDetails, null: false, from: "destinationTransactionInstrument")
 
-        # @return [PaymentPreference] Payment preference of the scheduled transfer
+        # @return [PaymentPreference] The payment preference of the scheduled transfer.
         attribute(:payment_preference, PaymentPreference, null: false, from: "paymentPreference")
 
-        # @return [String] The unique identifier of the source Amazon SW bank account from where the money needs to be
-        #   debited
+        # @return [String] The unique identifier of the source Amazon Seller Wallet bank account from which money is
+        #   debited.
         attribute(:source_account_id, String, null: false, from: "sourceAccountId")
 
-        # @return [String] Represents 3 letter currency code in ISO 4217 standard format of the source payment method
-        #   country
+        # @return [String] The three-letter currency code of the source payment method country, in ISO 4217 format.
         attribute(:source_currency_code, String, null: false, from: "sourceCurrencyCode")
 
-        # @return [String] Type of the scheduled transaction
+        # @return [String] The type of the scheduled transaction.
         attribute(:transaction_type, String, null: false, from: "transactionType")
 
-        # @return [TransferScheduleInformation] Fields required for the scheduled transfer
+        # @return [TransferScheduleInformation] The configuration of the scheduled transfer.
         attribute(:transfer_schedule_information, TransferScheduleInformation, null: false, from: "transferScheduleInformation")
 
-        # @return [String] Type of the transaction schedule which is mandatory field in request body if a transfer
-        #   schedule needs to be updated
+        # @return [String] The type of transaction schedule. This field is required when you update a transfer schedule.
         attribute?(:transfer_schedule_status, String, from: "transferScheduleStatus")
       end
     end

data/lib/peddler/apis/seller_wallet_2024_03_01.rb

@@ -4,10 +4,7 @@
 
 module Peddler
   module APIs
-    # The Selling Partner API for Amazon Seller Wallet Open Banking API Spec.
-    #
-    # For more information, refer to the [Seller Wallet Open Banking API Use Case
-    # Guide](doc:seller-wallet-open-banking-api-v2024-03-01-use-case-guide).
+    # The Selling Partner API for Amazon Seller Wallet Open Banking API
     #
     # The Selling Partner API for Seller Wallet (Seller Wallet API) provides financial information that is relevant to a
     # seller's Seller Wallet account. You can obtain financial events, balances, and transfer schedules for Seller
@@ -18,7 +15,9 @@ module Peddler
       # Get Seller Wallet accounts for a seller.
       #
       # @note This operation can make a static sandbox call.
-      # @param marketplace_id [String] A marketplace identifier. Specifies the marketplace for which items are returned.
+      # @param marketplace_id [String] The marketplace for which items are returned. The marketplace ID is the globally
+      #   unique identifier of a marketplace. To find the ID for your marketplace, refer to [Marketplace
+      #   IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).
       # @return [Peddler::Response] The API response
       def list_accounts(marketplace_id)
         path = "/finances/transfers/wallet/2024-03-01/accounts"
@@ -32,7 +31,7 @@ module Peddler
       # Retrieve a Seller Wallet bank account by Amazon account identifier.
       #
       # @note This operation can make a static sandbox call.
-      # @param account_id [String] ID of the Amazon SW account
+      # @param account_id [String] The ID of the Amazon Seller Wallet account.
       # @param marketplace_id [String] The marketplace for which items are returned. The marketplace ID is the globally
       #   unique identifier of a marketplace. To find the ID for your marketplace, refer to [Marketplace
       #   IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).
@@ -49,7 +48,7 @@ module Peddler
       # Retrieve the balance in a given Seller Wallet bank account.
       #
       # @note This operation can make a static sandbox call.
-      # @param account_id [String] ID of the Amazon SW account
+      # @param account_id [String] The ID of the Amazon Seller Wallet account.
       # @param marketplace_id [String] The marketplace for which items are returned. The marketplace ID is the globally
       #   unique identifier of a marketplace. To find the ID for your marketplace, refer to [Marketplace
       #   IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).
@@ -63,19 +62,15 @@ module Peddler
         get(path, params:, parser:)
       end
 
-      # Returns list of potential fees on a transaction based on the source and destination country currency code
+      # Retrieve a list of potential fees on a transaction.
       #
       # @note This operation can make a static sandbox call.
-      # @param source_country_code [String] Represents 2 character country code of source transaction account in ISO
-      #   3166 standard format.
-      # @param source_currency_code [String] Represents 3 letter currency code in ISO 4217 standard format of the source
-      #   transaction country.
-      # @param destination_country_code [String] Represents 2 character country code of destination transaction account
-      #   in ISO 3166 standard format.
-      # @param destination_currency_code [String] Represents 3 letter currency code in ISO 4217 standard format of the
-      #   destination transaction country.
-      # @param base_amount [Number] Represents the base transaction amount without any markup fees, rates that will be
-      #   used to get the transfer preview.
+      # @param source_country_code [String] Country code of the source transaction account in ISO 3166 format.
+      # @param source_currency_code [String] Currency code of the source transaction country in ISO 4217 format.
+      # @param destination_country_code [String] Country code of the destination transaction account in ISO 3166 format.
+      # @param destination_currency_code [String] Currency code of the destination transaction country in ISO 4217
+      #   format.
+      # @param base_amount [Number] The base transaction amount without any markup fees.
       # @param marketplace_id [String] The marketplace for which items are returned. The marketplace ID is the globally
       #   unique identifier of a marketplace. To find the ID for your marketplace, refer to [Marketplace
       #   IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).
@@ -98,8 +93,11 @@ module Peddler
       # Retrieve a list of transactions for a given Seller Wallet bank account.
       #
       # @note This operation can make a static sandbox call.
-      # @param account_id [String] ID of the Amazon SW account
-      # @param next_page_token [String] Pagination token to retrieve a specific page of results.
+      # @param account_id [String] The ID of the Amazon Seller Wallet account.
+      # @param next_page_token [String] A token that you use to retrieve the next page of results. The response includes
+      #   `nextPageToken` when the number of results exceeds 100. To get the next page of results, call the operation
+      #   with this token and include the same arguments as the call that produced the token. To get a complete list,
+      #   call this operation until `nextPageToken` is null. Note that this operation can return empty pages.
       # @param marketplace_id [String] The marketplace for which items are returned. The marketplace ID is the globally
       #   unique identifier of a marketplace. To find the ID for your marketplace, refer to [Marketplace
       #   IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).
@@ -118,7 +116,7 @@ module Peddler
       # Create a transaction request from a Seller Wallet account to another customer-provided account.
       #
       # @note This operation can make a static sandbox call.
-      # @param body [Hash] Defines the actual payload of the request
+      # @param body [Hash] The payload of the request
       # @param dest_account_digital_signature [String] Digital signature for the destination bank account details. For
       #   more information, refer to [Third-Party Provider Signature
       #   Guidance](https://developer-docs.amazon.com/sp-api/docs/tpp-registration-signature-guidance).
@@ -139,10 +137,10 @@ module Peddler
         post(path, body:, params:, parser:)
       end
 
-      # Returns a transaction
+      # Find a transaction by the Amazon transaction identifier.
       #
       # @note This operation can make a static sandbox call.
-      # @param transaction_id [String] ID of the Amazon SW transaction
+      # @param transaction_id [String] The ID of the Amazon Seller Wallet transaction.
       # @param marketplace_id [String] The marketplace for which items are returned. The marketplace ID is the globally
       #   unique identifier of a marketplace. To find the ID for your marketplace, refer to [Marketplace
       #   IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).
@@ -159,11 +157,15 @@ module Peddler
       # Retrieve transfer schedules of a Seller Wallet bank account.
       #
       # @note This operation can make a static sandbox call.
-      # @param account_id [String] ID of the Amazon SW account
+      # @param account_id [String] The ID of the Amazon Seller Wallet account.
       # @param marketplace_id [String] The marketplace for which items are returned. The marketplace ID is the globally
       #   unique identifier of a marketplace. To find the ID for your marketplace, refer to [Marketplace
       #   IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).
-      # @param next_page_token [String] Pagination token to retrieve a specific page of results.
+      # @param next_page_token [String] A token that you use to retrieve the next page of results. The response includes
+      #   `nextPageToken` when the number of results exceeds the specified `pageSize` value. To get the next page of
+      #   results, call the operation with this token and include the same arguments as the call that produced the
+      #   token. To get a complete list, call this operation until `nextPageToken` is null. Note that this operation can
+      #   return empty pages.
       # @return [Peddler::Response] The API response
       def list_transfer_schedules(account_id, marketplace_id, next_page_token: nil)
         path = "/finances/transfers/wallet/2024-03-01/transferSchedules"
@@ -179,7 +181,7 @@ module Peddler
       # Create a transfer schedule request from a Seller Wallet account to another customer-provided account.
       #
       # @note This operation can make a static sandbox call.
-      # @param body [Hash] Defines the actual payload of the request
+      # @param body [Hash] The payload of the request.
       # @param dest_account_digital_signature [String] Digital signature for the destination bank account details.
       # @param amount_digital_signature [String] Digital signature for the source currency transaction amount.
       # @param marketplace_id [String] The marketplace for which items are returned. The marketplace ID is the globally
@@ -195,10 +197,10 @@ module Peddler
         post(path, body:, params:, parser:)
       end
 
-      # Returns a transfer belonging to the updated scheduled transfer request
+      # Update transfer schedule information. Returns a transfer belonging to the updated scheduled transfer request.
       #
       # @note This operation can make a static sandbox call.
-      # @param body [Hash] Defines the actual payload of the scheduled transfer request that is to be updated.
+      # @param body [Hash] The payload of the scheduled transfer request that is to be updated.
       # @param dest_account_digital_signature [String] Digital signature for the destination bank account details.
       # @param amount_digital_signature [String] Digital signature for the source currency transaction amount.
       # @param marketplace_id [String] The marketplace for which items are returned. The marketplace ID is the globally

data/lib/peddler/apis/services_v1/money_amount.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# This file is generated. Do not edit.
+
+require "structure"
+
+module Peddler
+  module APIs
+    class ServicesV1
+      # The monetary amount and type of currency.
+      MoneyAmount = Structure.new do
+        # @return [String] The currency code in ISO 4217 format.
+        attribute(:currency, String, null: false)
+
+        # @return [Float] The monetary value.
+        attribute(:value, Float, null: false)
+      end
+    end
+  end
+end

data/lib/peddler/apis/services_v1/payment.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# This file is generated. Do not edit.
+
+require "structure"
+
+module Peddler
+  module APIs
+    class ServicesV1
+      # Payment information for the service job.
+      Payment = Structure.new do
+        # @return [MoneyAmount] The payment amount.
+        attribute?(:amount, MoneyAmount)
+
+        # @return [String] The payment instrument used for the transaction.
+        attribute?(:instrument, String)
+      end
+    end
+  end
+end

data/lib/peddler/apis/services_v1/service_job.rb

@@ -25,6 +25,9 @@ module Peddler
         # @return [String] The marketplace identifier.
         attribute?(:marketplace_id, String, from: "marketplaceId")
 
+        # @return [Array<Payment>] A list that contains payment information for the service job.
+        attribute?(:payments, [Payment])
+
         # @return [Array<AppointmentTime>] A list of appointment windows preferred by the buyer. Included only if the
         #   buyer selected appointment windows when creating the order.
         attribute?(:preferred_appointment_times, [AppointmentTime], from: "preferredAppointmentTimes")

data/lib/peddler/apis/services_v1.rb

@@ -148,7 +148,7 @@ module Peddler
       # @param service_job_id [String] An Amazon-defined service job identifier. Get this value by calling the
       #   `getServiceJobs` operation of the Services API.
       # @param appointment_id [String] An Amazon-defined identifier of active service job appointment.
-      # @param body [Hash]
+      # @param body [Hash] Input containing the resource details to be assigned to the appointment.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def assign_appointment_resources(service_job_id, appointment_id, body, rate_limit: 1.0)

data/lib/peddler/apis/shipment_invoicing_v0/payment_information.rb

@@ -7,21 +7,21 @@ require "structure"
 module Peddler
   module APIs
     class ShipmentInvoicingV0
-      # Payment transaction information
+      # Information about a payment transaction.
       PaymentInformation = Structure.new do
-        # @return [String] Government ID of acquirer
+        # @return [String] The government ID of the acquirer.
         attribute?(:acquirer_id, String, from: "AcquirerId")
 
-        # @return [String] Authorization code for this payment
+        # @return [String] The authorization code of this payment.
         attribute?(:authorization_code, String, from: "AuthorizationCode")
 
-        # @return [String] Credit card brand (if payment method is CreditCard)
+        # @return [String] The credit card brand if the payment method is `CreditCard`.
         attribute?(:card_brand, String, from: "CardBrand")
 
-        # @return [String] Payment method name
+        # @return [String] The name of the payment method.
         attribute?(:payment_method, String, from: "PaymentMethod")
 
-        # @return [Money] Amount paid in this payment
+        # @return [Money] The amount paid in this payment.
         attribute?(:payment_value, Money, from: "PaymentValue")
       end
     end

data/lib/peddler/apis/shipment_invoicing_v0/payment_information_list.rb

@@ -5,7 +5,7 @@
 module Peddler
   module APIs
     class ShipmentInvoicingV0
-      # List of payment transactions
+      # A list of payment transactions.
       class PaymentInformationList < Array
         class << self
           def parse(array)

data/lib/peddler/data_kiosk/economics20240315.json

@@ -2035,6 +2035,12 @@
               "isDeprecated": false,
               "deprecationReason": null
             },
+            {
+              "name": "VARIABLE_DEFINITION",
+              "description": "Location adjacent to a variable definition.",
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
             {
               "name": "SCHEMA",
               "description": "Location adjacent to a schema definition.",
@@ -2100,12 +2106,6 @@
               "description": "Location adjacent to an input object field definition.",
               "isDeprecated": false,
               "deprecationReason": null
-            },
-            {
-              "name": "VARIABLE_DEFINITION",
-              "description": "Location adjacent to a variable definition.",
-              "isDeprecated": false,
-              "deprecationReason": null
             }
           ],
           "possibleTypes": null

data/lib/peddler/data_kiosk/sales_and_traffic20231115.json

@@ -1900,6 +1900,12 @@
               "isDeprecated": false,
               "deprecationReason": null
             },
+            {
+              "name": "VARIABLE_DEFINITION",
+              "description": "Location adjacent to a variable definition.",
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
             {
               "name": "SCHEMA",
               "description": "Location adjacent to a schema definition.",
@@ -1965,12 +1971,6 @@
               "description": "Location adjacent to an input object field definition.",
               "isDeprecated": false,
               "deprecationReason": null
-            },
-            {
-              "name": "VARIABLE_DEFINITION",
-              "description": "Location adjacent to a variable definition.",
-              "isDeprecated": false,
-              "deprecationReason": null
             }
           ],
           "possibleTypes": null