Manage VIP tiers

Trustly VIP tiers allow you to bypass standard transaction limits and approval processes for trusted customers who frequently process high-value amounts.

You implement VIP tiers within your Trustly integration by tagging trusted customers as VIPs, which signals the system to apply customized limits and risk policies. This streamlined approval path is crucial for handling transactions that would normally exceed common thresholds, and ensures a frictionless experience for your most valued customers.

Prerequisites

• Defined VIP tiers which have been appropriately configured for your Trustly merchant account by a Trustly integration representative.
• Your application must provide unique customer IDs. These will be passed to Trustly APIs under the externalId field.

Manage VIP tiers

VIP tiers are referenced by positive integer values beginning with 1 and iterating by units of one.

Merchants can make ongoing updates to a customer VIP status; promote, demote, or remove them from the program entirely by using the APIs documented here.

Add VIP customers

To add VIP status to a new customer, pass the appropriate VIP tier when the customer is signing up for Online Banking with the Establish Data object provided to the Trustly UI. In addition to standard required properties, the following properties must be included for the customer to successfully be provided VIP status:

• ExternalID (Merchant Unique customer ID)
• VIP tier value
• Phone
• EnrollDate
• DOB
• TaxID

Example Establish Data Object for new VIP customer:

1
{
2
  "merchantId": "123456",
3
  "merchantReference": "uniqueTransaction123_jsmith",
4
  "paymentType": "deferred",
5
  "customer": {
6
    "name": "Jane Smith",
7
    "externalId": "ABC098",
8
    "email": "jane.smith@email.com",
9
    "phone": "+1 555-555-5555",
10
    "taxId": "123-45-6789",
11
    "dateOfBirth": "1985-10-25",
12
    "enrollDate": "2023-01-15",
13
    "vip": 2,
14
    "address": {
15
      "address1": "2000 Broadway St",
16
      "city": "Redwood City",
17
      "state": "CA",
18
      "zip": "94063",
19
      "country": "US"
20
    }
21
  }
22
}

Update VIP tiers for existing customers

To update the VIP tier of an existing VIP customer (to either promote or demote them) use the Update customer by ID or Create or update a customer record API endpoints.

Update by ID

Call the Update customer by ID endpoint and provide any relevant customer details to be updated along with the desired VIP tier. The customerId is the Trustly customerID returned by the Retrieve a Transaction API.

Example API Call

1
// POST https://trustly.one/api/v1/customers/012345678
2
3
{
4
  "name": "Jane Smith",
5
  "customerId": "012345678",
6
  "merchantId": "123456",
7
  "vip": 1
8
}

Update by External ID

You can also call the Create or update a customer record endpoint. Provide any relevant customer details to be updated along with the desired VIP tier.

Example API Call

1
// POST https://trustly.one/api/v1/customers?externalId=ABC098
2
3
{
4
  "name": "Jane Smith",
5
  "externalId": "012345678",
6
  "merchantId": "123456",
7
  "vip": 1
8
}

Remove a customer’s VIP status

To remove VIP status from an existing customer use the Update customer by ID or Create or update a customer record API endpoints and set the vip property to a value of 0.

Update a customer by customer ID

Example API Call

1
// POST https://trustly.one/api/v1/customers/012345678
2
3
{
4
  "name": "Jane Smith",
5
  "externalId": "ABC098",
6
  "merchantId": "123456",
7
  "vip": 0
8
}

Update a customer by external ID

You can also call the Create or update a customer record endpoint. Provide any relevant customer details to be updated along with the vip property set to a value of 0.

Example API Call

1
// POST https://trustly.one/api/v1/customers?externalId=ABC098
2
3
{
4
  "name": "Jane Smith",
5
  "externalId": "ABC098",
6
  "merchantId": "123456",
7
  "vip": 0
8
}