TRtrustly
customers

Create or Update a Customer

Changed on

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

Request

  • Base URL
    https://sandbox.trustly.one/api/v1
  • URL
    https://sandbox.trustly.one/api/v1/customers
  • Auth
    HTTP basic

Query parameters

externalIdstring

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

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

  • dd0a38d95088Revision changes
    • warning

      deleted the header request parameter Authorization

    • info

      the endpoint scheme security HTTPBasic was added to the API

  • 1d5aabcc1d16Revision changes
    • info

      api operation id post-customers removed and replaced with customers_post-customers