MOKESIS Format

The MOKESIS format is the standard Paysera payment file format that provides comprehensive support for all payment types, including domestic and international transfers with country-specific requirements.

File Requirements

Basic Specifications

• File extension: .mokesis
• Example filename: transfers.mokesis, payments.mokesis
• Encoding: UTF-8
• Field separator: TAB character (#9)
• Row structure: One payment per row
• Currency codes: ISO 4217 standard (EUR, USD, GBP, PLN, CZK, etc.)

Field Notation

Symbol	Meaning	Example
*	Mandatory field	Must be provided
C	Character/text field	Text or alphanumeric
N	Numeric field	Numbers only
C35	Max 35 characters	Character field with limit
N14	Max 14 digits	Numeric field with limit

Date Format

All dates use YYYYMMDD format:

• YYYY - Four-digit year (e.g., 2023)
• MM - Two-digit month (01-12)
• DD - Two-digit day (01-31)

Example: 20231215 = December 15, 2023

---

Country-Specific Requirements

Important

Certain countries require additional fields for successful payment processing.

Poland (PLN Transfers)

Required additional fields:

• Field 26: City
• Field 27: Address
• Field 28: Country (ISO 3166-1 alpha-2 code)

Czech Republic (CZK Transfers)

Required additional fields:

• Field 29: Client type (natural or legal)
• Field 30: Postal code
• Field 31: Purpose code (view list)

---

Field Specification

The MOKESIS format consists of 31 fields, separated by TAB characters.

1-4: Payment Identification

No	Field	Size	Required	Description
1	Number	C10	✅	Unique payment number/identifier
2	Date	C8		Payment date (YYYYMMDD)
3	Transaction date	C8	✅	Execution date (YYYYMMDD)
4	Payment type	N1	✅	1 = Standard 2 = Urgent

5-9: Payer Information

No	Field	Size	Required	Description
5	Payer's account	C35	✅	IBAN format account number
6	Payer's name	C200		Full name or company name
7	Payer's code	C11		Personal or company code
8	Payer's bank	C11	✅	Credit institution code
9	Customer code	C16		Code in beneficiary's system

10-12: Originator Information

No	Field	Size	Required	Description
10	Originator's account	C35		Account number
11	Originator's name	C140		Full name or company name
12	Originator's code	C11		Personal or company code

13-17: Beneficiary Information

No	Field	Size	Required	Description
13	Beneficiary's account	C35	✅	IBAN format account number
14	Beneficiary's name	C200	✅	Full name or company name
15	Beneficiary's code	C11		Personal or company code
16	Beneficiary's bank	C11	✅	Credit institution code
17	Customer code	C16		Code in payer's system

18-20: Beneficiary Party Information

No	Field	Size	Required	Description
18	Party account	C35		Additional account
19	Party name	C140		Full name or company name
20	Party code	C11		Personal or company code

21-25: Payment Details

No	Field	Size	Required	Description
21	Amount	N14	✅	Amount in cents (no decimals) 50.25 EUR = 5025
22	Currency	C3	✅	ISO 4217 code (EUR, USD, GBP, PLN, CZK)
23	Fee code	C28		Custom fee code
24	Payment details	C300	✅	Payment description/purpose
25	Archive code	C50		Transaction code (export only)

26-28: Additional Info (Poland - PLN)

No	Field	Size	Required	Description
26	City	C255	PLN*	Beneficiary city
27	Address	C200	PLN*	Beneficiary street address
28	Country	C2	PLN*	ISO 3166 country code (PL)

* Required for PLN transfers to Poland

29-31: Additional Info (Czech Republic - CZK)

No	Field	Size	Required	Description
29	Client type	C7	CZK*	natural or legal
30	Postal code	C10	CZK*	Postal/ZIP code
31	Purpose code	C50	CZK*	Purpose code

* Required for CZK transfers to Czech Republic

---

Examples

Example 1: Simple EUR Transfer (Lithuania)

File Content:

PAY001		20231215	1	LT123456789012345678	John Doe			LT987654321098765432	Jane Smith			10000	EUR		Salary payment November 2023	

Explanation:

Field	Value	Description
1	PAY001	Payment ID
3	20231215	December 15, 2023
4	1	Standard priority
5	LT123456789012345678	Payer's IBAN
6	John Doe	Payer name
13	LT987654321098765432	Beneficiary's IBAN
14	Jane Smith	Beneficiary name
21	10000	100.00 EUR (in cents)
22	EUR	Currency
24	Salary payment November 2023	Description

Result: Transfer of 100.00 EUR from John Doe to Jane Smith

---

Example 2: PLN Transfer to Poland

File Content:

PAY002		20231215	1	LT123456789012345678	UAB "Company"			PL12345678901234567890123456	Jan Kowalski			50000	PLN		Invoice INV-2023-123		Warsaw	ul. Marszałkowska 1	PL

Explanation:

Standard fields:

• Payment ID: PAY002
• Amount: 50000 cents = 500.00 PLN
• Payer: UAB "Company" (Lithuania)
• Beneficiary: Jan Kowalski (Poland)

Poland-specific fields (26-28):

• City: Warsaw
• Address: ul. Marszałkowska 1
• Country: PL

Result: Transfer of 500.00 PLN to Poland with required address information

---

Example 3: CZK Transfer to Czech Republic

File Content:

PAY003		20231215	2	LT123456789012345678	Company Ltd			CZ1234567890123456789012	Petr Novák			75000	CZK		Consulting services December				natural	12000	TRADE

Explanation:

Standard fields:

• Payment ID: PAY003
• Priority: 2 (Urgent)
• Amount: 75000 cents = 750.00 CZK
• Description: Consulting services December

Czech Republic-specific fields (29-31):

• Client type: natural (natural person)
• Postal code: 12000
• Purpose code: TRADE

Result: Urgent transfer of 750.00 CZK with required Czech Republic information

---

Example 4: Multiple Payments

File Content:

PAY001		20231215	1	LT123456789012345678	Company A			LT111111111111111111	Supplier 1			5000	EUR		Invoice #001	
PAY002		20231215	1	LT123456789012345678	Company A			LT222222222222222222	Supplier 2			7500	EUR		Invoice #002	
PAY003		20231215	1	LT123456789012345678	Company A			LT333333333333333333	Supplier 3			12000	EUR		Invoice #003	

Result: Three separate payments in one file (batch processing)

---

Creating a MOKESIS File

Step 1: Prepare Your Data

Collect all required information:

• ✅ Payer's IBAN account
• ✅ Beneficiary's IBAN account
• ✅ Beneficiary's full name
• ✅ Amount (convert to cents!)
• ✅ Currency code
• ✅ Payment description
• ✅ Transaction date
• ✅ Country-specific fields (if applicable)

Step 2: Format the Data

1. Convert amount to cents:

   • 100.50 EUR → 10050
   • 1,234.99 USD → 123499

2. Format dates:

   • December 15, 2023 → 20231215

3. Use TAB separator:

   • Between each field, use TAB character (not spaces!)

Step 3: Structure the File

[Field1][TAB][Field2][TAB][Field3]...[TAB][Field31]

Example with visible TABs (→):

PAY001→→20231215→1→LT123...→John Doe→→→LT987...→Jane Smith→→→10000→EUR→→Payment→

Step 4: Save and Validate

1. Save file with .mokesis extension
2. Ensure UTF-8 encoding
3. Verify all mandatory fields are present
4. Check country-specific requirements
5. Test with small batch first

---

Common Errors and Solutions

Error	Cause	Solution
Invalid amount format	Amount contains decimal point or comma	Use cents only - 10000 instead of 100.00
Missing required field	Mandatory field is empty	Fill all fields marked with * in specification
Invalid IBAN	Account number is not valid IBAN format	Verify IBAN structure, use IBAN validator
Missing country-specific fields	PLN/CZK transfer missing required fields	Add fields 26-28 (Poland) or 29-31 (Czech Republic)
Invalid date format	Date not in YYYYMMDD format	Use 8-digit format: 20231215
Invalid currency code	Non-standard currency code used	Use ISO 4217 codes only

---

Best Practices

✅ DO

• Use unique payment numbers
• Provide clear payment descriptions
• Double-check IBAN numbers
• Test with small batches first
• Keep backup of import files
• Use UTF-8 encoding

❌ DON'T

• Use decimal points in amounts
• Mix currencies in one payment
• Leave mandatory fields empty
• Use special characters in names
• Exceed maximum field lengths
• Use spaces instead of TABs

---

Download Template

Download a template MOKESIS file to get started:

Coming soon: Template file will be available for download

---

Next Steps

• View other formats → - Explore alternative file formats
• Import your file → - Upload to Paysera
• Get support → - Contact us for assistance

Support

Need help with MOKESIS format?

• 📧 Email: support@paysera.com
• 📞 Phone: Contact Information