Frequently Asked Questions

ACCOUNTING

How to get an overview of all the transactions in Maksekeskus?

An overview of all the transactions and payouts is available at Maksekeskus merchant self-servive portal. If you do not have any access to the Merchant Portal or the password reset does not work, please let us know at support@maksekeskus.ee.

For a detailed view of all the transaction click on the “Transactions” section. Transactions can be sorted for example by date, time periods and types. For a time period, click on the Date field and choose a time period from the calendar window.

If you wish to get the best overview of all the transaction fees, monthly fees, payouts, and refunds click on the “Account statement”. There you can see transactions with related fees and VAT (if applicable).

You should download the “Account statement” report to your computer. The report has more detailed information (payment channel, account balances before and after payout etc). To download the overview, click on the Date field and choose a time period, for example “Previous month”. Then click on the “Save” button on the right and choose the XLS file type. You can open it in Excel, add filters and so on.

NB! Suggestion for accounting: think of Maksekeskus account as something not unlike your bank account. Then payouts from Maksekeskus account to your bank account are just movements between accounts. This way it is not important to match each and every payout with specific e-shop transactions which makes accounting much less labor intensive.

I need a monthly invoice for the fees

In the merchant self-service environment you can download the monthly invoices by going to “Billing”.  Invoice for the previous month is  uploaded by the second week of the following month.

If you’d like to have invoice automatically e-mailed to you then open the menu Settings and under that the contacts page of your company. You will find a separate Invoice e-mail field on that page.

Note that the invoices are only for your information and accounting purposes. You do not need to transfer us any money as Maksekeskus automatically deducts all the fees from your account.

How are the service fees calculated?

Service fees are calculated per each transaction.

Example: A client of the e-shop purchases a product of 10 EUR. If the pricing is 2,5% + 0,30EUR from every transaction then Maksekeskus calculates a transaction fee of (2.5%) 0.25 EUR + 0.30 EUR + value added tax 20% = 0.66 EUR and the rest of the sum (9.34 EUR ) is transferred to merchants bank account during next payout settlement.

Account statement xml file

The account statement xml file of Maksekeskuse is following the ISO 20022 camt.053 format.

Below we describe some specifics:

Relationship of an account movement record with a transaction/order in e-shop is carried by attribute EndToEndId,
in example: <EndToEndId>15178</EndToEndId>

Direction of the account movement (to the account vs from account) is carried by atrribute <CdtDbtInd>
in example: <CdtDbtInd>DBIT</CdtDbtInd> or <CdtDbtInd>CRDT</CdtDbtInd>

Type of the account movement is carried by ‘Ustrd’
nt: <Ustrd>INCOME</Ustrd>

There are following types:

  • INCOME – customer paid for the transaction
  • REFUND – money was returned to the customer (buyer)
  • TRX_FEE – Maksekeskus service fee for the transaction (% of transaction amount)
  • TRX_FEE_FIX -Maksekeskus service fee for the transaction (fixed amount)
  • TRX_FEE_MIN -Maksekeskus service fee for the transaction (fixed amount)
  • SERVICE_FEE_PLUGIN -Maksekeskus monthly fee for using the MakeCommerce integration module
  • SERVICE_FEE_LOGISTICS -Maksekeskus monthly fee for using carrier integration service  (MakeCommerce modules)
  • SHIPMENT_DELIVERY_FEE – Fee for sending parcels via Maksekeskus transport mediation service
  • VAT – value added tax on Maksekeskus service fee
  • VAT_CORRECTION – correction of the VAT rounding error (calculated at the end of month)

How are monthly fees calculated?

Two types of monthly fees can be charged from your Maksekeskus account: Makecommerce plugin monthly fee and monthly fee for payment methods.

The standard price list includes the use of local bank links for free, for example, when the Estonian e-store only uses Estonian bank links. If the merchant also wants to activate card payments or foreign bank links, the monthly fee for the account will be 10 euros (+ VAT 20%) on the basis of the e-shop. The monthly fee is charged irrespective of whether or not a payment has been accepted in a particular month by means of this payment method. If the merchant wants to add several different payment methods (for example, both Latvian and Finnish banklinks), the monthly fee will still be 10 euros.

Monthly fees for plugins are user-friendly. If an online store uses the MakeCommerce module to receive payments, a monthly fee of 10 euros (+ VAT 20%) is charged. If the logistics plugin’s (delivery information) functions are used, additional 5 euros will be added to the monthly fee. If there were no transactions within a month (modules were not  used), then the monthly fee will not be charged. There are no monthly fees for test environment transactions.

All monthly fees are deducted from merchant’s Maksekeskus account on the last day of the month. If the service was activated during the same month, monthly fees will still be calculated in whole (not respectively to the days used).

What does VAT correction mean in my account statement?

Maksekeskus calculates VAT on every transaction. Since these entries are rounded to 1 cent, there may be a situation where the sum of the VAT deducted during the month, does not exactly equal to 20% of the total amount of service fees calculated per month. To correct this, an automatic correction is made at the beginning of the new month. This is typically a small amount (from 1 cent) and the reference for the entry is “VAT correction”.

API and integration

Where do i find the Shop ID, API secret key and API publishable key?

Shop ID, API secret key and API publishable key can be found under Settings > API Settings in the merchant portal merchant.maksekeskus.ee

Account statement xml file

The account statement xml file of Maksekeskuse is following the ISO 20022 camt.053 format.

Below we describe some specifics:

Relationship of an account movement record with a transaction/order in e-shop is carried by attribute EndToEndId,
in example: <EndToEndId>15178</EndToEndId>

Direction of the account movement (to the account vs from account) is carried by atrribute <CdtDbtInd>
in example: <CdtDbtInd>DBIT</CdtDbtInd> or <CdtDbtInd>CRDT</CdtDbtInd>

Type of the account movement is carried by ‘Ustrd’
nt: <Ustrd>INCOME</Ustrd>

There are following types:

  • INCOME – customer paid for the transaction
  • REFUND – money was returned to the customer (buyer)
  • TRX_FEE – Maksekeskus service fee for the transaction (% of transaction amount)
  • TRX_FEE_FIX -Maksekeskus service fee for the transaction (fixed amount)
  • TRX_FEE_MIN -Maksekeskus service fee for the transaction (fixed amount)
  • SERVICE_FEE_PLUGIN -Maksekeskus monthly fee for using the MakeCommerce integration module
  • SERVICE_FEE_LOGISTICS -Maksekeskus monthly fee for using carrier integration service  (MakeCommerce modules)
  • SHIPMENT_DELIVERY_FEE – Fee for sending parcels via Maksekeskus transport mediation service
  • VAT – value added tax on Maksekeskus service fee
  • VAT_CORRECTION – correction of the VAT rounding error (calculated at the end of month)

How to integrate Shopify.com?

Shopify integration guide can be found here

Where can I find payment method logos?

Maksekeskus and MakeCommerce logo you can find: https://maksekeskus.ee/logo/

Logos of individual payment channels you can find on  https://static.maksekeskus.ee/img/channel/lnd/{channel_name}.png ,
(i.e.: swedbank = https://static.maksekeskus.ee/img/channel/lnd/swedbank.png jne).

Channel names  (alphabetically):
aktia, alandsbanken, citadele, coop, danske, handelsbanken, lhv, liisi_ee, luminor, maestro, mastercard, nordea, omasaastopankki, pocopay, pohjola, poppankki, saastopankki, seb, spankki, swedbank, tapiola, visa.

How to integrate Maksekeskus with Shoproller?

You can find API keys and Shop ID in merchant self service portal merchant.maksekeskus.ee (Settings > API). After that configure Maksekeskus using this guide.

Can I integrate Maksekeskus with Wix.com?

No, unfortunately it is not possible to integrate Maksekeskus with Wix.

Contract Changes

What do I need to do if my domain name changes but the legal name of the company remains the same?

In case of a domain name change please get in touch with us at support@maksekeskus.ee. You will need to sign an annex for your contract.

I’m selling my online store to another company. What should I do?

If that’s your only store under Maksekeskus account and you do not wish to continue using our services, you should send us a digitally signed application for terminating the contract.

In case it’s one of several stores that you have with us, please contact our customer support at support@maksekeskus.ee

The new owner would need to fill in our sign up application in both cases.

I’m already using your service but would like to add an additional online store. Whad do I do?

Please make sure the new online store is compliant with our sign-up requirements. Then contact us support@maksekeskus.ee

DELIVERY

How can I use MakeCommerce delivery modules?

Delivery information is an additional function of MakeCommerce modules. There is no need for an agreement with a  transport company to use Omniva parcel machines in Estonia – the service can be used through Maksekeskus. For other delivery options (DPD, Itella, Omniva courier or parcel machines outside Estonia), you must contact the desired company directly and sign a contract with them before the module can be used.

Merchant Portal

How can I add new users in the self-service environment?

New users can be added in the Merchant Portal under Settings -> Users.

User rights depend on the assigned role:

  • “Administrator” can add new users and change e-shop settings as well as make refunds and export data
  • “user (info & refunds)” can make refunds and export data
  • “user (info only)” can only see and export data but cannot make refunds

Payment Methods

How long does it take to activate different payment methods?

Typical waiting times

  • Estonian and Finnish banklinks: up to 2 working days
  • Latvian and Lihtuanian banklinks: up to 4 working days
  • card payments: up to 2 weeks

 

Where can I see the applicable price list

The applied price list is displayed in Merchant Portal under menu Billing. If this is a negotiated price list then the price list is also brought out as an appendix of your Maksekeskus service agreement.

My customer contacted me and changed the order. How can I collect additional payment from her?

When a customer has to make an additional payment to the online store, for example to pay additional posting fees or exchanging a product, there is a simple solution – Payment link.

Payment link can be made in the Merchant Portal in the section “Payment link”. Just insert the sum (decimal point is a dot “.”) and merchant reference (e.g. “Order 123 additional payment”) and a link is created.

This link must be copied and sent to the customer. If the customer clicks on it, a payment gateway page will open and the they can choose a suitable payment method and pay for the sum. This payment will also leave a transaction in the system.

Why didn’t I get e-mail notification for the transaction?

Check if your e-mail address is correct in Settings > API > Notifications email.

Check the spam folder of your e-mail application. Some e-mail services tend to flag automatic e-mails as unwanted unless instructed otherwise.

How are the service fees 2.5% + 0.3 EUR calculated?

Service fees are calculated separately per each transaction. Transaction fees are deducated from transaction amount ( not added to the payment amount).

For example if the amount of purchase is 50 euros, then Maksekeskus will calculate service fees as follows: 0.3 eur + 2.5%*50 eur = 1.55 eur. VAT will be added to transaction fees 20%*1.55 eur = 0.31 eur.

Customer will pay 50 euros and Maksekeskus will pay out to Merchant 50 – 1.55 – 0.31 = 48.14 euros.

Can I accept payments in other currencies besides Euro?

Through Maksekeskus you can also receive credit card payments in GBP, USD, NOK, SEK and JPY.

  • Transactions in foreign currency can only be paid with a credit card (bank links are not supported)
  • Billing between Maksekeskus and the Merchant will still be in euros
  • Merchant can use all currencies in parallel
  • The transaction is converted into euro at the current ECB exchange rate immedialtely at the time of creation of the transaction
  • Exchange rates are the European Central Bank’s + MK margin (i.e. if Maksekeksus margin is 1.2% and eur/gbp rate for the ECB is 0.75860, we will convert the transaction to EUR at 0.7677032)
  • In the process of requesting transactions via API, the amount is returned in euro (conversion result), the transaction is accompanied by additional data fields ‘original_amount’ and ‘original_currency’
  • The transaction listing on the MK self-service portal shows transactions in euros, if a transaction was made in another currency there is a tag displayed and when you mouse over it, it shows the initial amount in the original currency with the conversion rate. When exporting transactions (csv, xls) they are all shown in euro (as converted at the time of creation).
  • When making a refund, this will be done in the original currency, so the customer will get what they paid (e.g. 12 gbp). Maksekeskus account statement will show the refund in euro respectively to the exchange rate applicable at the time of the refund.
  • To activate the service, please contact us at support@maksekeskus.ee

PAYOUTS

Why did my payout amount did not match the sum of my sales

Typically the payout does not match the sum of e-shop sales on previous day because:

  • Transaction fees are deducted from every incoming transfer
  • If your service plan includes monthly fees then these are deducted on the last day of the month. Note that if the monthly fees are higher than account balance then the balance would turn (temporarily) negative.
  • If you make refunds then your account balance gets debited accordingly
  • Card transactions’ payouts are delayed up to 7 days compared to banklinks. Such transaction would be displayed in the Merchant’s Portal as COMPLETED but missing Payout number.

In case of confusion you can get an overview of your Account movements from Merchant’s Portal. Note that the Excel export file provides even more detailed data including the balance before and after every account movement.

How often are payouts settled to my bank account?

You can choose under Merchant Portal Settings menu whether payouts are done on every working day (default option), weekly or monthly.

In case of daily payoouts the banklink payments are normally paid out on the next working day. VISA / MasterCard payments are paid out with 7 day delay.

Note that no payouts are settled during Estonian national holidays nor on any other banking holidays of SEPA payments scheme

You can get an overview of all past payouts from the Merchant Portal menu Payouts.

Which transactions were included in my payout?

Note that each incoming transaction would not have its own payout. Instead we pool together all your transactions and generate a single payout on the next working day. Details of every transaction can be seen on the Merchant’s Portal.

Open the menu Account Statement for detailed overview. Each transaction that has already been included in a payout has a reference to the Payout ID in the respective column.

 

REFUNDS

How fast will the customer receive the refund

The customers usually receive refunds for Baltic banklinks on the next working day.

Card payment refunds usually take 2-3 working days.

Finnish banklink refunds are paid to the customer once the customer has entered necessary data into Paytrail system after automatic e-mail.

How does refund of Finnish bank-link payments work?

When we receive payments from Finnish banks we do not get the IBAN number of the payer. Its the peculiarity of Finnish market.
Therefore there is a process used where an e-mail to the customer is sent asking to submit his/her account number to paytrail.com system.

Therefore – when you want to refund a Finnish bank-link payment through Maksekeskus you are requested to provide e-mail address of your customer.
The customer will receive an automatic e-mail from paytrail.com, the e-mail contains a link to a form that the customer needs to fill in.
He needs to indicate the IBAN number to where the money should be transferred.
Once this is done the money is automatically transferred to indicated account and the refund is settled.
If the customer does not fill in the form during 30 days the refund ‘fails’ automatically.

The amount of the refund is reserved on merchant’s account at Maksekeskus the moment the refund is created.
If the customer did not submit his IBAN within the 30 days and the refund fails, the reserved amount on customer account is released again.
When the refund gets successfully ‘SETTLED’ then respective accounting record is created on merchant’s account clearing the reservation.

How can I make refunds to my customers?

In order to perform a refund open the “Transactions” view in the Merchant Portal and click the transaction ID in the first column. Then choose the amount that you wish to refund and click “Make a refund” and “Confirm”.

We recommend to fill comment box, it is easier to know latter what was refunding reason, but it is optional and does not affect refund.

You must have enough funds in your shop balance to make the refund. If there is not then contact support@maksekeskus.ee to discuss how to make the refund in this case.

Note that refunds cannot be cancelled.

There is no transaction fees for making refund, still we do not return previously taken transaction fees for accepted transactions.

SIGN UP

Does my online store need to use https (SSL certificate)?

For accepting banklink payments it is not obligatory, because to complete the payment, the customer is directed to Maksekeskus payment gateway which uses secure connections. But to increase your online stores credibility and business security, we recommend using SSL certificate.

To accept credit card payments your store must use https.

How to sing up?

Please find all requirements for Merchant here. If your web page meets all asked requirements please send us New Merchant application that you can find here. Our support team will process your application and may ask some additional questions.

VISA/MASTERCARD PAYMENTS

What should the merchant take into account when the online shop uses the Visa/MasterCard payments?

When online shop/webpage is using Visa/MasterCard payment methods, the merchant must be observant and alert for possible fraudulent transactions.

The merchant is responsible for all the transactions made in the web-environment. The merchant must take all possible measures to prevent fraudulent transactions in its web-environment. It is important to follow the principle “Know your client” which involves collecting relevant information regarding your online shop from clients and preserving documents related to transactions.

If there are transactions made with a stolen or forged credit card in the merchants web-environment, then the merchant is responsible for charges fraudulently imposed on a customer.  Chargeback fee of fraudulent transactions is 30 Euros.

What is a fraudulent transaction and a chargeback?

A fraudulent transaction is an action, when a debit or credit card is used for malignant purposes and the goal is to use third parties means for benefiters own gain. Card frauds are often related to identity theft and a criminal offense.

A chargeback is a form of customer protection provided by the issuing banks, which allows cardholders to file a complaint regarding fraudulent or otherwise dissatisfactory transactions on their statement. The reasons for chargebacks can vary from fraudulent transactions, items not received, credit not processed, technical problems etc.

Also, note that merchant accounts receiving too many chargebacks can be labeled by credit card companies as fraudulent, and this can be potentially damaging to the image and the existence of your business.

Fraudulent transactions bring time cost, because the merchant must contact the client, acquire information and documents, and financial loss,  and chargeback costs, which can affect commercial activity and in the worse case, the enterprise must close its business.

How can I avoid fraudulent transactions and chargebacks?

Before all the necessary information is gathered from the client, we ask not to issue any products/services.

The merchant is responsible for legitimacy all the transactions made in the web-environment. The merchant must take all possible measures to prevent fraudulent transactions in his web-environment. It is important to follow the principle “Know your client” which involves collecting relevant information regarding your online shop from clients and preserving documents related to transactions.

To prevent fraudulent transactions, the merchant must monitor actively and constantly its online shop/webpage transactions and keep in mind the following points:

1. Clients delivery addresses. If the delivery address is different than the clients/payer address and delivery address is a hotel, guesthouse, international postal mediator service or post-office box or the products are usually delivered to Estonia or to the Baltics, but the delivery address is outside the usual area, the merchant should contact the client. It’s also important to keep in mind whether the repeating names and addresses are the same.

2.  Frequent transactions form the same person. If there are very frequent transactions from one person/one IP address, then it is basis for contacting the client and asking additional information. Extra attention should be shown to clients, who have several unsuccessful transactions and finally a payment comes through. This means there might be different credit cards used or other sort of fraudulent activity.

3. Client contact info. Merchant must be able to contact the client to specify transaction details and therefore the online shop/web-environment must preserve as much information as possible of the client. The necessary information includes client name, a working e-mail, contact phone number, delivery address, note box when placing the order. In case of incomplete contact information it should be specified and if that’s not possible, make a refund without sending out any merchandise.

4. Very large amount of merchandise. If an order of an unusually large amount is made in the online shop, then the merchant has a right to ask for clients identification document copies. Extra carefulness is advised with new clients, who order big amounts of merchandise which is easily re-sellable.

5. Orders from unusual location. Like with delivery addresses, it is necessary to pay attention to orders coming from unusual locations, especially outside of Europe. In case of any suspicions the online shop should contact the client and ask for additional information and copies of identification documents.

In order to avoid card transaction chargebacks:

  • Contact information and customer support. Merchant contact info must be easily findable and correct in the online shop/web-environment, so that the client could contact the merchant directly in case of any questions.
  • Terms and conditions of purchases, returns and deliveries. If clear, thorough and easily findable terms and conditions are on the online shop/web-environment page, it minimizes the risk of chargebacks.
  • Order confirmation. After confirming the order, it’s best to send the client an e-mail to the address they provided and another confirmation after issuing the merchandise, where merchants, orders and delivery address information is brought out.

What should be done if the merchant is notified of a chargeback?

Maksekeskus will contact the merchant to specify a transaction when there is a suspicion of a possible fraudulent transaction, payer (“client” from now on) has reported the transaction as fraud or the merchant has been issued a chargeback.

Reacting to these situations is very time-sensitive and right actions help the merchant save money and time.

A chargeback is a form of customer protection provided by the issuing banks, which allows cardholders to file a complaint regarding fraudulent or otherwise dissatisfactory transactions on their statement. The reasons for chargebacks can vary from fraudulent transactions, items not received, credit not processed, technical problems etc.

An additional chargeback fee is usually 30 Euros.

If there are transactions made with a stolen or forged credit card in the merchants web-environment and Maksekeskus has not been able to detect or stop these transactions, then the merchant is responsible for charges fraudulently imposed on a customer.

If Maksekeskus has notified the merchant of a card transaction chargeback, then merchant must follow these steps:

  1. Maksekeskus will contact the merchants contact person within 1 work-day (starting from gaining knowledge of transaction chargeback) and following actions will be agreed upon.
  2. Merchants contact person must reply to Maksekeskus e-mail within 1 work-day at support@maksekeskus.ee and will notify Maksekeskus the name of the transactions client, clients delivery address, contact information, delivery issuing confirmation and will settle on following agreed upon actions with Maksekeskus.
  3. The merchant will contact the client and ask for a copy of identification documentation (usually a scanned in version) and explanation regarding the transaction. In case the client sends a copy of the credit card, they should be asked to cover the middle 8 numbers.
  4. Clients response must be preserved in writing.
  5. The merchant will notify Maksekeskus immediately, but no later than within 1 work-day at support@maksekeskus.ee the result of contacting the client.
  6. Maksekeskus will reply within 1 work-day to merchant contact person e-mail address, notifying of agreed upon actions and will continue to notify the merchants if any new information is received for the chargeback in question.