# Payee Accounts

The Payee Accounts API allows merchants to manage the bank or payout accounts linked to their payees.
It enables creating, updating, and retrieving payout account details securely. 
Each payee can have one or more accounts associated for receiving funds.
Use these endpoints to validate account information and ensure smooth disbursements.
This API acts as the secure layer between your system and the banks, handling sensitive financial data.

## Add a payout account to payee

 - [POST /v1/payees/{id}/accounts](https://docs.theropay.cloud/theropay/docs/reference/api/payee-accounts/paths/~1v1~1payees~1%7Bid%7D~1accounts/post.md): Add a payout account to the specified payee (matches user story).

## List all payout accounts for a payee

 - [GET /v1/payees/{id}/accounts](https://docs.theropay.cloud/theropay/docs/reference/api/payee-accounts/paths/~1v1~1payees~1%7Bid%7D~1accounts/get.md): Returns a list of all payout accounts associated with the specified payee. Matches user story.

## Retrieve specific payout account

 - [GET /v1/payees/{id}/accounts/{account_id}](https://docs.theropay.cloud/theropay/docs/reference/api/payee-accounts/paths/~1v1~1payees~1%7Bid%7D~1accounts~1%7Baccount_id%7D/get.md): Returns complete details of a specific payout account for the given payee.

## Update payout account

 - [PATCH /v1/payees/{id}/accounts/{account_id}](https://docs.theropay.cloud/theropay/docs/reference/api/payee-accounts/paths/~1v1~1payees~1%7Bid%7D~1accounts~1%7Baccount_id%7D/patch.md): Use this endpoint to modify payout account details (matches user story).

## Disable payout account

 - [DELETE /v1/payees/{id}/accounts/{account_id}](https://docs.theropay.cloud/theropay/docs/reference/api/payee-accounts/paths/~1v1~1payees~1%7Bid%7D~1accounts~1%7Baccount_id%7D/delete.md): Disables a payout account (sets active flag to false) as per user story.