---
title: "Customer"
source_url: https://docs.rapyd.net/en/customer.html
lang: en
---

# Customer

Customer profile, where payment methods are stored for future use.

Details of the payment method are stored securely in Rapyd's vault, including sensitive personal identifying information (PII) that is subject to regulation by law or payment card industry (PCI) rules. When the payment method is required for an operation, the client uses a token and not the PII.

The `address` object can be added to a Customer object, a Payment Method object, a wallet contact, or the `business_details` field of a business wallet.

> **Note:**
>
> - If you create a customer with a payment method, the payment method is automatically assigned as the customer's default payment method. If you create the customer without a payment method, you must add payment methods individually, and then assign one of them as the default in a separate API call.
> - You cannot delete the customer's default payment method.
> - If you assign a coupon to a customer, the discount defined in the coupon will apply to all purchases made by the customer.
> - If you create a subscription for periodic payments from the customer, the customer must have a default payment method.
> - If you create an invoice for payment by the customer, the customer must have a default payment method.
> - To create a customer, see [Create Customer](https://docs.rapyd.net/en/create-customer.md "Create Customer").

Customer Methods

- [Create Customer](https://docs.rapyd.net/en/create-customer.md "Create Customer")
- [Update Customer](https://docs.rapyd.net/en/update-customer.md "Update Customer")
- [List Customers](https://docs.rapyd.net/en/list-customers-364253.md "List Customers")
- [Retrieve Customer](https://docs.rapyd.net/en/retrieve-customer.md "Retrieve Customer")
- [Delete Customer](https://docs.rapyd.net/en/delete-customer.md "Delete Customer")
- [Delete Discount from Customer](https://docs.rapyd.net/en/delete-discount-from-customer.md "Delete Discount from Customer")

Customer Webhooks

- [Customer Created Webhook](https://docs.rapyd.net/en/customer-created-webhook.md "Customer Created Webhook")
- [Customer Deleted Webhook](https://docs.rapyd.net/en/customer-deleted-webhook.md "Customer Deleted Webhook")
- [Customer Updated Webhook](https://docs.rapyd.net/en/customer-updated-webhook.md "Customer Updated Webhook")

Customer Error Messages

- [Customer Errors](https://docs.rapyd.net/en/customer-errors.md "Customer Errors")