# Payouts

A payout represents the transfer of money from Ryft to a connected payout method (bank account), i.e. when we send money you're owed. Typically this is automated.

However, the payouts API allows you to explicitly create payouts for your sub accounts. Generally we'd recommend this if you are a marketplace who wants to control exactly when payouts should be sent out.


## Create a manual payout for a sub account

 - [POST /accounts/{id}/payouts](https://developer.ryftpay.com/documentation/api/reference/openapi/accounts/payoutcreate.md): 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

## List payouts for a sub account

 - [GET /accounts/{id}/payouts](https://developer.ryftpay.com/documentation/api/reference/openapi/accounts/payoutslist.md): Used to fetch a paginated list of payouts for the given sub account

## Retrieve a a payout for a sub account by Id

 - [GET /accounts/{id}/payouts/{payoutId}](https://developer.ryftpay.com/documentation/api/reference/openapi/accounts/payoutgetbyid.md): This is used to fetch a payout by its unique Id

## Create a manual payout for a sub account

 - [POST /accounts/{id}/payouts](https://developer.ryftpay.com/documentation/api/reference/openapi/payouts/payoutcreate.md): 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

## List payouts for a sub account

 - [GET /accounts/{id}/payouts](https://developer.ryftpay.com/documentation/api/reference/openapi/payouts/payoutslist.md): Used to fetch a paginated list of payouts for the given sub account

## Retrieve a a payout for a sub account by Id

 - [GET /accounts/{id}/payouts/{payoutId}](https://developer.ryftpay.com/documentation/api/reference/openapi/payouts/payoutgetbyid.md): This is used to fetch a payout by its unique Id