Create a SandboxContact UsKnowledge Base
Search
⌃K
Links

Merchant Portal

Overview

The Cardknox Merchant Portal is a revolutionary, user-friendly online platform for seamless management of Cardknox payment processing accounts. The intuitive and fluid interface features user-friendly, robust tools for:
  • Payment processing
  • Report creation
  • Batch and transaction history and filtering
  • Customer profile management
  • Email invoicing
  • PaymentSITE customization
  • Key management
  • Recurring payment schedules
  • User management
  • Payment processing
  • Report creation
  • Batch and transaction history and filtering
  • Customer profile management
  • Email invoicing
  • PaymentSITE customization
  • Key management
  • Recurring payment schedules
  • User management
The Cardknox Development Team is continually adding new features and functionalities to further enhance the user experience.
This guide describes the main features of the Cardknox Merchant Portal. It contains information about features within the application with relevant screenshots, field descriptions, and procedures for managing your transactions and customer information.
Don’t yet have an account? Visit portal.cardknox.com/register.

Logging In

When you sign in to the Cardknox Merchant Portal, the application opens with the Welcome to Cardknox Portal screen and displays your company’s Dashboard. The Dashboard gives you a quick overview of what’s happening with your business and contains the most important data from the features you currently use.
Use the menu tabs on the left side of the welcome screen to navigate through the application and take action on your transaction data.
Tips:
  • After 30 minutes of inactivity on any tab, the application closes. If you close your browser, the system clears your session after 15 minutes, and if you open a new browser window, you must log in again.
  • You can click the Collapse Menu button to collapse the menu bar at the left-hand side of any page, giving you more room to view data. Click the button again to expand the menu bar.
​

Dashboard

The Dashboard tab displays business information in a graphical format. The previous day’s data is displayed by default. Interactive graphics give you an at-a-glance view of your company’s current financial details all on one screen to help you spot trends and monitor activity. You’ll be able to see a breakdown of transaction types, counts, and amounts. See the item description table below for more information on these features.
Tips:
  • The Customers and Recurring Schedules modules are not included in the Cardknox Starter plan. To upgrade to the Standard plan, which includes access to these modules, click on either Customers or Recurring Schedules on the navigation menu.
Dashboard Tab Item Descriptions
Item
Description
Gateway status
Displays a message about the status of an event such as a system outage.
Notifications button
Click this button to display notification messages.
​
Item
Description
Account Name
Displays the name of the account.
Click the arrow to open a list of your accounts.
Type your search criteria in the search field or click an option in the list.
​
Item
Description
User button
Displays your account’s email address.
​
​
Click this button or arrow to log out of the Cardknox Portal.
Calendar button
Click this button and choose a day from the list, or select Custom from the list and enter a date range on the calendar and click Apply to display graphical images of the features you currently use.If you choose Custom, the following edits are in place:The date you enter cannot exceed 7 days from today’s dateYou must enter a valid date range (i.e., 2018 to 2019, not 2019 to 2018).
New Transaction
Allows you to create a new transaction
Gross revenue
Displays a graph showing sales, credit, and totals information for the date you select.
Hover your pointer over a point on the graph to view monetary details by time and date.
Transaction activity
Displays the calculated sales, credit, total, and average transaction amounts for the date you select.
Sales Summary
Displays sales summary information by product.
Hover your pointer over the graphic to view total transaction count and amount information.
Credit Summary
Displays credit summary information by product.
Hover your pointer over the graphic to view total transaction count and amount information.
Dashboard
Displays your company’s main Dashboard based on the features you select to view.
Transactions
Allows you to view or take action on existing transactions.
New +
Allows you to create a new transaction
Send Payment Request
Allows you to send a payment request link to your customers.
Quick Reports
Allows you to view or take action on reports.
Gift Report
Allows you to view or take action on gift reports.
Batches
Allows you to view or take action on batches.
Note: If your account does not support batches, this tab is not visible.
Customers
Allows you to view or take action on customer records.
New +
Allows you to create a new customer.
Recurring Schedules
Allows you to view or take action on recurring payment schedules.
Company latest news
Click this link to access the Cardknox Newsroom page to read the latest press releases and news articles.
Settings
Allows you to modify selected portal settings.
Help
Click this link to expand the Help menu.
Contact us
Click this link to find information about how to contact us for merchant and partner sales information, software integration, and technical support.
FAQ
Click this link to access the Cardknox FAQ page.
User Guide
Click this link to access the Cardknox Merchant Portal User Guide documentation.
Remote Support
Click this link to access the Cardknox online support and collaboration portal.
Dashboard Tab Item Descriptions
Item
Description
Gateway status
Displays a message about the status of an event such as a system outage.
Notifications button
Click this button to display notification messages.
​
Item
Description
Account Name
Displays the name of the account.
Click the arrow to open a list of your accounts.
Type your search criteria in the search field or click an option in the list.
​
Item
Description
User button
Displays your account’s email address.
​
​
Click this button or arrow to log out of the Cardknox Portal.
Calendar button
Click this button and choose a day from the list, or select Custom from the list and enter a date range on the calendar and click Apply to display graphical images of the features you currently use.If you choose Custom, the following edits are in place:The date you enter cannot exceed 7 days from today’s dateYou must enter a valid date range (i.e., 2018 to 2019, not 2019 to 2018).
New Transaction
Allows you to create a new transaction
Gross revenue
Displays a graph showing sales, credit, and totals information for the date you select.
Hover your pointer over a point on the graph to view monetary details by time and date.
Transaction activity
Displays the calculated sales, credit, total, and average transaction amounts for the date you select.
Sales Summary
Displays sales summary information by product.
Hover your pointer over the graphic to view total transaction count and amount information.
Credit Summary
Displays credit summary information by product.
Hover your pointer over the graphic to view total transaction count and amount information.
Dashboard
Displays your company’s main Dashboard based on the features you select to view.
Transactions
Allows you to view or take action on existing transactions.
New +
Allows you to create a new transaction
Send Payment Request
Allows you to send a payment request link to your customers.
Quick Reports
Allows you to view or take action on reports.
Gift Report
Allows you to view or take action on gift reports.
Batches
Allows you to view or take action on batches.
Note: If your account does not support batches, this tab is not visible.
Customers
Allows you to view or take action on customer records.
New +
Allows you to create a new customer.
Recurring Schedules
Allows you to view or take action on recurring payment schedules.
Company latest news
Click this link to access the Cardknox Newsroom page to read the latest press releases and news articles.
Settings
Allows you to modify selected portal settings.
Help
Click this link to expand the Help menu.
Contact us
Click this link to find information about how to contact us for merchant and partner sales information, software integration, and technical support.
FAQ
Click this link to access the Cardknox FAQ page.
User Guide
Click this link to access the Cardknox Merchant Portal User Guide documentation.
Remote Support
Click this link to access the Cardknox online support and collaboration portal.
Dashboard Tab Item Descriptions
Item
Description
Gateway status
Displays a message about the status of an event such as a system outage.
Notifications button
Click this button to display notification messages.
​
Item
Description
Account Name
Displays the name of the account.
Click the arrow to open a list of your accounts.
Type your search criteria in the search field or click an option in the list.
​
Item
Description
User button
Displays your account’s email address.
​
​
Click this button or arrow to log out of the Cardknox Portal.
Calendar button
Click this button and choose a day from the list, or select Custom from the list and enter a date range on the calendar and click Apply to display graphical images of the features you currently use.If you choose Custom, the following edits are in place:The date you enter cannot exceed 7 days from today’s dateYou must enter a valid date range (i.e., 2018 to 2019, not 2019 to 2018).
New Transaction
Allows you to create a new transaction
Gross revenue
Displays a graph showing sales, credit, and totals information for the date you select.
Hover your pointer over a point on the graph to view monetary details by time and date.
Transaction activity
Displays the calculated sales, credit, total, and average transaction amounts for the date you select.
Sales Summary
Displays sales summary information by product.
Hover your pointer over the graphic to view total transaction count and amount information.
Credit Summary
Displays credit summary information by product.
Hover your pointer over the graphic to view total transaction count and amount information.
Dashboard
Displays your company’s main Dashboard based on the features you select to view.
Transactions
Allows you to view or take action on existing transactions.
New +
Allows you to create a new transaction
Send Payment Request
Allows you to send a payment request link to your customers.
Quick Reports
Allows you to view or take action on reports.
Gift Report
Allows you to view or take action on gift reports.
Batches
Allows you to view or take action on batches.
Note: If your account does not support batches, this tab is not visible.
Customers
Allows you to view or take action on customer records.
New +
Allows you to create a new customer.
Recurring Schedules
Allows you to view or take action on recurring payment schedules.
Company latest news
Click this link to access the Cardknox Newsroom page to read the latest press releases and news articles.
Settings
Allows you to modify selected portal settings.
Help
Click this link to expand the Help menu.
Contact us
Click this link to find information about how to contact us for merchant and partner sales information, software integration, and technical support.
FAQ
Click this link to access the Cardknox FAQ page.
User Guide
Click this link to access the Cardknox Merchant Portal User Guide documentation.
Remote Support
Click this link to access the Cardknox online support and collaboration portal.

Transactions

The Transactions tab provides a quick overview of your existing transactions and enables you to view and manage all your transaction data from one page.
By default, the Transactions tab opens with the last 7 days of transaction records displayed. Click on “Last 7 Days” to select a different time period or define a custom time period.
At the top of each column, you can type in criteria text to filter the transaction data. For example, to see only transactions for April 3, 2020, type in 04/03/2020 in the text field at the top of the Date column.
Upon clicking a transaction reference number, you can view all transaction information— including the transaction date and time, amount, cardholder’s name, payment card account number and card type, approval status, transaction type, and a description of the transaction.
On the Transactions tab, you can perform the following actions:
  • Process a new transaction
  • Schedule a transaction for later processing
  • Search for a transaction
  • Export a transaction
  • Modify a transaction
  • Apply voids and refunds
  • Link a transaction to a customer
Tips:
  • The Transactions tab opens with the last 7 days of data displayed by default.
  • Enter search criteria in the fields next to the column headings to search for a transaction.
  • Click the arrow to the right of any column heading to sort the column.
  • Click the arrow to the left of any row to expand the row and display transaction detail information.
  • Certain column headings display a screen tip when you hover your mouse over the column name.
  • Click between column headers to select and resize any column.
  • Customize your page view by selecting the columns you want to appear by default.
Note: Only a partial screen sample is displayed below. All fields are documented in the following item description table.

Expanded Search Features

Certain fields include drop-down menus you can use to narrow the results of your display settings. For example, the Card Type field menu displays a list of available card types. Click the arrow in the column headings for the following fields to open a menu with more search options:
  • Card Type
  • Command
  • Currency
  • Entry Method
  • Payment Method
  • Result
  • 3D Secure Result
Transactions Tab Item Descriptions
Calendar Button
  • Click the calendar button and choose an option from the list. Valid values are as follows:
    • Yesterday
    • Today
    • Last 7 Days
    • Last 30 Days
    • Last 60 Days
    • Last 90 Days
    • Custom
    If you choose Custom, the system opens a calendar you can use to select a date range and a time range. The following edits are in place:
    • The date you enter cannot exceed 7 days from today’s date
    • You must enter a valid date range (i.e., 2018 to 2019, not 2019 to 2018)
    • You can display up to 100 days of data
    • You cannot select dates in the future
    The system displays an error message if you enter an invalid date or date range.Select a date range in the calendar fields, select a time range in the From and To fields, and click Apply.
Filter
  • Click this button to select filter criteria (such as card number or status).
  • Click which filter to use, and type in the criteria in the text box that is displayed:
  • Click the right arrow (or press the Enter key) to apply the filter right away, or you can choose more criteria from the dropdown. To see more filters, click + Advanced.
Tip: To always display the Advanced filters, select the Always Expand checkbox.
  • Click Reset all to clear all selected filters in the Filters list. Click Done to close the dropdown and save your changes.
Reset Filter
  • Click this link to reset all filters.
  • When you click Reset filter, the system:
    • Clears all selected filters in the Filters list
    • Clears all selected options in the Settings button Available Columns list and reverts to the default column page view
New Transaction
  • Click this button to open the Add new transaction dialog box and create a new transaction
Download Button
  • Click this button to choose whether to export the current view or all transactions in CSV or Quickbooks format.
Print
  • Click this button to print a transaction report.
  • Select Current view (PDF) to open a dialog box and print a report of the current view.
  • Select All transactions (PDF) to open a dialog box and print a report of all transactions.
Settings Button
  • Click the gear icon to change the transactions columns that are displayed while you are logged in to Cardknox. The columns you select from here are also reflected if you download a report from this screen.
  • On the dropdown, under Available Columns, select the columns you want to appear on the transactions list. Click Done to save your changes.
  • To Search for Available Columns, enter the column name in the search bar.
    ​
Note: If you click Reset filter, Cardknox clears all selected options in the Available Columns list and reverts to the default column page view.
To change the columns that are always displayed on this tab:
  1. 1.
    Click Settings. Cardknox opens Report Settings with the Transaction Report displayed.
  2. 2.
    In the Fields Configuration section, under the Show in Report section, you can select the columns you want to appear on the transactions list.
  3. 3.
    Click Save. The columns you selected are saved as the default view.
​
Refresh Results
​
 Click the refresh icon to update the results shown without reloading the page.
​
Show/hide Button
  • Click the right arrow to show the date range or click the down arrow to hide the date range
​
Load More
  • Displays options to select the number of transactions to display on the page.
    Valid options are as follows:
    • 50
    • 100
    • 500
    • 1000
    • All
Total Approved
  • Displays the count and total amount of all Approved and Auth-only transactions on the current page in the currency you select.
Count
  • Displays the number of transactions in the current page
Total by Card
  • Click this link to open the Total by Card dialog box and view the total amount and count of Approved transactions by card type.
  • Click the Download button to export the current view in CSV format.

Display Transaction Details

You can view transaction details by clicking on a transaction row. This expands the view and opens the details section on the right-hand side of the screen.
To close the transaction details, click the X icon in the upper right corner.
In the upper right, action buttons let you print, email, download, and view a transaction receipt:
Below the transaction details, you can use the buttons to perform other actions, like void or refund the transaction:
Complete the fields as described in the following table to view transaction details or take action on the transaction.
Transactions Details Item Descriptions
Action Buttons on Transaction Detail
Transaction Information
Displays the status of the transaction.
Below Transaction Information is four collapsible sections:
​
  • General Information
  • Billing Information
  • Shipping Information
  • Additional Information
You can expand and close the sections by clicking the * and * arrows to the left of the section name. You can also click and directly above General Information).
General Information
Displays the following information:
  • Amount – Amount of the transaction
    Transaction Type – AuthOnly, Capture, Sale, Save
  • Payment Type – Credit card or check
  • Invoice – Invoice number
  • Account Number – Last 4 digits of the account number. Click the account number link to see all transactions associated with this credit card number.
  • Entered Date – Date and time the transaction was entered
  • AVS – AVS Street and AVS Zip details
  • Custom fields (if any)
Billing Information
  • Name – The payee’s first and last name.
    Company – Click the company name link to see all transactions associated with this company.
    Phone number –The payee’s phone number.
Shipping Information
  • Name
    City, State, and Zip
Additional Information
Transaction details
Issuing Bank Information
Cardknox displays the issuing bank name and other information (if available).
This section displays if you have selected the Include Issuing Bank Details in Transaction Details checkbox (Settings > Transactions > Other Settings).
Printer Button
  • Click the printer button to open a dialog box and print the transaction receipt. The transaction receipt contains includes the following information:
  • Receipt Header Information:
    • Company name
    • Company address
    • Company phone number
  • Processing Information:
    • Amount
    • Date
    • Transaction type
    • Status
    Card Information:
    • Card type
    • Card expiration
    • Card number
    • Cardholder name
    Additional Information:
    • Entry method
    • Payment method
    • Reference number
    • Payment type
    • Authorization code
    Signature:
    • Customer signature line
Email Button
  • Click the Email Button to open a dialog box
  • Cardknox populates the Email field with the customer’s email address from their billing information. You can change this to a different address by typing in the Email field.
  • Click the Send button and Cardknox immediately sends the transaction receipt as an email to the customer.
Download Button
  • Click this button to export the transaction in CSV format.
View Button
  • Click this button to view additional details of the transaction
Add Button
  • This button allows you to add a new transaction
Add Profile Button
  • This button allows you to attack a profile to a particular transaction
Void Button
  • This button allows you to void any transaction (including EBT Online)
Refund Button
  • Use this button to refund any transaction (including EBT Online)
Edit Button
  • Use this button to edit the details of a transaction
Transactions Details Item Descriptions
Action Buttons on Transaction Detail
Transaction Information
Displays the status of the transaction.
Below Transaction Information is four collapsible sections:
​
  • General Information
  • Billing Information
  • Shipping Information
  • Additional Information
You can expand and close the sections by clicking the * and * arrows to the left of the section name. You can also click and directly above General Information).
General Information
Displays the following information:
  • Amount – Amount of the transaction
    Transaction Type – AuthOnly, Capture, Sale, Save
  • Payment Type – Credit card or check
  • Invoice – Invoice number(s)
  • Account Number – Last 4 digits of the account number. Click the account number link to see all transactions associated with this credit card number.
  • Entered Date – Date and time the transaction was entered
  • AVS – AVS Street and AVS Zip details
  • Custom fields (if any)
Billing Information
  • Name – The payee’s first and last name.
    Company – Click the company name link to see all transactions associated with this company.
    Phone number –The payee’s phone number.
Shipping Information
  • Name
    City, State, and Zip
Additional Information
Transaction details
Issuing Bank Information
Cardknox displays the issuing bank name and other information (if available).
This section displays if you have selected the Include Issuing Bank Details in Transaction Details checkbox (Settings > Transactions > Other Settings).
Printer Button
  • Click the printer button to open a dialog box and print the transaction receipt. The transaction receipt contains includes the following information:
  • Receipt Header Information:
    • Company name
    • Company address
    • Company phone number
  • Processing Information:
    • Amount
    • Date
    • Transaction type
    • Status
    Card Information:
    • Card type
    • Card expiration
    • Card number
    • Cardholder name
    Additional Information:
    • Entry method
    • Payment method
    • Reference number
    • Payment type
    • Authorization code
    Signature:
    • Customer signature line
Email Button
  • Click the Email Button to open a dialog box
  • Cardknox populates the Email field with the customer’s email address from their billing information. You can change this to a different address by typing in the Email field.
  • Click the Send button and Cardknox immediately sends the transaction receipt as an email to the customer.
Download Button
  • Click this button to export the transaction in CSV format.
View Button
  • Click this button to view additional details of the transaction
Add Button
  • This button allows you to add a new transaction
Add Profile Button
  • This button allows you to attack a profile to a particular transaction
Void Button
  • This button allows you to void any transaction (including EBT Online)
Refund Button
  • Use this button to refund any transaction (including EBT Online)
Edit Button
  • Use this button to edit the details of a transaction
Transactions Details Item Descriptions
Action Buttons on Transaction Detail
Transaction Information
Displays the status of the transaction.
Below Transaction Information is four collapsible sections:
​
  • General Information
  • Billing Information
  • Shipping Information
  • Additional Information
You can expand and close the sections by clicking the * and * arrows to the left of the section name. You can also click and directly above General Information).
General Information
Displays the following information:
  • Amount – Amount of the transaction
  • Authorization Amount - Amount authorized for the transaction
  • Transaction Type – AuthOnly, Capture, Sale, Save
  • Payment Type – Credit card or check
  • Invoice – Invoice number(s)
  • Account Number – Last 4 digits of the account number. Click the account number link to see all transactions associated with this credit card number.
  • Entered Date – Date and time the transaction was entered
  • AVS – AVS Street and AVS Zip details
  • Custom fields (if any)
Billing Information
  • Name – The payee’s first and last name.
    Company – Click the company name link to see all transactions associated with this company.
    Phone number –The payee’s phone number.
Shipping Information
Name, City, State, and Zip
Additional Information
Transaction details
Issuing Bank Information
Cardknox displays the issuing bank name and other information (if available).
​
This section displays if you have selected the Include Issuing Bank Details in Transaction Details checkbox (Settings > Transactions > Other Settings).
Printer Button
  • Click the printer button to open a dialog box and print the transaction receipt. The transaction receipt contains includes the following information:
  • Receipt Header Information:
    • Company name
    • Company address
    • Company phone number
  • Processing Information:
    • Amount
    • Date
    • Transaction type
    • Status
    Card Information:
    • Card type
    • Card expiration
    • Card number
    • Cardholder name
    Additional Information:
    • Entry method
    • Payment method
    • Reference number
    • Payment type
    • Authorization code
    Signature:
    • Customer signature line
Email Button
  • Click the Email Button to open a dialog box
  • Cardknox populates the Email field with the customer’s email address from their billing information. You can change this to a different address by typing in the Email field.
  • Click the Send button and Cardknox immediately sends the transaction receipt as an email to the customer.
Download Button
  • Click this button to export the transaction in CSV format.
View Button
  • Click this button to view additional details of the transaction
​
  • The transaction receipt includes the following information:
    • Transaction reference number
    • Company name
    • Company address
    • Phone number
  • Transaction Information:
    • Amount
    • Billing information
    • Shipping information
    • Entered date
  • Transaction Detail:
    • Payment type
    • Transaction type
    • Card type
    • Transaction entry method
    • Card number
    • Card expiration
    • Ref # (reference number)
​
Add New Transaction
This button allows you to add a new transaction
Click this button to open the Add New Transaction dialog box and create a new transaction.
​
If a transaction errors due to a billing mismatch or some other error (excepting Duplicate Transaction or invalid AuthCode) you can use this button to recreate a new transaction off of the existing one
​

Add New Customer

When you click Add Customer, you’ll need to choose New Customer or Existing Customer.
You can add a new customer even on transactions that return an error.
Void
  • Click this button to open the Void dialog box.
Refund
Click this button to open the Refund dialog box.
​
​
​
Complete the fields to issue either a full or partial refund. Click Refund to process the refund, or click Cancel to clear the form and discard your changes.
A fully refunded transaction displays the badge REFUNDED.
A partially refunded transaction displays the badge PARTIALLY REFUNDED.
  • Hover your pointer over the Refunded badge to view a tooltip message showing the amount of the full or partial refund.