Atrium is a payment system designed for campus. This document will provide you with instructions for configuring Atrium on server, covering TID verification and location configuration.
TID Verification
Operators must register the TIDs (fixed-length codes formatted as UVID+SRC+ROOM#+MACHINE_NUMBER, e.g., 80000nick016001020) in the Atrium server — failure to synchronize these IDs will block transactions.
The total TID count must exactly match the physical reader quantity.
Campus Solution Configuration in Locations
In Locations→ Edit Location, when you click on the tab “Campus Solution,” the “Supported Campus Solution” field will be shown. Click the drop-down list and select “Atrium”.
Enable the “Atrium Account” and the corresponding fields will be displayed. You can refer to tables below to see the detailed description and hover over the help bubbles of the fields to view the description.
|
|
Field Name | Value Needed | Description |
Atrium API URL | Alpha-Numeric | You can set up the “atrium_api_url” here. |
Atrium Merchant Key | Alpha-numeric | Defines campus-specific Atrium API Key used for Merchant verification. Merchant key can be obtained from Atrium or campus. This is a required field and it allows a maximum of 50 characters. |
Atrium Account | Radio button choice | Defines whether to enable Atrium wallet in the app. |
Atrium SSO URL | Alpha-Numeric | It is displayed when “Atrium Account” is enabled. It refers to campus-specific URL used for mobile app SSO login or Atrium card linking. Contact campus to get SSO URL. The fields allows a maximum of 200 characters. |
Atrium Account Alias | Alpha-Numeric | It is displayed when you enable the Atrium Account. You could customize the account name that will be displayed in the app. |
Campus ID Attribute Name | Alpha-Numeric | It is displayed when you enable the Atrium Account. You could rename the Campus ID with this field. Campus ID is essential for consumers to get while they login to the campus environment and send requests to Atrium for linking the Atrium Card. |
Atrium Card | Radio button choice | Defines whether to allow the payment option to use Atrium cards. You can disable this option. |
KioSoft Account | Radio button choice | Defines whether to display the payment account of CleanPay in the app. |
KioSoft Account Alias | Alpha-Numeric | You could customize the account name which will be displayed in the app wallet. |
Click “Save” button to save the settings.

