# Customers

A person or business purchasing goods or services from a merchant using Spenda to facilitate the payment.
 Customers are defined at the merchant level, so if an individual makes payments with multiple merchants,
 they will have a customer record for each of these merchants.

 Spenda supports two broad categories of customers:

 **Consumer customers** are individuals typically making purchases from the merchant via e-commerce websites.
 They are uniquely identified by `emailAddress` for a given merchant.

 **Organisation customers** represent businesses wishing to make purchases from the merchant.
 They are uniquely identified by `referenceCustomerId` for a given merchant.

 * **GET** [/customers](/openapi/april-public/operation/QueryCustomers/) Return a paginated list of matching customers
* **POST** [/customers](/openapi/april-public/operation/UpsertCustomer/) 
Create a new customer or update the details of an existing customer
* **GET** [/customers/{customerId}](/openapi/april-public/operation/GetCustomer/) Return details of a customer
* **POST** [/customers/kyc](/openapi/april-public/operation/KycCustomer/) Perform a Know Your Customer (KYC) check on a consumer customer
* **GET** [/customers/delegates](/openapi/april-public/operation/QueryCustomerDelegates/) Return a paginated list of matching customer delegates
* **GET** [/customers/delegates/{customerDelegateId}](/openapi/april-public/operation/GetCustomerDelegate/) Return details of a customer delegate
* **PATCH** [/customers/delegates/{customerDelegateId}](/openapi/april-public/operation/UpdateCustomerDelegate/) Various actions for updating a customer delegate such as linking to a new customer
* **DELETE** [/customers/delegates/{customerDelegateId}](/openapi/april-public/operation/DeleteCustomerDelegate/) Delete a customer delegate


## Query Customers

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

## Upsert Customer

 - [POST /customers](https://docs.meetapril.io/openapi/april-public/customers/upsertcustomer.md): Create a new customer or update the details of an existing customer.
For consumer customers, the email address and merchant identifier constitute the business key.
For organisation customers, the customer reference id and the merchant identifier constitute the business key.
If a record with the same business key already exists, then it is updated with the provided details, otherwise
a new customer is added.

## Get Customer

 - [GET /customers/{customerId}](https://docs.meetapril.io/openapi/april-public/customers/getcustomer.md): Return details of a customer.

## Kyc Customer

 - [POST /customers/kyc](https://docs.meetapril.io/openapi/april-public/customers/kyccustomer.md): Perform a Know Your Customer (KYC) check on a consumer customer. The response may indicate that more details are required in which case subsequent calls with the additional details can be made. See Know Your Customer for more details. 

Alpha release - Consider this endpoint experimental and very likely to change in future.

## Query Customer Delegates

 - [GET /customers/delegates](https://docs.meetapril.io/openapi/april-public/customers/querycustomerdelegates.md): Return a paginated list of matching customer delegates.

## Get Customer Delegate

 - [GET /customers/delegates/{customerDelegateId}](https://docs.meetapril.io/openapi/april-public/customers/getcustomerdelegate.md): Return details of a customer delegate.

## Delete Customer Delegate

 - [DELETE /customers/delegates/{customerDelegateId}](https://docs.meetapril.io/openapi/april-public/customers/deletecustomerdelegate.md): Delete a customer delegate.

## Update Customer Delegate

 - [PATCH /customers/delegates/{customerDelegateId}](https://docs.meetapril.io/openapi/april-public/customers/updatecustomerdelegate.md): Various actions for updating a customer delegate such as linking to a new customer.