Reference numbers

E2E reference numbers for settlements and transactions

 

Settlement batch and reconciliation

For card payments, at the beginning of each new day, the settlement batches from the card payments captured and/or credited over one day through Netaxept are passed on to your chosen acquirer(s) for further processing. Acquirer(s) will then settle these transactions to your company's bank account according to the agreed settlement times. For direct bank payments, the bank will transfer the captured or credited amount between the customer's and your company's bank accounts in near real-time. On your company's bank statement you will see card payments settled as settlement batches and direct bank payments as individual transactions.

After the date changes, you can retrieve the information concerning transactions and settlement batches either manually via Netaxept Admin, automatically via Netaxept API, or by using Nets Merchant Portal or reporting service offered by your chosen acquirer or other payment method service provider. With this information, you can match transactions received via Netaxept with the information in your own systems.

  • Netaxept Admin: The web-based Netaxept Admin shows all transactions received through Netaxept, regardless of payment method, and it can be used to retrieve reports concerning individual transactions and settlement batches with the desired search criteria. The settlement batch reports can be downloaded in Excel format for further processing. If necessary, settlement batch reports can be sent daily to the defined email addresses. Login to Netaxept Admin in test environment or production environment
  • Search via Netaxept API: Netaxept API allows you to retrieve transaction and settlement batch information for your systems in XML format. The retrievals work in both REST and Web Services APIs.
  • Nets Merchant Portal: The web-based Merchant Portal displays transactions that are captured and/or credited through Nets’ Nordic payment terminals or Netaxept, regardless of the chosen acquirer, and allows you to retrieve reports for further processing in Excel or XML format. Read more about Merchant Portal
  • Reporting services offered by your chosen acquirer or similar: Most card acquirers and other payment method service providers offer their merchants own reporting services where they can retrieve the needed settlement data including transaction fees and commissions. Please contact your chosen payment method service provider for more information.

 

Batch reference number

The batch reference number identifies the individual settlement batch and can be seen on your company's bank statement for card payments. The batch reference number is not useful for direct bank payments, since these payments are settled to your company's bank account as individual transactions. Therefore, the batch reference number is not shown on your company's bank statement for direct bank payments. Format of the batch reference number will vary depending on the settings you have agreed with your chosen acquirer or other payment method service provider.

 

Transaction reference number

Transaction reference number is a unique end-to-end reference number for each transaction. This can be seen on your company's bank statement for direct bank payments, and through Netaxept Admin and Nets Merchant Portal for all transactions that support transaction-specific reference numbers.

If you want to specify a unique reference number for each transaction, you need to send the parameter TransactionReconRef and its value along the Register call to Netaxept. The same reference number will be then used on all subsequent financial operations (authorization, capture and credit) on the transaction, unless it is overridden when the financial transaction is sent in. Alternatively, you can send TransactionReconRef parameter to Netaxept along the Process call.

It should be noted that card payments are settled to your company's account as settlement batches, which means that you will see the reference number for the settlement batch on your company's bank statement, while the reference number for an individual transaction is not visible. Instead, if you have signed direct agreements with banks concerning the use of direct bank payments, direct bank payments are shown as individual transactions in your company's bank statement, and transaction reference numbers are visible there as well.

Card payments

Since this is an end-to-end transaction reference (from merchant to Netaxept to payment method service provider to merchant), the actual support is bound by the limitation of the payment method service provider that you have an agreement with. The following table shows which transaction-specific reference fields are supported by the different card acquirers.

Please note that in Denmark, for the national card scheme Dankort, the support is depending on the configuration for your merchant in Netaxept. While older versions should use order number up to 11 characters, and avoid using TransactionReconRef, newer configurations should use TransactionReconRef.

Acquirer Visa OrderNumber Visa TransactionReconRef MasterCard OrderNumber MasterCard TransactionRefonRef

Teller DK, SE, FI

Up to 11 characters

--

Up to 11 characters --

Teller NO

Up to 25 characters Up to 25 characters Up to 19 characters

Up to 25 characters

Handelsbanken NO

Up to 25 characters Up to 25 characters Up to 19 characters Up to 25 characters

Handelsbanken FI, SE

Up to 25 characters Exactly 12 digits Up to 19 characters

Exactly 12 digits

Nets Oy (incl. OP and Danske Bank)

-- -- --

--

Kortaccept (former Nordea)

Up to 11 characters -- Up to 11 characters

--

Swedbank

-- Exactly 12 digits --

Exactly 12 digits

Elavon

Up to 25 characters Up to 25 characters Up to 19 characters Up to 25 characters

Bambora (former Euroline)

Up to 11 characters -- Up to 11 characters --

Valitor

       

Direct bank payments

TransactionReconRef is quite commonly used for direct bank payments. The structure of the transaction reference number must follow the specifications suitable for each bank you are using. We recommend you to find a pattern that fits all the direct banks you are connecting to. For example, for Swedish banks, a 10-digit number will be allowed by all the banks. For the time being transaction reference number is not supported for direct bank payments made via Paytrail.

Bank name Payment method name in API Requirement
Swedish banks

Danske Bank

SwedishBankDanskeBank  

Handelsbanken

SwedishBankHandelsbanken

Alphanumeric, max 10 characters

Nordea

SwedishBankNordea Numeric value, max 25 digits, leading zeros not allowed

SEB

SwedishBankSEB Alphanumeric, exactly 10 characters

Swedbank

SwedishBankSwedbank Alphanumeric, max 10 characters
Finnish banks

Aktia

FinishBankAktia Alphanumeric, 4-20 characters, see the structure below

Ålandsbanken

FinishBankAlandsbanken Alphanumeric, 4-20 characters, see the structure below

Handelsbanken

FinishBankHandelsbanken Alphanumeric, 4-20 characters, see the structure below

Nordea

FinishBankNordea Alphanumeric, 4-20 characters, see the structure below

OP

FinishBankOp Alphanumeric, 4-20 characters, see the structure below

POP Pankki

FinishBankPopPankki Alphanumeric, 4-20 characters, see the structure below

Säästöpankki

FinishBankSaastopankki Alphanumeric, 4-20 characters, see the structure below

Oma Säästöpankki

FinishBankOmaSaastopankki Alphanumeric, 4-20 characters, see the structure below

Danske Bank

FinishBankSampo Alphanumeric, 4-20 characters, see the structure below

S-Pankki

FinishBankSPankki Alphanumeric, 4-20 characters, see the structure below

 

Finnish reference numbers need to be formulated according to the Finnish reference number standard. Instructions on the structure are published on the website of the Federation of Finnish Financial Services at www.fkl.fi.

Example: The reference number are formed from the payment specifier, for example 1234567, by calculating a check digit, i.e. the last digit of the reference number, by using multipliers 7-3-1. The specifier’s digits are multiplied from right to left, and the products are added up. The sum is then subtracted from the next highest ten, and the remainder is the check digit added to the specifier.

Specifier: 1 2 3 4 5 6 7
Multiplier: 7 1 3 7 1 3 7
Product: 7 2 9 28 5 18 49 = 118
Check digit: 120 - 118 = 2
=> The reference number is 12345672