Customer

May 27, 2025 ยท View on GitHub

This object defines a customer in your system. Use it to manage customer profiles, save payment methods and contact details.

Structure

Customer

Fields

NameTypeTagsDescriptionGetterSetter
IdStringOptionalThe unique ID for a customer generated by PayPal.

Constraints: Minimum Length: 1, Maximum Length: 22, Pattern: ^[0-9a-zA-Z_-]+$
String getId()setId(String id)
MerchantCustomerIdStringOptionalMerchants and partners may already have a data-store where their customer information is persisted. Use merchant_customer_id to associate the PayPal-generated customer.id to your representation of a customer.

Constraints: Minimum Length: 1, Maximum Length: 64, Pattern: ^[0-9a-zA-Z-_.^*$@#]+$
String getMerchantCustomerId()setMerchantCustomerId(String merchantCustomerId)

Example (as JSON)

{
  "id": "id8",
  "merchant_customer_id": "merchant_customer_id0"
}