Create or Update a Customer

curl -X POST https://sandbox.trustly.one/api/v1/customers \
     -H "Content-Type: application/json" \
     -u "<username>:<password>" \
     -d '{
  "name": "Joe User",
  "address": {
    "country": "US",
    "address1": "2000 Broadway St",
    "city": "Redwood City",
    "state": "CA",
    "zip": "94063"
  },
  "phone": "+16505551212",
  "email": "joe.user@mail.com",
  "taxId": "012345678",
  "createdAt": 1555696836548,
  "updatedAt": 1555696836548,
  "customerId": "1002580963",
  "externalId": "4567890",
  "merchantId": "1002463580",
  "enrollDate": 1555696836548,
  "driverLicense": {
    "number": "A1234567",
    "state": "CA"
  }
}'

{
  "customer": {
    "name": "Joe User",
    "address": {
      "country": "US",
      "address1": "2000 Broadway St",
      "city": "Redwood City",
      "state": "CA",
      "zip": "94063"
    },
    "phone": "+16505551212",
    "email": "joe.user@mail.com",
    "taxId": "012345678",
    "createdAt": 1555696836548,
    "updatedAt": 1555696836548,
    "customerId": "1002580963",
    "externalId": "4567890",
    "merchantId": "1002463580",
    "enrollDate": 1555696836548,
    "driverLicense": {
      "number": "A1234567",
      "state": "CA"
    }
  }
}

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.

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](ref:get-customers-customerid) to obtain the relevant customer object.

Authentication

AuthorizationBasic

Query parameters

externalIdstringOptional

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

Request

namestringRequired>=1 character

Full name of the Customer

addressobjectRequired

Valid mailing or billing address associated with the customer

phonestringRequired

Customer phone number.

emailstringRequired>=1 character

Customer email address.

taxIdstringOptional

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

dateOfBirthstringOptional

Customer date of birth.

externalIdstringOptional>=1 character

A unique merchant customer identifier.

merchantIdstringOptional>=1 character

A unique Trustly merchant identifier.

enrollDateintegerOptional

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

vipstringOptional

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

currencystringOptional

Customer currency.

balancestringOptional

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

organizationNumberstringOptional

Organization number for business accounts

externalTierstringOptional

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

personIdstringOptional

Unique customer identity throughout different banks.

customDataobjectOptional

Object for sending merchant-specific custom data.

driverLicenseobjectOptional

nationalIdstringOptional

Customer National ID

Response

customerobject

The Trustly customer object, containing identification details and contact information.