UKG Stablecoin Payroll Integration Guide

First you will need to locate your API credential to establish the connection to your UKG tenant. Follow the steps below to save locate the information needed, you can copy these as you will need these later:

Navigate to Security > Web Services.

• User API key
• Customer API key
• Tenant ID
• Any one of the service endpoint URLs such as:
  • “Employee contacts service endpoint”
  • “Employee person service endpoint”

A service account is an account through which our Toku will be performing actions via external API. This allows you to ensure only the necessary information is being sent to Toku to perform Stablecoin payroll.

1. Go to Security > Service Account Administration.

1. Click on "Add" in the Service Account Administration page.

1. Create a user name and password.
2. Username: TOKU_SYSTEM
3. Email: dev@toku.com
4. Password: (Generate new password)
5. Select the following fields at the following configuration in the Web Service section.
6. Employee Compensation Details - View
7. Employee Person Details - View
8. Custom Integrations - View and Edit
9. Deduction integration - View
10. Payroll integration - Add, View and Edit
11. Employee Export - View
12. Employee employment information - View
13. Employee compensation - View and Edit
14. Company Configuration Integration - View
15. Personnel Integration - View

Note: The “view” fields are required for Toku to ensure we are able to match the employee on this payroll with the corresponding employee in your HCM system (Workday, BambooHR, Oracle, ect.)

Note: The “edit” fields are required for Toku to insert Stablecoin deductions directly on upcoming payrolls for each employee.

Make sure that you have a record of the following information:

• User name: (from step 3)
• Password: (from step 3)
• User API Key: (to the right of the the newly created user)
• Customer API Key: (at the top of Service Account Administration panel)

We will now create a custom post tax deduction that is exclusively used for these stablecoin deductions. This allows you to indicate clearly that this deduction is tied to the voluntary action the employee has taken within Toku.

1. Go To Business Rules

1. Search for “deductions” → Click on “Deduction/Benefits Plans”

1. Add Deduction/Benefit Plan

1. Select today as the effective date
2. Add Details
3. Description - Stablecoin Deduction
4. Description Type - Other
5. Tax Category - Voluntary Withholding
6. Deduction start and stop dates
7. Start - Today
8. Enrollment Disclaimer - “This is the voluntary amount already paid in stablecoins through Toku.” Click Next (Top right corner)

1. Click Next
2. In the Calculations page -
3. Under Employee, select the “Use rate at employee level” checkbox
4. In the “Amount” row for the “Calculation Rules” column - there's a drop down. Select “Flat amount”

Click Next

1. Select the Paychecks per pay period, we want this deduction to be posted in the “Scheduled Pay Periods by Default”. Click Next.

1. The review screen comes up, click “Save”

As part of this we need to add the deduction plan we created to the required deduction group.

1. Go To Business Rules

1. Search for “deductions” → Click on “Deduction/Benefit Groups”
2. Select the deduction group (Country) that we want to add a Deduction code to.

1. For the deduction group under the “Plans” table click “Add”

1. In the “Add record” pop up for the “Deductions/Benefit Plan” field click the drop down and select the SCDED deduction code which we created in the previous step. Click “Add”

1. Save the changes to the deduction group

1. Login into your Toku profile at https://app.toku.com/login

1. Click on Settings in the left side navbar

1. Click on Payroll Integrations Card

1. click on the UKG card on the Integrations page

1. It opens the Integration purpose pop-up which asks whether to use this integration for employee sync and/or payroll sync.

Note: Do not select the employee sync checkbox if you will be integrating and HCM where your employees are stored.

1. Add the credentials and deduction to the form.
2. The Service Endpoint URL, Tenant ID, User API key, Customer API key can be found in the steps 1.1 (1.1 - Finding your API connection credential) of this guide.
3. The Service account user name and Service account password can be found in the steps 1.2 (1.2 - Adding a new service account) of this guide.
4. The Deduction code can be found in the step 2.1 (2.1 Adding a deduction group) of this guide

1. Select “Connect Integration” to establish the connection You are all set! Your integration will now update once every 15 minutes to pull upcoming payrolls into Toku