Sign in
customers

Create or Update a Customer

Creates a new customer record in the merchant account. In cases when the customer was not created at the time an Authorization was established, use this endpoint to register customer details, such as name, email, and optional metadata, to support your integration.

If an existing customerId or externalId is provided, the specified customer will be updated with any new or updated properties. To remove properties of an existing customer, set the property to null. Before using this endpoint, it may be helpful to call Get Customer by ID to obtain the relevant customer object.

post/customers

Query parameters

externalIdstring

The externalId that was passed when the Customer record was created.

Headers

Authorizationstring required

Request body

namestring required

Full name of the Customer

taxIdstring

Customer tax ID (e.g. SSN [US], SIN [CA]). May be required depending on industry and location.

phonestring required

Customer phone number.

emailstring required

Customer email address.

dateOfBirthstring

Customer date of birth.

createdAtinteger

The record created date and time as a UNIX timestamp.

updatedAtinteger

The record created date and time as a UNIX timestamp.

customerIdstring

A unique Trustly customer identifier.

externalIdstring

A unique merchant customer identifier.

merchantIdstring

A unique Trustly merchant identifier.

enrollDateinteger

Date of the user's first transaction in your system, regardless of payment method used as a UNIX timestamp.

vipstring

Range that determines how low-risk the customer represents to the merchant

currencystring

Customer currency.

balancestring

Customer account balance (not associated with a financial institution account).

organizationNumberstring

Organization number for business accounts

externalTierstring

It should describe the customer''s rank to the merchant (e.g. Gold, Diamond, 4 stars, etc.)

personIdstring

Unique customer identity throughout different banks.

customDataCustomerCustomData

Object for sending merchant-specific custom data.

nationalIdstring

Customer National ID

Response

OK

Changes