CBORD payment authentication system is integrated with the KioSoft mobile app system. Follow the steps below to enable CBORD for a location and make a payment on CleanPay mobile with a CBORD account.
1. Enable CBORD for a Location
1. Go to Vendor Portal → Location Management to create a new location or edit an existing location. |
|
2. Select "CBORD" in Campus Solution. |
|
3. Input the parameters below and click the "Save" button. Restrict to CBORD SSO Login: To enable or disable the CBORD SSO Login restriction (“Disable” by default). When it’s enabled, the CleanPay Mobile app will only display the CBORD SSO Login Page when registering or logging in to the app. When it’s disabled, the KioSoft Login Page will be displayed first when registering or logging in to the app, and tapping the “CBORD SSO” button can log in via CBORD account. CBORD Alias: Text field, Default value: CBORD. It gives a name to the CBORD system used at the property that consumers identify with. Institution: Smart-drop list. Operators can search the institution by entering some characters and selecting "Clear Selection" to change to another institution. Terminal ID/Store ID: Text field. It is a UGryd-specific terminal ID that will be in the inputs but can be used to separate readers, etc. Cashless location number: Text field. It will be provided by Campus. It is the Cashless Terminal specific to the CBORD Gold or Odyssey systems. KioSoft Account: To enable or disable the KioSoft account that will be displayed on the CleanPay Mobile Homepage. |
|
2. Configure CBORD API
All four parameters should be provided by CBORD. API URL: text field. Subject ID/Key Identifier: text field. Application Client ID: text field. Private Key: text field. |
|
3. Log in to CleanPay with SSO
Students on campuses can use their university credentials such as username/email and password to sign in to the CleanPay mobile app, which is authenticated via SSO.
There are two login methods: Direct Authentication & External Authentication.
3.1 Direct Authentication
|
|
|
|
| Note: If the email exists in the KioSoft database, the server will add a nonce to the original CBORD email address to create a new KioSoft account. In this method, students can log in to the KioSoft account using their email address and CBORD account password. |
|
|
3.2 External Authentication
|
|
|
|
|
Note: In this method, students must log in to their KioSoft account by selecting "Forget PW" on the Sign In page. |
|
|
If the KioSoft account is disabled on the server, the APP will only show the CBORD wallet.
|
When using the CBORD wallet, features including Refill, Edit Credit Card, Request Refund, Manage Sub Account, Close Account, and Select Main Account are not supported.
Use KioSoft Account | Use CBORD Account |
|
|
4. App Payment with CBORD
Please follow the steps below to pay with CleanPay Mobile using a CBORD account.
|
|
|
|
|
If the App loses BT (Bluetooth) connection with readers, the App will prompt a toast "Connection Lost". If the App interacts with an offline reader, the APP will prompt "Reader not available to accept payment". The deducted money will be refunded to your balance if the machine fails to start. |
|
|
Note: There is no “Request Refund” option in the transaction details of the CBORD wallet. |
|
|
|



















