# Merchants

A business or individual that uses Spenda to facilitate payments for their customers.

 * **GET** [/merchants](/openapi/april-public/operation/QueryMerchants/) Return a paginated list of matching merchants
* **POST** [/merchants](/openapi/april-public/operation/CreateMerchant/) Create a new sub-merchant within the context of a marketplace
* **GET** [/merchants/{merchantId}](/openapi/april-public/operation/GetMerchant/) Return details of a merchant
* **PATCH** [/merchants/{merchantId}](/openapi/april-public/operation/UpdateMerchant/) Various actions for updating a merchant such as updating the bank account used for payouts
* **GET** [/merchants/{merchantId}/balances](/openapi/april-public/operation/QueryBalances/) Query the account balances of a merchant
* **POST** [/merchants/{merchantId}/files](/openapi/april-public/operation/UploadMerchantFile/) Upload a document scan as part of the merchant onboarding profile
* **GET** [/merchants/{merchantId}/files/{fileId}](/openapi/april-public/operation/GetMerchantFile/) Get details on a merchant onboarding file
* **GET** [/merchants/{merchantId}/applepay](/openapi/april-public/operation/GetMerchantApplePayDomains/) Get the domains registered for ApplePay for the specified merchant
* **GET** [/merchants/{merchantId}/owners](/openapi/april-public/operation/ListBeneficialOwners/) Return details of all beneficial owners for the given merchant
* **POST** [/merchants/{merchantId}/owners](/openapi/april-public/operation/CreateBeneficialOwner/) Create a beneficial owner for the given merchant
* **GET** [/merchants/{merchantId}/owners/{ownerId}](/openapi/april-public/operation/GetBeneficialOwner/) Return details of a beneficial owner
* **PUT** [/merchants/{merchantId}/owners/{ownerId}](/openapi/april-public/operation/ReplaceBeneficialOwner/) Overwrite an existing beneficial owner
* **DELETE** [/merchants/{merchantId}/owners/{ownerId}](/openapi/april-public/operation/DeleteBeneficialOwner/) Delete a beneficial owner
* **GET** [/merchants/industries](/openapi/april-public/operation/GetIndustries/) List all industries we currently support


## Query Merchants

 - [GET /merchants](https://docs.meetapril.io/openapi/april-public/merchants/querymerchants.md): Return a paginated list of matching merchants.

## Create Merchant

 - [POST /merchants](https://docs.meetapril.io/openapi/april-public/merchants/createmerchant.md): Create a new sub-merchant within the context of a marketplace.

## Get Merchant

 - [GET /merchants/{merchantId}](https://docs.meetapril.io/openapi/april-public/merchants/getmerchant.md): Return details of a merchant.

## Update Merchant

 - [PATCH /merchants/{merchantId}](https://docs.meetapril.io/openapi/april-public/merchants/updatemerchant.md): Various actions for updating a merchant such as updating the bank account used for payouts.

## Query Balances

 - [GET /merchants/{merchantId}/balances](https://docs.meetapril.io/openapi/april-public/merchants/querybalances.md): Query the account balances of a merchant.

## Upload Merchant File

 - [POST /merchants/{merchantId}/files](https://docs.meetapril.io/openapi/april-public/merchants/uploadmerchantfile.md): Upload a document scan as part of the merchant onboarding profile. The maximum permitted file size is 10MB. Supported file types are JPEG, PNG and PDF.

## Get Merchant File

 - [GET /merchants/{merchantId}/files/{fileId}](https://docs.meetapril.io/openapi/april-public/merchants/getmerchantfile.md): Get details on a merchant onboarding file

## Get Merchant Apple Pay Domains

 - [GET /merchants/{merchantId}/applepay](https://docs.meetapril.io/openapi/april-public/merchants/getmerchantapplepaydomains.md): Get the domains registered for ApplePay for the specified merchant

## List Beneficial Owners

 - [GET /merchants/{merchantId}/owners](https://docs.meetapril.io/openapi/april-public/merchants/listbeneficialowners.md): Return details of all beneficial owners for the given merchant.

## Create Beneficial Owner

 - [POST /merchants/{merchantId}/owners](https://docs.meetapril.io/openapi/april-public/merchants/createbeneficialowner.md): Create a beneficial owner for the given merchant.

## Get Beneficial Owner

 - [GET /merchants/{merchantId}/owners/{ownerId}](https://docs.meetapril.io/openapi/april-public/merchants/getbeneficialowner.md): Return details of a beneficial owner.

## Replace Beneficial Owner

 - [PUT /merchants/{merchantId}/owners/{ownerId}](https://docs.meetapril.io/openapi/april-public/merchants/replacebeneficialowner.md): Overwrite an existing beneficial owner.

## Delete Beneficial Owner

 - [DELETE /merchants/{merchantId}/owners/{ownerId}](https://docs.meetapril.io/openapi/april-public/merchants/deletebeneficialowner.md): Delete a beneficial owner.

## Get Industries

 - [GET /merchants/industries](https://docs.meetapril.io/openapi/april-public/merchants/getindustries.md): List all industries we currently support. Merchants in April need to be assigned an industry during onboarding.