Funding Report

The Funding Report contains all funds transferred (credits and debits). All transactions are part of a batch that Trustly sends to the merchant's bank account for the reporting period.

The Funding Report structure

The Funding Report consists of individual rows of data. Each row provides one of four types of data, identified by a unique Record Type Indicator:

  • Header (H): Always the first row of the report.
  • Funding Record (F): Represents a single batch settlement from the payment processor.
  • Item Record (I): Represents an individual transaction (the core data).
  • Trail (L): Always the last row, providing a final summary of the report.

Understand transaction status

To properly reconcile funds, you need to understand how the Funding Report categorizes pending and settled transactions.

Pending transactions

If an item record is pending (not yet settled), it appears at the top of the report, above the funding records. Pending item records have an amount of $0, do not have a funding trace identifier, and Trustly includes them in the report to show status changes that affect future settlements.

Settled transactions

Transactions that have settled appear as item records under a funding record. This indicates which batch settlement they were in. A single report may contain multiple funding records.

Trail items

The Trail provides a summation of the report's contents. It shows the total number of transactions, the total number of funding records, and the total amount settled to the merchant.

File format

Each line in the Funding File uses a Record Type Indicator as a prefix to identify the type of information it conveys.

Header

The first line of the report is always the Header. For example:

The following table lists the fields and information contained in the Header.

Field nameMax lengthFormatRequiredSample dataNotes
Record Type Indicator1HYesHAlways H.
Magic7P11KFUNYesP11KFUNMagic number.
Version11AlphanumericYes1.0.0File version.
Start Date24UTC Date Time in ISO 8601 formatYes2017-01-21T12:00:00ZReport start date.
End Date24UTC Date Time in ISO 8601 formatYes2017-01-22T12:00:00ZReport end date.
Merchant ID50NumericYes10000000234Merchant identifier.
Sequence10NNNNofNNNNYes0001of0002File sequence. A report can break into multiple files.

Funding record

A Funding Record is created for each batch settlement that takes place with the payment processor. The individual Item Records under each Funding Record make up the sum of the settlement. For example:

The following table lists the fields and information contained in the Funding Record line.

Field nameMax lengthFormatRequiredSample dataNotes
Record Type Indicator1FYesFAlways F.
Processor50AlphanumericYesProfitStarsPayment processor
Reserved0NoV3 Default Layout - Receiver Account Number last four digits.
Batch ID50AlphanumericYesA12341234Batch identifier. Links the funding record and item record.
Amount Currency3AlphanumericYesUSD CADAmount currency.
Amount18Decimal StringYes-100.00Amount.
Funding Date24UTC Date Time in ISO 8601 formatYes2017-01-21T13:42:03ZFunding date and time.

Item record

An Item Record is a transaction that occurred with the merchant. For example:

The following table lists the fields and information contained in the Item Record line.

Field nameMax lengthFormatRequiredSample dataNotes
Record Type Indicator1IYesIAlways I.
Transaction ID50AlphanumericYes100000234235Transaction identifier.
Transaction Created At24UTC Date Time in ISO 8601 formatYes2017-01-21T13:42:03ZTransaction create date and time.
Parent Transaction ID50AlphanumericYes100000234234Parent Transaction identifier.
Merchant ID50NumericYes10000000234Merchant identifier.
Payment Provider Type20NumericYes1Payment provider type.
Payment Provider ID9AlphanumericYes023456737Payment provider identifier
Payment Account4NumericYes1234Last four digits of the payment account.
Merchant Reference90AlphanumericNoMREF122344Merchant reference.
Transaction Type30AlphanumericYesRefundTransaction type.
Transaction Status30AlphanumericYesAuthorizedTransaction status.
Transaction Updated At24UTC Date Time in ISO 8601 formatYes2017-01-21T23:42:03ZTransaction last update date and time.
Transaction Processed At24UTC Date Time in ISO 8601 formatYes2017-01-21T23:42:03ZTransaction processed date and time.
Amount Currency3AlphanumericYesUSD CADAmount currency.
Amount18Decimal StringYes-100.00Amount.
Funding Trace ID50AlphanumericNoA12341234Funding trace identifier.
Payment Provider Transaction Status5AlphanumericNoR03Payment provider transaction status. For returned items, this is the return reason code.
Batch ID50AlphanumericNo3424Batch identifier representing a group of transactions.
Settlement Type3AlphanumericNo20Internal.
Parent Merchant Reference90AlphanumericNoMREF122Merchant reference of the parent transaction.
Payment Provider Transaction ID40AlphanumericNoptx-5sq8ku8smVrss6Pc7-cOVBbI-Payment Provider Transaction ID. Trustly sends this as the identifier to the Automated Clearing House (ACH) processor.
Transaction Fee18Decimal StringNo-0.29Fee deducted from the funding of the transaction. This is only applicable if you participate in Net Settlement.

V3 - Default layout displays item records that are not linked to transactions, such as returned sweep and adjustment (ATP).

Trail

The Trail indicates the end of the report and is a summation of the records within the report. For example:

The following table lists the fields and information contained in the Trail line.

Field nameMax lengthFormatRequiredSample dataNotes
Record Type Indicator1LYesLAlways L.
Num Item Records9NumericYes300Total count of the item records.
Total Items Amount18Decimal StringYes100.00Total sum of the transaction records amount.
Total Funding Records9NumericYes300Total count of the funding records.
Total Funding Amount18Decimal StringYes100.00Total sum of the funding records amount, less any transaction fees (if participating in Net Settlement).

Funding report cut offs

Based on the payment type, funds settle to the merchant or consumer account according to the cutoff days and times and the expected settlement date. This information helps you determine when the transactions appear in the merchant settlement report.

Most transactions appear in the funding report on the business day following settlement to the merchant account. Contact your Customer Success Manager for the exact cutoff days and times based on the payment types you use.