# Client Admin Portal

The Client Admin Portal allows you to do Admin Tasks such as:

* Create/Modify Virtual Terminal Users&#x20;
* Create/Inspect API Tokens&#x20;
* View Transaction Details
* View Card On File Details

#### Client Admin Portal Modes of Operation

**Merchant/Single Account Admin**

This type of access is provided if you are responsible for a single account. You have unlimited access to create Users and API Tokens. You have full access to all reports. &#x20;

***

**Integrator / Multi Account Admin**

This type of access is granted to Integrators who must process transactions for multiple accounts. You can Create API Tokens , but NOT Virtual Terminal Users. You have Read-Only access to reports.

## Single Sign-On (SSO)

Single Sign-On (SSO) is integrated between the Client Admin Portal and the Virtual Terminal (VT). Client admin credentials allow users to log in to the Virtual Terminal without needing a separate set of VT credentials.

When you receive your client admin credentials, it is recommended that you log in to the Client Admin Portal and change your temporary password to a permanent one. After the one-time password has been changed, the same credentials can be used to access the Virtual Terminal.&#x20;

{% hint style="info" %}
Note: SSO is only available for single-account logins and is not supported for multi-user integrator accounts.&#x20;
{% endhint %}

## Integrator token renewal

{% hint style="info" %}
API tokens are automatically renewed if both of the following conditions are met:

1. The credentials have been successfully authenticated within the last month.
2. The token is set to expire within the next month and has not yet expired.
   {% endhint %}

Once you log in, you'll see a menu on the left with a *Token Renewal* heading.

The Token Renewal function allows you to select the accounts for which to issue new tokens. It also provides a summary including the total number of active tokens assigned to each account. Select the account(s) you wish to renew, then click Next.

<figure><img src="https://855896703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4UWkWFnnmVPzvJTdMtC0%2Fuploads%2FoEq4spMeoVLwbOykqrUN%2Ftokenrenew1.png?alt=media&#x26;token=390c676e-6d5c-4157-bf83-e55316b7954a" alt=""><figcaption></figcaption></figure>

After selecting the accounts you wish to renew, you will see a summary with new token information. At this point you can either copy the new token or proceed to the next step for automated processing at your url.

<figure><img src="https://855896703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4UWkWFnnmVPzvJTdMtC0%2Fuploads%2FeVQeW5UBq8DMMPt0NFVw%2Ftokenrenew2.png?alt=media&#x26;token=821e38b6-7997-4d27-9b89-50ce83cfa531" alt=""><figcaption></figcaption></figure>

### Posting the token JSON data to your webhook URL

<figure><img src="https://855896703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4UWkWFnnmVPzvJTdMtC0%2Fuploads%2FiIwUBk71dnsX7kmSJfls%2Ftokenrenew3.png?alt=media&#x26;token=86769b62-419e-448c-91e9-f6cf5a561ddc" alt=""><figcaption></figcaption></figure>

We will create a JSON array named *TOKENS* and send it directly to the URL you specify. You can obtain this data by accessing the InputStream at your server endpoint.

When you select `POST JSON`, we will create a JSON array named *TOKENS* and send it directly to the URL you specify. You can obtain this data by accessing the InputStream at your server endpoint.

{% tabs %}
{% tab title="C#" %}

```csharp
string json;
using (var reader = new StreamReader(Request.InputStream))
{
    json = reader.ReadToEnd();
}
```

{% endtab %}
{% endtabs %}

{% code title="JSON array example" overflow="wrap" %}

```json
"Tokens": [{"TokenID":"8961", "AccountCode":"EP8179234", "Token":"AB87E1D81559466E9165FCDA2B5B12C3", "AccountName":"CY FD TEST", "ExpirationDate":"11/22/2026 1:59:54 PM"}, {"TokenID":"8962", "AccountCode":"EP1519128", "Token":"EDB6D3FC1DE44A5C883BC718350C40BC", "AccountName":"CY TSYS TEST", "ExpirationDate":"11/22/2026 1:59:54 PM"}]
```

{% endcode %}

<figure><img src="https://855896703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4UWkWFnnmVPzvJTdMtC0%2Fuploads%2FY182JrXQqKA4CXUQt8oi%2Ftokenrenew4.png?alt=media&#x26;token=6af60d4f-df9b-413f-9ebf-9fc366470b66" alt=""><figcaption></figcaption></figure>

## Manage Fees

To manage a Merchant's Fees, click on the *Manage Fees* link. Acknowledge the Disclaimer to view the list of Merchants.

<figure><img src="https://855896703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4UWkWFnnmVPzvJTdMtC0%2Fuploads%2FU34q8StiCxJhaKrdqFjd%2Fmanagefees2.png?alt=media&#x26;token=0ed98520-870e-4e46-b1e3-2fe60693c6b4" alt=""><figcaption></figcaption></figure>

Click the go link next to a respective merchant to get to the edit screen, where you can edit fee type, rate, cards allowed and notations.

<figure><img src="https://855896703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4UWkWFnnmVPzvJTdMtC0%2Fuploads%2FlyfHKeETFSOBMC4eYSO9%2Fmanagefees3.png?alt=media&#x26;token=f31b3c66-6787-42f2-95ad-b085b94e693e" alt=""><figcaption></figcaption></figure>

## Reports

(Transactions, ACH Transactions, Cards on File, ACH on File)

Once you log in, you'll see a menu on the left with a *Reports* heading. Expand this to see all the subheadings. All pages in this section function the same way.

<figure><img src="https://855896703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4UWkWFnnmVPzvJTdMtC0%2Fuploads%2FX1rgd0CMCjs3b77Mk5sE%2Ftransactions1.png?alt=media&#x26;token=c5e4be0b-b7b7-43fe-a7a1-a48c7eacec8a" alt=""><figcaption></figcaption></figure>

These pages allow you to filter all transactions (or COF) by date, txstatus,txtype and search by various field types. After adjusting your criteria, press the *Refresh Data* button to see the applicable reports.

<figure><img src="https://855896703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4UWkWFnnmVPzvJTdMtC0%2Fuploads%2FUtgw4DCmSqwGYXfy1pcn%2Ftransactions2.png?alt=media&#x26;token=cb07202e-51ac-4ae1-a518-969f727dfbaf" alt=""><figcaption></figcaption></figure>

After finding the transaction or COF desired, you can click on the *Details* link to see the in depth information.

<figure><img src="https://855896703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4UWkWFnnmVPzvJTdMtC0%2Fuploads%2FsLHWqeaaPaTElOHbNPq1%2Ftransactions3.png?alt=media&#x26;token=6199ecd8-3803-4c5f-8edb-46422fd03405" alt=""><figcaption></figcaption></figure>
