Settlements & Chargebacks

This section describes the structure and content of settlement, fees and chargebacks reports available to merchants.

Settlement reports allow you to track the amounts paid, the expected settlement dates, and any third-party references linked to payments. Fees reports detail the charges applied to each transaction.

Report Structure

The table below lists all available fields in the settlement report

Field Name	Format	Description	Example - SETTLEMENT Record	Example - FEES Record	Example - CHARGEBACK Record
Settlement.Id	string	Purse internal and unique identifier of the settlement.	8b286678-397a-4a2c-b04a-7a536163ebbd	8b286678-397a-4a2c-b04a-7a536163ebbd	8b286678-397a-4a2c-b04a-7a536163ebbd
Settlement.Type	enum	Type of settlement: NET or GROSS	NET	NET	NET
Settlement.ThirdPartRef	string	Third part identifier of the settlement on PSP or financial partner side.	939337303816	939337303816	939337303816
Settlement.ExpectedDate	date	Expected date of funds' settlement on merchant account.	2025-03-06T12:30:47.619Z	2025-03-06T12:30:47.619Z	2025-03-06T12:30:47.619Z
Settlement.Amount	number	Settlement amount.	+123,287.54	+123,287.54	+123,287.54
Settlement.Currency	string	Settlement currency (ISO 247).	EUR	EUR	EUR
Settlement.LabelPattern	string	Settlement ID or label pattern to identify settlement group.	*V39249R2490	*V39249R2490	*V39249R2490
Session.Id	string	Purse internal and unique session identifier.	63c8eb9b-148c-42d0-9012-68b7c4660c81	63c8eb9b-148c-42d0-9012-68b7c4660c81	63c8eb9b-148c-42d0-9012-68b7c4660c81
Session.MerchantEntityId	string	Purse internal and unique merchant entity identifier.	e02dcfb7-5e2a-4afd-b9b0-e490dab98a2e	e02dcfb7-5e2a-4afd-b9b0-e490dab98a2e	e02dcfb7-5e2a-4afd-b9b0-e490dab98a2e
Session.ThirdPartMerchantId	string	Third part merchant identifier on PSP/MOP side.	Purse Corp	Purse Corp	Purse Corp
Session.CreateDate	date	Creation date of the session.	2025-03-06T12:30:47.619Z	2025-03-06T12:30:47.619Z	2025-03-06T12:30:47.619Z
Session.MerchantOrderRef	string	Merchant order reference.	Cmd002849	Cmd002849	Cmd002849
Session.CustomerRef	string	Customer order reference.	06031996	06031996	06031996
Session.Amount	number	Session net amount related to payment (discount excluded).	250.00	250.00	250.00
Session.Currency	string	Merchant session currency (ISO 247).	EUR	EUR	EUR
Transaction.Id	string	Purse internal and unique transaction identifier.	1c894af7-6fff-43ee-ab14-55f7885f3327	1c894af7-6fff-43ee-ab14-55f7885f3327	1c894af7-6fff-43ee-ab14-55f7885f3327
Transaction.ThirdPartRef	string	Third part operation or transaction identifier.	2382492093840	2382492093840	2382492093840
Transaction.Partner	string	Partner used for payment.	adyen	adyen	adyen
Transaction.Method	string	Method used for payment.	creditcard	creditcard	creditcard
Transaction.ThirdPartBrandOrSubMethod	string	Scheme or sub payment method used and chosen by cardholder.	VISA	VISA	VISA
Transaction.Type	enum	Transaction type (CAPTURE, REFUND).	CAPTURE	CAPTURE	CAPTURE
Transaction.CreateDate	date	Creation date of the transaction.	2025-03-06T12:30:47.619Z	2025-03-06T12:30:47.619Z	2025-03-06T12:30:47.619Z
Transaction.seller_name (If sent in the transaction request)	string	Seller or merchant name.	Purse Store	Purse Store	Purse Store
Transaction.seller_reference (If sent in the transaction request)	string	Internal seller reference.	SELL-001	SELL-001	SELL-001
Transaction.Amount	number	Transaction amount.	135.00	135.00	135.00
Transaction.Currency	string	Transaction currency (ISO 247).	EUR	EUR	EUR
Transaction.Operation.Id	string	Unique identifier of the operation linked to the transaction.	95d7e27b-0b3d-4b85-bc48-88f37d2022f2	95d7e27b-0b3d-4b85-bc48-88f37d2022f2	95d7e27b-0b3d-4b85-bc48-88f37d2022f2
Transaction.Operation.Amount	number	Operation amount related to the transaction.	135.00	135.00	135.00
Transaction.Operation.Currency	string	Operation currency (ISO 247).	EUR	EUR	EUR
Transaction.Partner_transaction_id	string	Transaction ID provided by the PSP.	939337303816	939337303816	939337303816
Transaction.ClientSession.Id	string	Identifier of the client session related to the transaction.	63c8eb9b-148c-42d0-9012-68b7c4660c81	63c8eb9b-148c-42d0-9012-68b7c4660c81	63c8eb9b-148c-42d0-9012-68b7c4660c81
Transaction.Payment.Id	string	Unique payment identifier linked to the transaction.	7c3fd13c-5f0d-4f24-bfb6-8d423c7a8e94	7c3fd13c-5f0d-4f24-bfb6-8d423c7a8e94	7c3fd13c-5f0d-4f24-bfb6-8d423c7a8e94
Record.Type	enum	Type of record (SETTLEMENT, FEES, CHARGEBACK).	SETTLEMENT	FEES	CHARGEBACK
Record.Id	string	Unique record identifier.	baa0d3f2-a493-4aac-bea6-741bc24ad0c6	4b01c778-639f-4124-8f15-9a1d5a342c10	29b2124f-f449-47d9-b768-0d4e515749f2
Record.Amount	number	Record amount (positive for credit, negative for debit).	+ 132.56	- 2.44	- 132.56
Record.Currency	string	Record currency (ISO 247).	EUR	EUR	EUR
Record.CreationDate	date	Creation date of the record.	2025-03-06T02:00:47.619Z	2025-03-06T02:00:47.619Z	2025-03-06T02:00:47.619Z
Record.ChargeBack.Reason	string	Chargeback reason if applicable.			Fraudulent transaction
Record.Description	string	Record description or label.	Settlement for October	Settlement Fees for October	This is a Chargeback
Record.GrossAmount	number	Gross amount before deductions.	Same as transaction.amount
Record.VATAmount	number	VAT amount associated with the record if applicable.

Key Notes

• The Settlement.Type field helps differentiate between standard settlements (NET) meaning that you will have FEES lines associated to your transactions and special cases (GROSS) with no FEES into your Purse report.
• Amounts are expressed in the merchant account currency.
• Identifiers (Settlement.Id, Session.Id, Transaction.Id, Record.Id) are unique and enable automatic reconciliation between your systems and Purse reports.
• Captures, refunds, and chargebacks are represented as specific record types.

Report Delivery Options

As a merchant, you can access and distribute your settlement reports in several ways depending on your operational setup:

• Dashboard Download: You can manually download your reports directly from the Reports → Files section in the Purse dashboard.
• Automated Distribution: For automated data ingestion, reports can also be delivered to an external system — such as a SFTP server or a cloud storage bucket. This setup allows you to integrate Purse reports into your internal financial workflows or BI tools seamlessly.

These delivery options ensure that your reports remain secure, accessible, and automatically synchronized with your internal reporting and accounting systems.

Information

💡 Reports are available via the Purse dashboard and can be downloaded in CSV, JSON or JsonLines format for integration into your tools.