Skip to main content

TARESIS Format

The TARESIS format is a specialized Paysera payment file format designed for international transfers with detailed bank and beneficiary information. This format supports correspondent bank details and advanced payment routing.

File Requirements

Basic Specifications

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

Field Notation

SymbolMeaningExample
*Mandatory fieldMust be provided
CCharacter/text fieldText or alphanumeric
NNumeric fieldNumbers only
C35Max 35 charactersCharacter field with limit
N14Max 14 digitsNumeric 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


Key Features

The TARESIS format provides:

Correspondent bank support - Full routing through intermediary banks
Detailed beneficiary information - Multiple address fields (2x35 symbols)
Multiple payment details fields - Up to 4x35 symbols for descriptions
Fee sharing options - Three different fee allocation methods
SWIFT support - BIC/SWIFT codes for all banks in chain
Notification options - Telex and phone notification support


Field Specification

The TARESIS format consists of 40 fields, separated by TAB characters.

1-4: Payment Identification

RowField NameSizeRequiredDescription
1NumberC10Unique payment number/identifier
2DateC8Payment date (YYYYMMDD)
3Transaction dateN6Execution date (YYYYMMDD)
4Payment typeN11 = Standard
2 = Urgent
3 = Extra urgent

5-7: Currency and Amount

RowField NameSizeRequiredDescription
5Currency codeC3ISO 4217 code (EUR, USD, etc.)
6Debit currencyC3Invalid for Internet banking
7AmountN14Amount in cents (no decimals)
50.25 EUR = 5025

8-9: Payer Information

RowField NameSizeRequiredDescription
8Payer's accountC35Payer's account number
9BIC of credit institutionC11Issuer of payment order

10-15: Correspondent Bank Information

RowField NameSizeRequiredDescription
10Correspondent bank SWIFTC11SWIFT code (8 or 11 characters, uppercase)
11Beneficiary's account with correspondentC34Account at correspondent bank
12Correspondent bank name 1C35Bank name (field 1 of 2)
13Correspondent bank name 2C35Bank name (field 2 of 2)
14Correspondent bank address 1C35Bank address (field 1 of 2)
15Correspondent bank address 2C35Bank address (field 2 of 2)

16-21: Beneficiary's Bank Information

RowField NameSizeRequiredDescription
16Beneficiary's bank SWIFTC11SWIFT code (8 or 11 characters, uppercase)
17Beneficiary's bank codeC34Bank code
18Beneficiary's bank name 1C35Bank name (field 1 of 2)
19Beneficiary's bank name 2C35Bank name (field 2 of 2)
20Beneficiary's bank address 1C35Bank address (field 1 of 2)
21Beneficiary's bank address 2C35Bank address (field 2 of 2)

22-26: Beneficiary Information

RowField NameSizeRequiredDescription
22Beneficiary's accountC35Account number
23Beneficiary's name 1C35Name (field 1 of 2)
24Beneficiary's name 2C35Name (field 2 of 2)
25Beneficiary's address 1C35Address (field 1 of 2)
26Beneficiary's address 2C35Address (field 2 of 2)

27-30: Payment Details

RowField NameSizeRequiredDescription
27Payment details 1C35Payment description (field 1 of 4)
28Payment details 2C35Payment description (field 2 of 4)
29Payment details 3C35Payment description (field 3 of 4)
30Payment details 4C35Payment description (field 4 of 4)

31-36: Fee and Notification Settings

RowField NameSizeRequiredDescription
31Foreign bank feesC11 = Only payer
2 = Payer and beneficiary
3 = Only beneficiary
32Inform by telexC10 = Don't inform
1 = Inform
33Inform by phoneC10 = Don't inform
1 = Inform
34Phone numberC20For information purposes
35Commission accountC20Account for commission fees
36Commission currencyC3Currency code for fees

37-40: Intermediary Bank (Not for Internet Banking)

RowField NameSizeRequiredDescription
37Intermediary SWIFTC11Invalid for Internet banking
38Intermediary nameC70Invalid for Internet banking
39Intermediary nameC35Invalid for Internet banking
40Archive codeC50Invalid for Internet banking

Examples

Example 1: Simple International Transfer (USD)

File Content

PAY001		20231215	1	USD		100000	LT123456789012345678			CITI Bank	New York	CHASUS33			Beneficiary Bank	123 Wall St		US123456789012345678	John Smith		456 Main Street		Payment for services				1			LT987654321098765432	EUR

Explanation

Basic fields:

  • Payment ID: PAY001
  • Date: 2023-12-15
  • Priority: 1 (Standard)
  • Currency: USD
  • Amount: 100000 cents = $1,000.00

Beneficiary:

  • Account: US123456789012345678
  • Name: John Smith
  • Address: 456 Main Street

Fees:

  • Option 1: Only payer pays fees

Result: Transfer of $1,000.00 to John Smith in USA


Example 2: Transfer with Correspondent Bank

File Content

PAY002		20231215	2	EUR		250000	LT123456789012345678		CHASUS33	CH9876543210	CITI Correspondent	New York Branch	Wall Street 100	NY 10005	BNPAFRPP	FR7630004000031234567890143	BNP Paribas		La Defense 16	Paris	FR76123456789012345678	Marie Dubois	Société ABC	15 Avenue Champs	75008 Paris	Invoice 2023/123	Consulting services	December 2023		2			LT111111111111111111	EUR

Explanation

Correspondent bank routing:

  • Correspondent SWIFT: CHASUS33 (Citibank)
  • Correspondent account: CH9876543210
  • Final bank: BNPAFRPP (BNP Paribas, France)

Payment details (4 fields):

  1. "Invoice 2023/123"
  2. "Consulting services"
  3. "December 2023"
  4. (empty)

Fees:

  • Option 2: Payer and beneficiary share fees

Result: EUR transfer routed through correspondent bank to France


Example 3: Urgent Transfer with Notifications

File Content

PAY003		20231215	3	GBP		500000	LT123456789012345678		BARCGB22			Barclays Bank	London Branch	1 Churchill Place		GB12BARC20201530093459	James Williams	Williams Ltd	10 Downing Street	London SW1A	Urgent payment	Contract payment			3	1	1	+447123456789	LT222222222222222222	GBP

Explanation

Priority:

  • Type 3: Extra urgent

Notifications:

  • Telex: 1 (Yes, inform)
  • Phone: 1 (Yes, inform)
  • Phone number: +447123456789

Fees:

  • Option 3: Only beneficiary pays fees

Beneficiary:

  • Account: GB12BARC20201530093459
  • Name: James Williams, Williams Ltd (2 name fields)
  • Address: 10 Downing Street, London SW1A (2 address fields)

Result: Extra urgent GBP transfer with phone/telex notifications


Fee Allocation Options

Option 1: Only Payer Pays (OUR)

31st field: 1
  • Payer pays all fees (sending + receiving + intermediary)
  • Beneficiary receives exact amount
  • Use case: When you want beneficiary to receive full amount

Option 2: Payer and Beneficiary Share (SHA)

31st field: 2
  • Payer pays sending fees
  • Beneficiary pays receiving fees
  • Use case: Most common option for international transfers

Option 3: Only Beneficiary Pays (BEN)

31st field: 3
  • Payer pays nothing
  • Beneficiary pays all fees (deducted from received amount)
  • Use case: Rare, usually for specific arrangements

Creating a TARESIS File

Step 1: Prepare Bank Information

Collect all SWIFT/BIC codes:

  • ✅ Beneficiary's bank SWIFT (field 16)
  • ✅ Correspondent bank SWIFT (if needed, field 10)
  • ✅ Bank names and addresses (fields 18-21)

Step 2: Format Amount

Convert to cents:

  • $1,000.00 → 100000
  • €2,345.67 → 234567

Step 3: Split Multi-Line Fields

Name fields (2x35):

"John Smith Corporation Ltd" →
Field 23: "John Smith Corporation Ltd"
Field 24: (empty or continuation)

Address fields (2x35):

"123 Main Street, Suite 456, New York, NY 10001" →
Field 25: "123 Main Street, Suite 456"
Field 26: "New York, NY 10001"

Payment details (4x35):

"Invoice INV-2023-001 for consulting services provided in December 2023" →
Field 27: "Invoice INV-2023-001 for consulting"
Field 28: "services provided in December 2023"
Field 29-30: (empty)

Step 4: Structure the File

Use TAB separator between all 40 fields:

[Field1][TAB][Field2][TAB]...[TAB][Field40]

TARESIS vs MOKESIS

FeatureTARESISMOKESIS
Fields40 fields31 fields
Best forInternational transfersAll transfers
Correspondent bank✅ Full support❌ No support
Payment details4x35 characters1x300 characters
Beneficiary info2x35 fields eachSingle fields
Fee options3 optionsLimited
SWIFT supportFull (multiple banks)Basic
ComplexityHigherLower
Use caseComplex internationalGeneral purpose

Recommendation: Use TARESIS for complex international transfers with correspondent banks. Use MOKESIS for simpler transfers.


Common Errors and Solutions

❌ Error: "Invalid SWIFT code"

Cause: SWIFT code not in correct format
Solution: Use 8 or 11 uppercase characters (e.g., CHASUS33 or CHASUS33XXX)

❌ Error: "Text exceeds 35 characters"

Cause: Single field too long
Solution: Split text across two fields (e.g., name1 and name2)

❌ Error: "Missing required bank information"

Cause: Beneficiary bank name missing (field 18)
Solution: Provide at least field 18

❌ Error: "Invalid fee option"

Cause: Field 31 not 1, 2, or 3
Solution: Use only: 1 (payer), 2 (shared), or 3 (beneficiary)

❌ Error: "Invalid amount format"

Cause: Amount contains decimal point
Solution: Use cents only - 100000 instead of 1000.00


Best Practices

✅ DO

  • Use SWIFT codes for all international banks
  • Split long text across multiple fields
  • Provide complete beneficiary address
  • Specify correspondent bank if required
  • Use uppercase for SWIFT codes
  • Keep commission account updated

❌ DON'T

  • Leave mandatory fields empty
  • Exceed 35-character limits
  • Use lowercase SWIFT codes
  • Mix currencies incorrectly
  • Forget to specify fee option
  • Use spaces instead of TABs

When to Use TARESIS

TARESIS is ideal for:

✅ International transfers with correspondent banks
✅ Complex payment routing
✅ Transfers requiring detailed bank information
✅ Payments with specific fee arrangements
✅ Transfers needing notifications (telex/phone)

Use MOKESIS instead for:

  • Simple domestic transfers
  • Standard SEPA payments
  • When correspondent bank not needed
  • Simpler payment descriptions

Next Steps

Support

Need help with TARESIS format?