# Update a payout method by Id

This is used to update an existing payout method for one of your sub accounts

Endpoint: PATCH /accounts/{id}/payout-methods/{payoutMethodId}
Version: 1.1.0
Security: secretApiKeyAuth

## Path parameters:

  - `id` (string, required)
    the account id of one of your sub accounts
    Example: "ac_b83f2653-06d7-44a9-a548-5825e8186004"

  - `payoutMethodId` (string, required)
    Payout method to retrieve
    Example: "pm_01FCTS1XMKH9FF43CAFA4CXT3P"

## Request fields (application/json):

  - `displayName` (string,null)
    A friendly name for the payout method, for display only
    Example: "Primary GBP Account"

  - `bankAccount` (object,null)

## Response 200 fields (application/json):

  - `id` (string)
    The id of the payout method
    Example: "pm_01G0EYVFR02KBBVE2YWQ8AKMGJ"

  - `type` (string)
    Enum: "BankAccount"

  - `displayName` (string,null)
    A friendly name for the payout method, for display only
    Example: "Primary GBP Account"

  - `status` (string)
    Enum: "Pending", "Invalid", "Valid"

  - `invalidReason` (string,null)
    The reason why the payout method has been marked as 'Invalid'

  - `currency` (string)
    The three-character ISO 4217 currency code of the payout method
    Example: "GBP"

  - `countryCode` (string)
    The two-character ISO 3166 country code of the payout method
    Example: "GB"

  - `bankAccount` (object)

  - `bankAccount.bankIdType` (string,null)
    Enum: "RoutingNumber", "SwiftCode", "SortCode"

  - `bankAccount.bankId` (string,null)
    The id of the bank that the bank account is with, e.g. sort code / routing number (see bankIdType)
    Example: "0123"

  - `bankAccount.bankName` (string,null)
    The name of the bank that the bank account is with
    Example: "Ryft Bank Ltd"

  - `bankAccount.accountNumberType` (string)
    Enum: "Iban", "UnitedKingdom", "UnitedStates"

  - `bankAccount.last4` (string)
    The last 4 digits of the account number for the bank account. This is the account number or IBAN of the bank account, depending on the currency + country of the payout method
    Example: "0001"

  - `bankAccount.address` (object,null)
    The address of the bank account holder

  - `createdTimestamp` (integer)
    The epoch timestamp (seconds) when the payout method was created
    Example: 1470989538

  - `lastUpdatedTimestamp` (integer)
    The epoch timestamp (seconds) when the payout method was last updated
    Example: 1470989538

## Response 404 fields (application/json):

  - `requestId` (string)
    Example: "b83f2653-06d7-44a9-a548-5825e8186004"

  - `code` (string)
    Example: "400"

  - `errors` (array)

  - `errors.message` (string)
    Example: "Required property 'amount' not found in JSON"

## Response 500 fields (application/json):

  - `requestId` (string)
    Example: "b83f2653-06d7-44a9-a548-5825e8186004"

  - `code` (string)
    Example: "400"

  - `errors` (array)

  - `errors.message` (string)
    Example: "Required property 'amount' not found in JSON"