Creating and updating customers
Learn how to create and update a customer.
Last updated
Learn how to create and update a customer.
Last updated
Once you , you can and then . Once the object is created, you can to a customer as well as .
A customers id
must be forty characters or less in length. Anything longer and a 400 Bad Request
with a code
of invalid_parameter
is returned.
We recommend that a customer's identifier be identical in both your and our systems.
If you don't provide us an id
value in the create customer request, we generate one for you and return it in the response.
The email
parameter represents a customer's email address. You can create multiple customers in your account that contain identical email
values.
You can use shipping
to store a customer's name
, phone
, email
, organization
, basic ship to address
, and detailed ship to additionalAddressInfo
.
If you set a customer's enabled
flag to false
, then any attempts to create orders that reference this customer will fail. You should only set enabled
to false
when you want to block a customer from placing orders. For example, you may decide this is necessary when a customer has a history of fraudulent behavior.
The following POST/customers
request specifies a unique id
:
A successful request returns a 201 Created
whose payload contains a customer object:
The following provides guidance on how to define a customer. For complete specifications, refer to the reference documentation.
Every customer can store one or more and .
A customer's locale
is used to .
A customer's type
allows you to .
The defaultSourceId
should reference a that customers have indicated is their default payment instrument.
For more information, refer to on the page.
When you requests, you can use requestToBeForgotten
to instruct Digital River to delete a customer's data from our system.
For more information, refer to the page.
The process of creating and updating a customer is similar. In a , you can specify the object's unique identifier. However, when , you must pass in this unique identifier as a path parameter.
Updating a customer's request also allows you to .
Once you create a customer, you can reference this object in .