straddle 0.5.0 → 1.0.0

data/lib/straddle/resources/payouts.rb

@@ -2,64 +2,94 @@
 
 module Straddle
   module Resources
-    # Payouts represent transfers from Straddle to customer bank accounts. Create
-    # payouts to handle disbursements, process refunds, or manage marketplace
-    # settlements. Use payouts to send money quickly and securely with the most
-    # cost-effective rail automatically selected.
+    # Payouts send money to a customer's bank account through a paykey.
     class Payouts
       # Some parameter documentations has been truncated, see
       # {Straddle::Models::PayoutCreateParams} for more details.
       #
-      # Use payouts to send money to your customers.
+      # Creates a payout to a customer's bank account. Straddle submits the payout for
+      # processing on `payment_date` unless the payout is on hold.
       #
       # @overload create(amount:, currency:, description:, device:, external_id:, paykey:, payment_date:, config: nil, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
       #
-      # @param amount [Integer] Body param: The amount of the payout in cents.
+      # @param amount [Integer] Body param: Amount in cents.
       #
-      # @param currency [String] Body param: The currency of the payout. Only USD is supported.
+      # @param currency [String] Body param: Currency code. Only `USD` is supported.
       #
-      # @param description [String, nil] Body param: An arbitrary description for the payout.
+      # @param description [String, nil] Body param: Description shown on the customer's bank statement where supported.
       #
-      # @param device [Straddle::Models::DeviceInfoV1] Body param: Information about the device used when the customer authorized the p
+      # @param device [Straddle::Models::PaymentDevice] Body param: Device used when the customer authorized the payout.
       #
-      # @param external_id [String] Body param: Unique identifier for the payout in your database. This value must b
+      # @param external_id [String] Body param: Your unique identifier for the payout. Must be unique across payouts
       #
-      # @param paykey [String] Body param: Value of the `paykey` used for the payout.
+      # @param paykey [String] Body param: The paykey token that identifies the customer's bank account.
       #
-      # @param payment_date [Date] Body param: The desired date on which the payout should be occur. For payouts, t
+      # @param payment_date [Date] Body param: Date when Straddle submits the payout for processing.
       #
-      # @param config [Straddle::Models::PayoutCreateParams::Config] Body param
+      # @param config [Straddle::Models::PayoutConfiguration] Body param
       #
-      # @param metadata [Hash{Symbol=>String}, nil] Body param: Up to 20 additional user-defined key-value pairs. Useful for storing
+      # @param metadata [Hash{Symbol=>String}, nil] Body param: Up to 20 user-defined string key-value pairs.
       #
-      # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
+      # @param correlation_id [String] Header param: Optional client-generated identifier for tracing a series of relat
       #
-      # @param idempotency_key [String] Header param: Optional client generated value to use for idempotent requests.
+      # @param idempotency_key [String] Header param: Optional client-generated key for an idempotent request.
       #
-      # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
+      # @param request_id [String] Header param: Optional client-generated identifier for tracing one request.
       #
-      # @param straddle_account_id [String] Header param: For use by platforms to specify an account id and set scope of a r
+      # @param straddle_account_id [String] Header param: For platform requests, the embedded account UUID that sets the req
       #
       # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Straddle::Models::PayoutV1]
+      # @return [Straddle::Models::PayoutResponse]
       #
       # @see Straddle::Models::PayoutCreateParams
       def create(params)
         parsed, options = Straddle::PayoutCreateParams.dump_request(params)
-        header_params =
-          {
-            correlation_id: "correlation-id",
-            idempotency_key: "idempotency-key",
-            request_id: "request-id",
-            straddle_account_id: "straddle-account-id"
-          }
+        header_params = {
+          correlation_id: "correlation-id",
+          idempotency_key: "idempotency-key",
+          request_id: "request-id",
+          straddle_account_id: "straddle-account-id"
+        }
         @client.request(
           method: :post,
           path: "v1/payouts",
           headers: parsed.slice(*header_params.keys).transform_keys(header_params),
           body: parsed.except(*header_params.keys),
-          model: Straddle::PayoutV1,
+          model: Straddle::PayoutResponse,
+          options: options
+        )
+      end
+
+      # Returns a payout by its unique identifier.
+      #
+      # @overload retrieve(id, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      #
+      # @param id [String] Unique identifier for the payout.
+      #
+      # @param correlation_id [String] Optional client-generated identifier for tracing a series of related requests.
+      #
+      # @param request_id [String] Optional client-generated identifier for tracing one request.
+      #
+      # @param straddle_account_id [String] For platform requests, the embedded account UUID that sets the request scope.
+      #
+      # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Straddle::Models::PayoutResponse]
+      #
+      # @see Straddle::Models::PayoutRetrieveParams
+      def retrieve(id, params = {})
+        parsed, options = Straddle::PayoutRetrieveParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: ["v1/payouts/%1$s", id],
+          headers:
+            parsed.transform_keys(
+              correlation_id: "correlation-id",
+              request_id: "request-id",
+              straddle_account_id: "straddle-account-id"
+            ),
+          model: Straddle::PayoutResponse,
           options: options
         )
       end
@@ -67,49 +97,48 @@ module Straddle
       # Some parameter documentations has been truncated, see
       # {Straddle::Models::PayoutUpdateParams} for more details.
       #
-      # Update the details of a payout prior to processing. The status of the payout
-      # must be `created`, `scheduled`, or `on_hold`.
+      # Updates the description, amount, `payment_date`, or metadata. The payout must
+      # have a status of `created` or `on_hold`.
       #
       # @overload update(id, amount:, description:, payment_date:, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
       #
-      # @param id [String] Path param
+      # @param id [String] Path param: Unique identifier for the payout.
       #
-      # @param amount [Integer] Body param: The amount of the payout in cents.
+      # @param amount [Integer] Body param: Amount in cents.
       #
-      # @param description [String, nil] Body param: An arbitrary description for the payout.
+      # @param description [String, nil] Body param: Updated description for the payout.
       #
-      # @param payment_date [Date] Body param: The desired date on which the payment should be occur. For payouts,
+      # @param payment_date [Date] Body param: New date for Straddle to submit the payout for processing.
       #
-      # @param metadata [Hash{Symbol=>String}, nil] Body param: Up to 20 additional user-defined key-value pairs. Useful for storing
+      # @param metadata [Hash{Symbol=>String}, nil] Body param: Replacement metadata for the payout. Up to 20 user-defined string ke
       #
-      # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
+      # @param correlation_id [String] Header param: Optional client-generated identifier for tracing a series of relat
       #
-      # @param idempotency_key [String] Header param: Optional client generated value to use for idempotent requests.
+      # @param idempotency_key [String] Header param: Optional client-generated key for an idempotent request.
       #
-      # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
+      # @param request_id [String] Header param: Optional client-generated identifier for tracing one request.
       #
-      # @param straddle_account_id [String] Header param: For use by platforms to specify an account id and set scope of a r
+      # @param straddle_account_id [String] Header param: For platform requests, the embedded account UUID that sets the req
       #
       # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Straddle::Models::PayoutV1]
+      # @return [Straddle::Models::PayoutResponse]
       #
       # @see Straddle::Models::PayoutUpdateParams
       def update(id, params)
         parsed, options = Straddle::PayoutUpdateParams.dump_request(params)
-        header_params =
-          {
-            correlation_id: "correlation-id",
-            idempotency_key: "idempotency-key",
-            request_id: "request-id",
-            straddle_account_id: "straddle-account-id"
-          }
+        header_params = {
+          correlation_id: "correlation-id",
+          idempotency_key: "idempotency-key",
+          request_id: "request-id",
+          straddle_account_id: "straddle-account-id"
+        }
         @client.request(
           method: :put,
           path: ["v1/payouts/%1$s", id],
           headers: parsed.slice(*header_params.keys).transform_keys(header_params),
           body: parsed.except(*header_params.keys),
-          model: Straddle::PayoutV1,
+          model: Straddle::PayoutResponse,
           options: options
         )
       end
@@ -117,120 +146,118 @@ module Straddle
       # Some parameter documentations has been truncated, see
       # {Straddle::Models::PayoutCancelParams} for more details.
       #
-      # Cancel a payout to prevent it from being processed. The status of the payout
-      # must be `created`, `scheduled`, or `on_hold`.
+      # Cancels a payout. The payout must have a status of `created`, `scheduled`, or
+      # `on_hold`.
       #
-      # @overload cancel(id, reason:, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      # @overload cancel(id, reason: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
       #
-      # @param id [String] Path param
+      # @param id [String] Path param: Unique identifier for the payout.
       #
-      # @param reason [String] Body param: Details about why the payout status was updated.
+      # @param reason [String, nil] Body param: Message explaining the payout status change.
       #
-      # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
+      # @param correlation_id [String] Header param: Optional client-generated identifier for tracing a series of relat
       #
-      # @param idempotency_key [String] Header param: Optional client generated value to use for idempotent requests.
+      # @param idempotency_key [String] Header param: Optional client-generated key for an idempotent request.
       #
-      # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
+      # @param request_id [String] Header param: Optional client-generated identifier for tracing one request.
       #
-      # @param straddle_account_id [String] Header param: For use by platforms to specify an account id and set scope of a r
+      # @param straddle_account_id [String] Header param: For platform requests, the embedded account UUID that sets the req
       #
       # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Straddle::Models::PayoutV1]
+      # @return [Straddle::Models::PayoutResponse]
       #
       # @see Straddle::Models::PayoutCancelParams
-      def cancel(id, params)
+      def cancel(id, params = {})
         parsed, options = Straddle::PayoutCancelParams.dump_request(params)
-        header_params =
-          {
-            correlation_id: "correlation-id",
-            idempotency_key: "idempotency-key",
-            request_id: "request-id",
-            straddle_account_id: "straddle-account-id"
-          }
+        header_params = {
+          correlation_id: "correlation-id",
+          idempotency_key: "idempotency-key",
+          request_id: "request-id",
+          straddle_account_id: "straddle-account-id"
+        }
         @client.request(
           method: :put,
           path: ["v1/payouts/%1$s/cancel", id],
           headers: parsed.slice(*header_params.keys).transform_keys(header_params),
           body: parsed.except(*header_params.keys),
-          model: Straddle::PayoutV1,
+          model: Straddle::PayoutResponse,
           options: options
         )
       end
 
-      # Retrieves the details of an existing payout. Supply the unique payout `id` to
-      # retrieve the corresponding payout information.
+      # Some parameter documentations has been truncated, see
+      # {Straddle::Models::PayoutHoldParams} for more details.
+      #
+      # Places a payout on hold to prevent submission for processing. The payout must
+      # have a status of `created` or `scheduled`.
+      #
+      # @overload hold(id, reason: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      #
+      # @param id [String] Path param: Unique identifier for the payout.
       #
-      # @overload get(id, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      # @param reason [String, nil] Body param: Message explaining the payout status change.
       #
-      # @param id [String]
+      # @param correlation_id [String] Header param: Optional client-generated identifier for tracing a series of relat
       #
-      # @param correlation_id [String] Optional client generated identifier to trace and debug a series of requests.
+      # @param idempotency_key [String] Header param: Optional client-generated key for an idempotent request.
       #
-      # @param request_id [String] Optional client generated identifier to trace and debug a request.
+      # @param request_id [String] Header param: Optional client-generated identifier for tracing one request.
       #
-      # @param straddle_account_id [String] For use by platforms to specify an account id and set scope of a request.
+      # @param straddle_account_id [String] Header param: For platform requests, the embedded account UUID that sets the req
       #
       # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Straddle::Models::PayoutV1]
+      # @return [Straddle::Models::PayoutResponse]
       #
-      # @see Straddle::Models::PayoutGetParams
-      def get(id, params = {})
-        parsed, options = Straddle::PayoutGetParams.dump_request(params)
+      # @see Straddle::Models::PayoutHoldParams
+      def hold(id, params = {})
+        parsed, options = Straddle::PayoutHoldParams.dump_request(params)
+        header_params = {
+          correlation_id: "correlation-id",
+          idempotency_key: "idempotency-key",
+          request_id: "request-id",
+          straddle_account_id: "straddle-account-id"
+        }
         @client.request(
-          method: :get,
-          path: ["v1/payouts/%1$s", id],
-          headers: parsed.transform_keys(
-            correlation_id: "correlation-id",
-            request_id: "request-id",
-            straddle_account_id: "straddle-account-id"
-          ),
-          model: Straddle::PayoutV1,
+          method: :put,
+          path: ["v1/payouts/%1$s/hold", id],
+          headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+          body: parsed.except(*header_params.keys),
+          model: Straddle::PayoutResponse,
           options: options
         )
       end
 
-      # Some parameter documentations has been truncated, see
-      # {Straddle::Models::PayoutHoldParams} for more details.
-      #
-      # Hold a payout to prevent it from being processed. The status of the payout must
-      # be `created`, `scheduled`, or `on_hold`.
+      # Return a payout with its sensitive fields unmasked.
       #
-      # @overload hold(id, reason:, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      # @overload list_unmasked(id, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
       #
-      # @param id [String] Path param
+      # @param id [String] Unique identifier for the payout.
       #
-      # @param reason [String] Body param: Details about why the payout status was updated.
+      # @param correlation_id [String] Optional client-generated identifier for tracing a series of related requests.
       #
-      # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
+      # @param request_id [String] Optional client-generated identifier for tracing one request.
       #
-      # @param idempotency_key [String] Header param: Optional client generated value to use for idempotent requests.
-      #
-      # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
-      #
-      # @param straddle_account_id [String] Header param: For use by platforms to specify an account id and set scope of a r
+      # @param straddle_account_id [String] For platform requests, the embedded account UUID that sets the request scope.
       #
       # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Straddle::Models::PayoutV1]
+      # @return [Straddle::Models::UnmaskedPayoutResponse]
       #
-      # @see Straddle::Models::PayoutHoldParams
-      def hold(id, params)
-        parsed, options = Straddle::PayoutHoldParams.dump_request(params)
-        header_params =
-          {
-            correlation_id: "correlation-id",
-            idempotency_key: "idempotency-key",
-            request_id: "request-id",
-            straddle_account_id: "straddle-account-id"
-          }
+      # @see Straddle::Models::PayoutListUnmaskedParams
+      def list_unmasked(id, params = {})
+        parsed, options = Straddle::PayoutListUnmaskedParams.dump_request(params)
         @client.request(
-          method: :put,
-          path: ["v1/payouts/%1$s/hold", id],
-          headers: parsed.slice(*header_params.keys).transform_keys(header_params),
-          body: parsed.except(*header_params.keys),
-          model: Straddle::PayoutV1,
+          method: :get,
+          path: ["v1/payouts/%1$s/unmask", id],
+          headers:
+            parsed.transform_keys(
+              correlation_id: "correlation-id",
+              request_id: "request-id",
+              straddle_account_id: "straddle-account-id"
+            ),
+          model: Straddle::UnmaskedPayoutResponse,
           options: options
         )
       end
@@ -238,124 +265,133 @@ module Straddle
       # Some parameter documentations has been truncated, see
       # {Straddle::Models::PayoutReleaseParams} for more details.
       #
-      # Release a payout from a `hold` status to allow it to be rescheduled for
-      # processing.
+      # Releases a payout from `on_hold` and returns it to `created` for submission on
+      # `payment_date`.
       #
-      # @overload release(id, reason:, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      # @overload release(id, reason: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
       #
-      # @param id [String] Path param
+      # @param id [String] Path param: Unique identifier for the payout.
       #
-      # @param reason [String] Body param: Details about why the payout status was updated.
+      # @param reason [String, nil] Body param: Message explaining the payout status change.
       #
-      # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
+      # @param correlation_id [String] Header param: Optional client-generated identifier for tracing a series of relat
       #
-      # @param idempotency_key [String] Header param: Optional client generated value to use for idempotent requests.
+      # @param idempotency_key [String] Header param: Optional client-generated key for an idempotent request.
       #
-      # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
+      # @param request_id [String] Header param: Optional client-generated identifier for tracing one request.
       #
-      # @param straddle_account_id [String] Header param: For use by platforms to specify an account id and set scope of a r
+      # @param straddle_account_id [String] Header param: For platform requests, the embedded account UUID that sets the req
       #
       # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Straddle::Models::PayoutV1]
+      # @return [Straddle::Models::PayoutResponse]
       #
       # @see Straddle::Models::PayoutReleaseParams
-      def release(id, params)
+      def release(id, params = {})
         parsed, options = Straddle::PayoutReleaseParams.dump_request(params)
-        header_params =
-          {
-            correlation_id: "correlation-id",
-            idempotency_key: "idempotency-key",
-            request_id: "request-id",
-            straddle_account_id: "straddle-account-id"
-          }
+        header_params = {
+          correlation_id: "correlation-id",
+          idempotency_key: "idempotency-key",
+          request_id: "request-id",
+          straddle_account_id: "straddle-account-id"
+        }
         @client.request(
           method: :put,
           path: ["v1/payouts/%1$s/release", id],
           headers: parsed.slice(*header_params.keys).transform_keys(header_params),
           body: parsed.except(*header_params.keys),
-          model: Straddle::PayoutV1,
+          model: Straddle::PayoutResponse,
           options: options
         )
       end
 
-      # Get a payout by id.
+      # Some parameter documentations has been truncated, see
+      # {Straddle::Models::PayoutResubmitParams} for more details.
       #
-      # @overload unmask(id, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      # Creates a new payout from a failed, reversed, or cancelled payout. The request
+      # can override `description`, `external_id`, and `payment_date`. Other payment
+      # details come from the original payout.
       #
-      # @param id [String]
+      # @overload resubmit(id, description: nil, external_id: nil, payment_date: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
       #
-      # @param correlation_id [String] Optional client generated identifier to trace and debug a series of requests.
+      # @param id [String] Path param: Unique identifier for the payout.
       #
-      # @param request_id [String] Optional client generated identifier to trace and debug a request.
+      # @param description [String, nil] Body param: Description for the resubmitted payout. Defaults to the original des
       #
-      # @param straddle_account_id [String] For use by platforms to specify an account id and set scope of a request.
+      # @param external_id [String, nil] Body param: Your unique identifier for the resubmitted payout. Defaults to a new
       #
-      # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
+      # @param payment_date [Date, nil] Body param: Date when Straddle submits the resubmitted payout for processing. De
+      #
+      # @param correlation_id [String] Header param: Optional client-generated identifier for tracing a series of relat
+      #
+      # @param idempotency_key [String] Header param: Optional client-generated key for an idempotent request.
       #
-      # @return [Straddle::Models::PayoutUnmaskResponse]
+      # @param request_id [String] Header param: Optional client-generated identifier for tracing one request.
+      #
+      # @param straddle_account_id [String] Header param: For platform requests, the embedded account UUID that sets the req
+      #
+      # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @see Straddle::Models::PayoutUnmaskParams
-      def unmask(id, params = {})
-        parsed, options = Straddle::PayoutUnmaskParams.dump_request(params)
+      # @return [Straddle::Models::PayoutResponse]
+      #
+      # @see Straddle::Models::PayoutResubmitParams
+      def resubmit(id, params = {})
+        parsed, options = Straddle::PayoutResubmitParams.dump_request(params)
+        header_params = {
+          correlation_id: "correlation-id",
+          idempotency_key: "idempotency-key",
+          request_id: "request-id",
+          straddle_account_id: "straddle-account-id"
+        }
         @client.request(
-          method: :get,
-          path: ["v1/payouts/%1$s/unmask", id],
-          headers: parsed.transform_keys(
-            correlation_id: "correlation-id",
-            request_id: "request-id",
-            straddle_account_id: "straddle-account-id"
-          ),
-          model: Straddle::Models::PayoutUnmaskResponse,
+          method: :post,
+          path: ["v1/payouts/%1$s/resubmit", id],
+          headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+          body: parsed.except(*header_params.keys),
+          model: Straddle::PayoutResponse,
           options: options
         )
       end
 
       # Some parameter documentations has been truncated, see
-      # {Straddle::Models::PayoutUploadAuthorizationDocumentParams} for more details.
+      # {Straddle::Models::PayoutUploadAuthorizationProofParams} for more details.
       #
-      # Uploads a document as proof of authorization for a payout. Uploading again adds
-      # another entry to documents rather than replacing the previous one.
+      # Uploads a proof-of-authorization document for a payout. A later upload adds
+      # another document and does not replace an existing one.
       #
-      # @overload upload_authorization_document(id, file:, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      # @overload upload_authorization_proof(id, file:, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
       #
-      # @param id [String] Path param
+      # @param id [String] Path param: Unique identifier for the payout.
       #
       # @param file [Pathname, StringIO, IO, String, Straddle::FilePart] Body param: The document file to upload as proof of authorization for this payou
       #
-      # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
+      # @param correlation_id [String] Header param: Optional client-generated identifier for tracing a series of relat
       #
-      # @param idempotency_key [String] Header param: Optional client generated value to use for idempotent requests.
+      # @param idempotency_key [String] Header param: Optional client-generated key for an idempotent request.
       #
-      # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
+      # @param request_id [String] Header param: Optional client-generated identifier for tracing one request.
       #
-      # @param straddle_account_id [String] Header param: For use by platforms to specify an account id and set scope of a r
+      # @param straddle_account_id [String] Header param: For platform requests, the embedded account UUID that sets the req
       #
       # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Straddle::Models::PayoutV1]
-      #
-      # @see Straddle::Models::PayoutUploadAuthorizationDocumentParams
-      def upload_authorization_document(id, params)
-        parsed, options = Straddle::PayoutUploadAuthorizationDocumentParams.dump_request(params)
-        header_params =
-          {
-            correlation_id: "correlation-id",
-            idempotency_key: "idempotency-key",
-            request_id: "request-id",
-            straddle_account_id: "straddle-account-id"
-          }
+      # @return [Straddle::Models::PayoutResponse]
+      #
+      # @see Straddle::Models::PayoutUploadAuthorizationProofParams
+      def upload_authorization_proof(id, params)
+        parsed, options = Straddle::PayoutUploadAuthorizationProofParams.dump_request(params)
+        header_params = {
+          correlation_id: "correlation-id",
+          idempotency_key: "idempotency-key",
+          request_id: "request-id",
+          straddle_account_id: "straddle-account-id"
+        }
         @client.request(
           method: :post,
           path: ["v1/payouts/%1$s/authorization", id],
-          headers: {
-            "content-type" => "multipart/form-data",
-            **parsed.slice(*header_params.keys)
-          }.transform_keys(
-            header_params
-          ),
+          headers: parsed.slice(*header_params.keys).transform_keys(header_params),
           body: parsed.except(*header_params.keys),
-          model: Straddle::PayoutV1,
+          model: Straddle::PayoutResponse,
           options: options
         )
       end