# Create a manual payout for a sub account

Used to create manual payouts for a specified sub account.
This API can only be accessed for NonHosted sub accounts that are configured for manual payouts.
Note that the following requirements must be met:
  - the payoutMethodId supplied must have status equal to Valid
  - amount must be greater than or equal to the minimum configured payout amount for the account (e.g. £100)
  - verification.status cannot be Required on the account
  - frozen must not be true on the account

Endpoint: POST /accounts/{id}/payouts
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):

  - `amount` (integer, required)
    The amount (in minor units) to payout
    Example: 5000

  - `currency` (string, required)
    The three-letter ISO currency code
    Example: "GBP"

  - `payoutMethodId` (string, required)
    The payout method to send the payout amount to
    Example: "pm_01FCTS1XMKH9FF43CAFA4CXT3P"

  - `metadata` (object,null)
    Used to attach any custom key-value data to the payout. You can have a maximum of 5 pieces of metadata.
    Example: {"orderId":"1","customerId":"123"}

## Response 200 fields (application/json):

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

  - `amount` (integer)
    The total amount that was paid out, minus any fees
    Example: 9750

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

  - `status` (string)
    The status of the payout
    Enum: "Completed", "Failed", "Pending", "PendingAccountVerification", "PendingTransactionVerification", "PendingPayoutMethodAction", "PendingAccountAction", "InProgress", "Cancelled", "Expired", "Recalled", "Returned"

  - `scheduleType` (string)
    Whether the payout was issued automatically by Ryft or manually requested.
    Enum: "Automatic", "Manual"

  - `payoutMethod` (object,null)

  - `payoutMethod.id` (string)
    The payout method the payout will be or was sent to
    Example: "pm_01FCTS1XMKH9FF43CAFA4CXT3P"

  - `payoutMethod.bankAccount` (object)
    The bank details that the payout will be or was sent to. Note that these may be different to those currently assigned to the payout method id, if the payout method has since been updated.

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

  - `payoutMethod.bankAccount.bankId` (string,null)
    The id of the bank that the bank account is with. This is the sort code, swift code or routing number of the bank, depending on the currency + country of the payout method
    Example: "123456"

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

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

  - `payoutMethod.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"

  - `failureReason` (string,null)
    If the payout is in the 'Failed' status, this is an additional reason to explain why
    Example: "InvalidPayoutMethod"

  - `scheme` (string,null)
    The scheme used to payout to your account
    Enum: "Ach", "Bacs", "Chaps", "Fps", "Swift", "Sepa", "SepaInstant"

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

  - `scheduledTimestamp` (integer)
    epoch timestamp of when the payout is scheduled to be paid
    Example: 1631696701

  - `completedTimestamp` (integer,null)
    epoch timestamp of when the payout moved to the 'Completed' status, i.e. when it was paid out
    Example: 1631696701

  - `metadata` (object,null)
    Your custom key-value data for the payout. You can have a maximum of 5 pieces of metadata.
    Example: {"orderId":"1","customerId":"123"}

  - `paymentsTakenDate` (string)
    Deprecated - please use the 'payoutId' param on the /balance-transactions endpoint to see transactions in a payout.
    Example: "2021-10-14"

  - `paymentsTakenDateFrom` (string)
    Deprecated - please use the 'payoutId' param on the /balance-transactions endpoint to see transactions in a payout. The date on which payments within this payout began, in the format yyyy-MM-dd
    Example: "2021-10-14"

  - `paymentsTakenDateTo` (string)
    Deprecated - please use the 'payoutId' param on the /balance-transactions endpoint to see transactions in a payout. The date on which payments within this payout end, in the format yyyy-MM-dd
    Example: "2021-10-14"

  - `payoutCalculation` (object)
    Deprecated - please use the 'payoutId' param on the /balance-transactions endpoint to see transactions in a payout.
An object containing a breakdown of how the payout was calculated

  - `payoutCalculation.paymentsCapturedAmount` (integer)
    The total amount of money credited via captured payments by you or by your sub account, in the minor units of the payout currency
    Example: 10000

  - `payoutCalculation.paymentsRefundedAmount` (integer)
    The total amount of money debited via refunds of payments by you or by your sub account, in the minor units of the payout currency
    Example: 50

  - `payoutCalculation.paymentsSplitAmount` (integer)
    The total amount of money debited from you via payments split with your sub accounts, in the minor units of the payout currency Note that this field is only applicable to your own payouts as the standard account, as sub accounts cannot split payments with others
    Example: 10000

  - `payoutCalculation.paymentsSplitRefundedAmount` (integer)
    The total amount of money credited to you via refunds of payments split with your sub accounts, in the minor units of the payout currency  Note that this field is only applicable to your own payouts as the standard account, as sub accounts cannot split payments with others
    Example: 50

  - `payoutCalculation.splitPaymentsAmount` (integer)
    The total amount of money credited via split payments that your sub account has received, in the minor units of the payout currency Note that this field is only applicable to your sub accounts payouts, as they have payments split with them
    Example: 10000

  - `payoutCalculation.splitPaymentsRefundedAmount` (integer)
    The total amount of money debited via refunds of split payments that your sub account has received, in the minor units of the payout currency Note that this field is only applicable to your sub accounts payouts, as they have payments split with them
    Example: 50

  - `payoutCalculation.platformFeesCollectedAmount` (integer)
    The total amount of money credited to you via platform fees taken from sub accounts, in the minor units of the payout currency. Note that this field is only applicable to your own payouts as the standard account, as sub accounts cannot earn platform fees

  - `payoutCalculation.platformFeesRefundedAmount` (integer)
    The total amount of money debited from you via platform fees refunded to sub accounts, in the minor units of the payout currency. Note that this field is only applicable to your own payouts as the standard account, as sub accounts cannot earn platform fees

  - `payoutCalculation.platformFeesPaidAmount` (integer)
    The total amount of money debited via platform fees paid to you by your sub accounts, in the minor units of the payout currency. Note that this field is only applicable to your sub accounts payouts, as they pay platform fees
    Example: 100

  - `payoutCalculation.processingFeesPaidAmount` (integer)
    The total amount of money debited via processing fees paid by either you or your sub accounts, in the minor units of the payout currency. Note that this is applicable to whoever pays the processing fee on payments, and includes fees from chargebacks
    Example: 100

  - `payoutCalculation.chargebacksAmount` (integer)
    The total amount of money debited via chargebacks raised for your payments, in the minor units of the payout currency. Note that this value excludes chargebacks raised for your sub account payments - see 'platformChargebacksAmount'
    Example: 100

  - `payoutCalculation.chargebackReversalsAmount` (integer)
    The total amount of money credited via reversals of chargebacks raised for your payments, in the minor units of the payout currency. Note that this value excludes chargebacks raised for your sub account payments - see 'platformChargebackReversalsAmount'
    Example: 100

  - `payoutCalculation.platformChargebacksAmount` (integer)
    The total amount of money debited via chargebacks raised for your sub accounts payments, in the minor units of the payout currency.
    Example: 100

  - `payoutCalculation.platformChargebackReversalsAmount` (integer)
    The total amount of money credited via reversals of chargebacks raised for your sub accounts payments, in the minor units of the payout currency.
    Example: 100

  - `payoutCalculation.transferredInAmount` (integer)
    The total amount of money credited via money transferred into your account, in the minor units of the payout currency.
    Example: 100

  - `payoutCalculation.transferredOutAmount` (integer)
    The total amount of money debited via money transferred out of your account, in the minor units of the payout currency.
    Example: 100

  - `payoutCalculation.payoutAmount` (integer)
    The total amount of money paid to you or your sub account, in the minor units of the payout currency
    Example: 9750

  - `payoutCalculation.numberOfPaymentsCaptured` (integer)
    The total number of payments captured by you or your sub account
    Example: 100

  - `payoutCalculation.numberOfPaymentsRefunded` (integer)
    The total number of payments refunded by you or your sub account
    Example: 1

  - `payoutCalculation.numberOfPaymentsSplit` (integer)
    The total number of payments split with your sub accounts Note that this field is only applicable to your own payouts as the standard account, as sub accounts cannot split payments with others
    Example: 100

  - `payoutCalculation.numberOfPaymentsSplitRefunded` (integer)
    The total number of refunds for payments split with your sub accounts Note that this field is only applicable to your own payouts as the standard account, as sub accounts cannot split payments with others
    Example: 1

  - `payoutCalculation.numberOfSplitPayments` (integer)
    The total number of split payments that your sub account has received Note that this field is only applicable to your sub accounts payouts, as they have payments split with them
    Example: 100

  - `payoutCalculation.numberOfSplitPaymentsRefunded` (integer)
    The total number of split payments that your sub account has received Note that this field is only applicable to your sub accounts payouts, as they have payments split with them
    Example: 1

  - `payoutCalculation.numberOfPlatformFeesCollected` (integer)
    The total number of platform fees collected. Note that this field is only applicable to your own payouts as the standard account, as sub accounts cannot earn platform fees

  - `payoutCalculation.numberOfPlatformFeesRefunded` (integer)
    The total number of platform fees refunded. Note that this field is only applicable to your own payouts as the standard account, as sub accounts cannot earn platform fees

  - `payoutCalculation.numberOfChargebacks` (integer)
    The total number of chargebacks that were raised for your accounts payments.

  - `payoutCalculation.numberOfChargebackReversals` (integer)
    The total number of chargebacks that were reversed for your accounts payments.

  - `payoutCalculation.numberOfPlatformChargebacks` (integer)
    The total number of chargebacks that were raised for your sub accounts payments.

  - `payoutCalculation.numberOfPlatformChargebackReversals` (integer)
    The total number of chargebacks that were reversed for your sub accounts payments.

  - `payoutCalculation.numberOfTransfersIn` (integer)
    The total number of transfers made that transferred funds into your account.

  - `payoutCalculation.numberOfTransfersOut` (integer)
    The total number of transfers made that transferred funds out of your account.

  - `payoutCalculation.numberOfCustomers` (integer)
    The total number of unique customers that made payments to you or your sub accounts
    Example: 74

  - `payoutCalculation.numberOfNewCustomers` (integer,null)
    The total number of unique customers that made their first payments to you or your sub accounts on the date these payments were made
    Example: 50

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