# Customers

The Customers API allows you to persist customer details across sessions. You should use this if you wish to support saving a customer's payment methods and thereby enabling them to reuse previously entered details for future payments.


## Creates a new customer within your account

 - [POST /customers](https://developer.ryftpay.com/documentation/api/reference/openapi/customers/customercreate.md): This is for creating customers within your Ryft account (to enable features such as saved payment methods)

## List customers

 - [GET /customers](https://developer.ryftpay.com/documentation/api/reference/openapi/customers/customerslist.md): Used to fetch a paginated list of one or more Customers

## Retrieve a customer by Id

 - [GET /customers/{customerId}](https://developer.ryftpay.com/documentation/api/reference/openapi/customers/customergetbyid.md): This is used to fetch a customer by its unique Id

## Update a customer by Id

 - [PATCH /customers/{customerId}](https://developer.ryftpay.com/documentation/api/reference/openapi/customers/customerupdatebyid.md): This is used to update an existing customer

## Delete a customer (and all their payment methods)

 - [DELETE /customers/{customerId}](https://developer.ryftpay.com/documentation/api/reference/openapi/customers/customerdeletebyid.md): This is used to delete a customer by its unique Id

## Retrieve a customer's payment methods

 - [GET /customers/{customerId}/payment-methods](https://developer.ryftpay.com/documentation/api/reference/openapi/customers/customergetpaymentmethods.md): This is used to fetch a customer's payment methods