Instructions for Use

The Client Portal is a web portal for users of Comgate's payment services. It provides a complete overview of all payments made through the payment gateway or payment terminal, their settings, etc.

In the Client Portal you can:

• Display transactions for a selected period of time
• Check the payment status
• Trace billing
• Analyze and export data
• Manage and add users, who can see different types of information about your business
• Make technical settings

The Client Portal is divided into three sections: 

1. Payments
2. Integrations 
3. Contacts

Payments

In the Payments section you can find an overview of all payments and refunds, bank transfers, monthly billing and any claims. In addition, there is the option to manually set up a payment.

New payment

You can generate a new payment link under Payment > New payment

After entering the name of the shop, amount, currency, payer's e-mail and customer ID a payment link will be generated. You can copy it and send it to the customer. You will be informed of successful payment via email or API protocol.

Payments generated in the Client Portal can be found in the Customer payments tab under Setting up payment > Client portal.

The payment link can be used when the customer places an order outside the e-shop environment (e.g. by email or telephone) or when modifying an order already placed.

Customer payments

An overview of all transactions can be found in the Customer Payments section. To find specific payments, you can filter them by the following identifiers:

• Time period - allows you to choose the time interval, in which the payment was made.
• Status
  • Expected - the payment has not been made, do not deliver goods or service yet.
  • Unpaid - the payment has been cancelled or denied, do not deliver the goods
  • Paid - the payment is confirmed, you can deliver the goods
  • Transferred - the payment has been made and sent to your bank account
  • Preauthorized - the payment amount is blocked on the payer's account
• Terminal ID - the number under which the terminal is registered. You can find it on the receipt. Meal voucher companies also provide it together with the MID (Merchant ID) for the meal vouchers activation. This ID will be required for any communication with us. 
• Refunds - refunded payments
• Cancellations - payments cancelled by the e-shop or by the customer
• Created payment - payments set up by the e-shop via API protocol or manually in the Client Portal.
• Comgate ID - unique 12-digit code for every transaction, which you can use for payment verification.
• Client ID - this can be the e-shop order number, invoice number or e-shop's variable symbol, whatever you choose. This ID is sent via API in the refld parameter.
• Payment VS - the variable symbol of the transaction generated by the payment gateway
• Label - short product description. It is the same as the API documentation's "label" parameter
• Method - shows the payment method used for payment: Card online, Bank transfer, Deferred payment, Payment in three instalments, Instalment sale, Not specified.
• Currency - can be filtered only if payment in multiple currencies is set up.
• Amount
• Payer´s email
  

On the left above the individual transactions, you can download a list with the transactions displayed according to the specified filter.

Each transaction row offers options on the right to view the payment detail, perform a refund or generate a payment link for the transaction to send to the customer.

Refunds

A refund is a return of the amount paid by the customer through a payment gateway or payment terminal in full or in part. Under this tab you will find a complete list of refunds entered, which can be filtered similarly to customer payments.

Refund status:

• Awaiting payment confirmation – occurs when a refund request has been entered for a payment in the Pending status. This payment must first go to the Paid status in order for the refund to be processed. 
• Awaiting sufficient funds – the payment gateway does not currently register a sufficient amount of incoming transactions (in the amount of the refund). The refund will be made when sufficient transactions have taken place.

• Pending – the request has been forwarded to the card processor.
• In progress – the card processor has accepted the request. The refund has not been executed yet.
• Executed – the card processor has confirmed that the money will be sent back to the payer.
• Canceled – the refund has been canceled at the Merchant's request, or the 14 business day limit for the refund has expired.
• Refused – the refund has been refused by the issuing bank.
  

Transfers to a bank account

Overview of the daily bulk transfers to your bank account. If you are using the payment gateway in multiple currencies, every currency is transferred separately. The same applies to funds from the payment terminals – they are transferred to you separately. When you click on the individual lines, you will see a list of all transactions included in the given transfer. You can download daily statements in CSV, ABO and PDF format.

Billing

In Billing tab, you can locate monthly breakdown of transfers to your bank account – in PDF, CSV and ABO format. Monthly billing in PDF consists of payment transfers to customers for the specific month. CSV and ABO files include specific individual customers' payments, too. 

If you pay transaction fees and monthly fees by invoice, you can also find an overview of invoices for every currency separately.

Claims

In the Claims tab, you will find any unpaid monthly fees. The monthly fee for payment gateway administration is automatically deducted from incoming transactions. If the tab is empty, you have paid all your fees.

Integration

The Integration section contains the Store Settings, User Management and Test Payments tabs.

Store Settings

In Store Settings, all allowed payment methods are displayed. You can set the payment expiration and change your contact details. You will also find the details for linking the payment gateway. If you are a Shoptet user, you can change payment statuses here.

Payment methods

Here you can set up payment expiration and dynamic payment expiration.

You can also find an overview of the bank accounts defined for permitted currencies and an overview of payment methods available in your e-shop.

Contact information

Here you set up email addresses for the continuous sending of payment information, an email for receiving error messages in payment gateway and e-shop connection, and email for bulk payment statements. In addition to email communication, we provide information about payment transactions via the API protocol.

Store connection

In Store interconnection, you can set up the parameters for communication via the API protocol. You can find the store connection identifier, password, return URL and permitted IP addresses here. If you use one of the supported e-shop platforms, the input method will be individual according to your provider.

User Management

An unlimited number of users can access the Client Portal. New users can be added under Integration > User Management. When creating a new user, you have to enter their name, email address and assign one (or more) of the following roles to them:

• Organization administrator – access to all sections (except test logs and store connection), ability to create more users
• User – access to all sections  (except test logs and store connection), cannot add a new user
• Tester – access only to payment gateway connection editing and ability to view the technical documentation
• Payment refund – access to payments and summary of entered refunds

Testing

Set the "test" parameter to "true" when you create a payment for testing purposes. The payer is then not redirected to any of the participating banks. A virtual provider (bank) is available for testing the payment or non-payment. In the client portal you will also find test payment statements, e-shop connection settings and communication logs.

Test payments

In the section Integration > Testing > Test payments you will find an overview of all payments that were made during the testing of the payment gateway but were not actually debited from the bank account.

For payments in PAID and PENDING statuses, check whether the communication statement contains at least 4 records, i.e. 2 records for payment creation (REQUEST and RESPONSE) and 2 records for payment status verification (REQUEST and RESPONSE). If it does not contain them, it means that the e-shop does not verify the payment status. You can use the button in the payment detail to simulate the payment transition from PENDING to PAID or CANCELLED.

Test logs

In the case of a wrongly set up test payment, you will find a full list of error messages (error logs) - e.g. unaccepted payment status, setting up payments via unauthorized methods, setting up payments from an unauthorized IP address, etc.

Contacts

Comgate contact details and your company contacts are listed in the Contacts section. This includes the contact person, company name, company ID, registered office address, billing address, phone and email. Should any of the details change, please contact customer support to request a change.