Generate reports

Trustly offers the following reports for transaction management:

  • Funding Report This report contains all funds transferred (credits and debits) and all transactions that are part of a batch sent to the merchant's bank account for the reporting period.
  • Settlement Reconciliation This report contains all transactions that were created during the reporting period.
  • RTP Settlement Reconciliation This is a separate reconciliation report that contains only Real-Time Payment (RTP) transactions created for the specific period. This report is available only to merchants using RTP functionality.

Report availability and delivery

Reports are available daily by 10:00 AM Eastern Time.

You can receive reports in one of two ways:

  • Reports are available on a Secure File Transfer Protocol (SFTP) site hosted by Trustly. To request access, contact your Trustly integration team.
  • You download reports from our Merchant portal.

Settlement Funding File

The Settlement Funding File reports the funds transferred into (positive net settlement) or from (negative net settlement) the merchant bank account since the last report. It correlates all transactions that belong to a net settlement and the bank funding activity.

Item records that affect future settlements do not have a Funding Trace ID. These records represent status updates rather than funds movement, so they display a zero amount and are excluded from the current settlement total.

File format

Each line in the Funding File is prefixed with a Record Type Indicator that dictates the type of information it contains.

Header

Field NameMax LengthFormatRequiredSample DataNotes
Record Type Indicator1HYesHAlways H
Magic7P11KFUNYesP11KFUNMagic number. Always P11KFUN.
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 be broken into multiple files.

Funding Record

Field NameMax LengthFormatRequiredSample DataNotes
Record Type Indicator1FYesFAlways F
Processor50AlphanumericYesProfitStarsPayment processor
Reserved0NoReserved for future use
Funding Trace ID50AlphanumericYesA12341234Funding trace identifier. Link between funding record and item record.
Amount Currency3AlphanumericYesUSDAmount currency
Amount18Decimal StringYes-100.00Amount
Funding Date24UTC Date Time in ISO 8601 formatYes2017-01-21T13:42:03ZFunding date and time

Item Record

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 4 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 Currency3AlphanumericYesUSDAmount currency
Amount18Decimal StringYes-100.00Amount
Funding Trace ID50AlphanumericNoA12341234Funding trace identifier
Payment Provider Transaction Status5AlphanumericNoR03Payment provider transaction status. For returned items, it is the return reason code.
Batch ID50AlphanumericNo3424Batch id representing a group of transactions
Settlement Type3AlphanumericNo20Internal
Parent Merchant Reference90AlphanumericNoMREF122Merchant reference of the parent transaction
Payment Provider Transaction ID40AlphanumericNoptx-5sq8ku8sm...Payment Provider Transaction ID. Sent as ID to the ACH processor.
Transaction Fee18Decimal StringNo-0.29Fee that was deducted from the funding of the transaction. NOTE This is only applicable if you are participating in Net Settlement.

Trail

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).

Settlement Reconciliation File

Each line in the Reconciliation File is prefixed with a Record Type Indicator that dictates the type of information it contains.

Header (Required)

Field NameMax LengthFormatRequiredSample DataNotes
Record Type Indicator1HYesHAlways H
Magic7P11KRECYesP11KRECMagic 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-21T12:00:00ZReport end date
Merchant ID50NumericYes10000000234Merchant identifier
Sequence10NNNNofNNNNYes0001of0002File sequence. A report can be broken into multiple files

Transactions Record

Field NameMax LengthFormatSample DataRequiredNotes
Record Type Indicator1TTYesAlways T
Transaction ID50Alphanumeric100000234235YesTransaction identifier
Transaction Created At24UTC Date Time in ISO 8601 format2017-01-21T13:42:03ZYesTransaction create date and time
Parent Transaction ID50Alphanumeric100000234234YesParent transaction identifier
Merchant ID50Numeric10000000234YesMerchant identifier
Payment Type2Numeric1YesPayment type
Payment Provider Type20Numeric1YesPayment provider type
Payment Provider ID9Alphanumeric023456737YesPayment provider identifier
Payment Account4Numeric1234YesLast 4 digits of the payment account
Merchant Reference90AlphanumericMREF122344NoMerchant reference
Transaction Type30AlphanumericRefundYesTransaction type
Transaction Status30AlphanumericAuthorizedYesTransaction status
Transaction Updated At24UTC Date Time in ISO 8601 format2017-01-21T23:42:03ZYesTransaction last update date and time
Amount Currency3AlphanumericUSDYesAmount currency
Amount18Decimal String-100.00YesAmount
Recurring Start Date24UTC Date Time in ISO 8601 format2017-01-21T23:42:03ZYesRecurring start date and time
Recurring End Date24UTC Date Time in ISO 8601 format2017-01-21T23:42:03ZYesRecurring end date and time
Recurring Frequency20Numeric2YesRecurring frequency
Recurring Frequency Unit Type1Numeric2YesRecurring frequency type
Currency3AlphanumericUSDYesCurrency
Recurring Amount18Decimal String-100.00YesRecurring Amount
Recurring AutomaticN/ABooleanTrueYes
Payment Provider Transaction ID40Alphanumericptx-5sq8ku8sm...NoPayment Provider Transaction ID. Sent as ID to the ACH processor.

Trail (Required)

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 Recurring Amount18Decimal StringYes100.00Total sum of the value of recurring records
Currency3AlphanumericNoUSDCurrency of the total value of transaction records

RTP Settlement Reconciliation File

This report is only available if RTP is configured for the merchant. Each line in the Reconciliation File is prefixed with a Record Type Indicator that dictates the type of information it contains.

Header (Required)

Field NameMax LengthFormatRequiredSample DataNotes
Record Type Indicator1HYesHAlways H
Magic7P11KRTPYesP11KRTPMagic 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-21T12:00:00ZReport end date
Merchant ID50NumericYes10000000234Merchant identifier
Sequence10NNNNofNNNNYes0001of0002File sequence. A report can be broken into multiple files

Transactions Record

Field NameMax LengthFormatSample DataRequiredNotes
Record Type Indicator1TTYesAlways T
Transaction ID50Alphanumeric100000234235YesTransaction identifier
Transaction Created At24UTC Date Time in ISO 8601 format2017-01-21T13:42:03ZYesTransaction create date and time
Parent Transaction ID50Alphanumeric100000234234YesParent transaction identifier
Merchant ID50Numeric10000000234YesMerchant identifier
Payment Type2Numeric1YesPayment type
Payment Provider Type20Numeric1YesPayment provider type
Payment Provider ID9Alphanumeric023456737YesPayment provider identifier
Payment Account4Numeric1234YesLast 4 digits of the payment account
Merchant Reference90AlphanumericMREF122344NoMerchant reference
Transaction Type30AlphanumericRefundYesTransaction type
Transaction Status30AlphanumericAuthorizedYesTransaction status
Transaction Updated At24UTC Date Time in ISO 8601 format2017-01-21T23:42:03ZYesTransaction last update date and time
Amount Currency3AlphanumericUSDYesAmount currency
Amount18Decimal String-100.00YesAmount
Recurring Start Date24UTC Date Time in ISO 8601 format2017-01-21T23:42:03ZYesRecurring start date and time
Recurring End Date24UTC Date Time in ISO 8601 format2017-01-21T23:42:03ZYesRecurring end date and time
Recurring Frequency20Numeric2YesRecurring frequency
Recurring Frequency Unit Type1Numeric2YesRecurring frequency type
Currency3AlphanumericUSDYesCurrency
Recurring Amount18Decimal String-100.00YesRecurring Amount
Recurring AutomaticN/ABooleanTrueYes
Payment Provider Transaction ID40Alphanumericptx-5sq8ku8sm...NoPayment Provider Transaction ID. Sent as ID to the ACH processor.

Trail (Required)

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 Recurring Amount18Decimal StringYes100.00Total sum of the value of recurring records
Currency3AlphanumericNoUSDCurrency of total value of transaction records