v1

latestOpenAPI 3.1.02026-07-243113441.2 MB

Contractor Payment Method

Update a contractor's payment method

Updates a contractor's payment method. Note that creating a contractor bank account will also update the contractor's payment method.

scope: contractor_payment_methods:write

put/v1/contractors/{contractor_uuid}/payment_method

Path parameters

contractor_uuidstring required

The UUID of the contractor

Headers

X-Gusto-API-Version'2026-06-15'

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Request body

versionstring required

The current version of the object. See the versioning guide for information on how to use this field.

type'Direct Deposit' | 'Check' required

The payment method type. If type is Direct Deposit, the contractor is required to have a bank account. See Bank account endpoint.

Example request

{
  "version": "63859768485e218ccf8a449bb60f14ed"
}

Response

Example response

versionstring

The current version of the object. See the versioning guide for information on how to use this field.

type'Direct Deposit' | 'Check' nullable

The payment method type. If type is Check, then split_by and splits do not need to be populated. If type is Direct Deposit, split_by and splits are required.

split_by'Amount' | 'Percentage' nullable

Describes how the payment will be split. If split_by is Percentage, then the split amounts must add up to exactly 100. If split_by is Amount, then values are in cents and the last split amount must be null to capture the remainder.