# Creates a new payout method for a sub account

This is for creating payout methods for one of your sub accounts, so they can receive payouts. You can only create 1 payout method per currency

Endpoint: POST /accounts/{id}/payout-methods
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"

## Request fields (application/json):

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

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

  - `currency` (string)
    The three-character ISO 4217 currency code of the payout method. The currencies available here are the same as are available for making payments.
    Example: "GBP"

  - `country` (string)
    The two-character ISO 3166 country code of the payout method. Only certain countries are supported for a given currency
    Example: "GB"

  - `bankAccount` (object)

  - `bankAccount.bankIdType` (string,null)
    Enum: "RoutingNumber", "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: "0230"

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

  - `bankAccount.accountNumber` (string)
    The account number of the bank account This is the account number or IBAN of the bank account, depending on the currency + country of the payout method
    Example: "082100"

  - `bankAccount.address` (object,null)
    The address of the bank account holder If not provided for Business entities, the address of the business will be used If not provided for Individual entities, the address of the individual will be used

## 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 400 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 409 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"