Echo reports

Mangopay Echo provides 4 report types that give your platform full visibility on your declared intents, the payment lifecycle, reconciliation in settlements, and the subsequent splits to sellers. The Echo reports can contain data from the previous 2 years, and the maximum period of data the report can contain is 1 year.

Types and columns

Intents

The Echo Intent report lists all intents declared during the selected period, detailing the total funds expected to enter the platform’s escrow wallets.

Column	Description	Included by default
Id	Unique identifier of the intent	Yes
Status	Status of the intent	Yes
Amount	Amount of the debited funds in the currency of the debited amount	Yes
Currency	Currency of the debited amount	Yes
FeesAmount	Amount of the fees in the currency of the fees	Yes
FeesCurrency	Currency of the fees	Yes
Type	Type of the intent: PAYIN, REFUND, DISPUTE	Yes
PaymentMethod	Payment method of the intent	Yes
BuyerId	Unique identifier of the user at the source of the transaction	Yes
SellerId	Unique identifier of the user(s) at the destination of the transaction	Yes

Intent actions

The Echo Intent Action report lists all operations related to intents processed during the selected period, detailing the expected money movements to be escrowed — including payments, refunds, refund reversals, and chargebacks.

Column	Description	Included by default
IntentId	Unique identifier of the intent	Yes
Id	Unique identifier of the intent action (capture, refund, dispute, cancel)	Yes
ExternalProcessingDate	Unix timestamp of the date and time at which the intent was executed	Yes
ExternalProviderReference	Unique identifier of the intent in the external provider system	Yes
ExternalMerchantReference	Unique identifier of the intent in the merchant system	Yes
Status	Status of the intent action	Yes
Amount	Amount of the debited funds in the currency of the debited amount	Yes
Currency	Currency of the debited amount	Yes
FeesAmount	Amount of the fees in the currency of the fees	Yes
FeesCurrency	Currency of the fees	Yes
Type	Type of the intent: PAYIN, REFUND, DISPUTE	Yes
PaymentMethod	Payment method of the intent	Yes
BuyerId	Unique identifier of the user at the source of the transaction	Yes
SellerId	Unique identifier of the user(s) at the destination of the transaction	Yes

Settlements

The Echo Settlement report lists all settlement files uploaded during the selected period to initiate the reconciliation process, confirming the expected money movements to be escrowed.

Column	Description	Included by default
Id	Unique identifier of the settlement	Yes
CreationDate	Unix timestamp of the date and time at which the settlement was created	Yes
CreationDate:ISO	ISO format of the date and time at which the settlement was created	No
FileName	Name of settlement file	Yes
SettlementCurrency	Currency of the settlement	Yes
Status	Status of the settlement	Yes
SettledTransactionCount	Total number of intents that have been reconciled	Yes
UnsettledTransactionCount	Total number of intents that haven’t been reconciled	Yes
SettledAmount	Total amount of intents that have been reconciled	Yes
DeclaredAmount	Total amount of intents that have been declared	Yes
DeficitAmount	The difference between `DeclaredAmount` and `SettledAmount	Yes

Splits

The Echo Splits report lists all splits related to intents during the selected period, detailing the transfer of funds to the declared destination.

Column	Description	Included by default
Id	Unique identifier of the split	Yes
IntentId	Unique identifier of the intent	Yes
AuthorId	Unique identifier of the user at the source of the split	Yes
Amount	Amount of the credited funds in the currency of the credited amount	Yes
Currency	Currency of the credited amount	Yes
FeesAmount	Amount of the fees in the currency of the fees	Yes
FeesCurrency	Currency of the fees	Yes
Status	Status of the split	Yes
Description	Description of the split	Yes
CreditedWalletId	Unique identifier of the credited wallet	Yes
DebitedWalletId	Unique identifier of the debited wallet	Yes
Scheduled	Whether or not `TransferDate` was sent in the intent or split	Yes
CreationDate	Unix timestamp of the date and time at which the split was created	Yes
CreationDate:ISO	ISO format of the date and time at which the split was created	No
ExecutionDate	Unix timestamp of the date and time at which the split was executed	Yes
ExecutionDate:ISO	ISO format of the date and time at which the split was executed	No

Generate via API

Set up webhooks

The API endpoint for the Echo reports uses webhooks to notify your chosen URL that a report is ready for download.The time it takes for a report to be generated depends on the quantity of data. If exporting large amounts of data via API, ensure you have these webhook event types set up to know when to fetch the report:

REPORT_GENERATED – Indicates that a report is ready for download at the DownloadURL
REPORT_FAILED – Indicates that a report was not generated successfully

Define filters and columns

The available sub-parameters of the Filters parameter for the Echo reports depend on the type, which is defined in the ReportType field.

The ECHO_INTENT and ECHO_INTENT_ACTION reports have the same filters, which can be used in any combination.

Hide properties

Type

string

The type of Intent (as indicated in the settlement file): PAYIN, REFUND, DISPUTE

Status

string

The Status of the Intent: AUTHORIZED, PARTIALLY_CAPTURED, CAPTURED, CANCELED, REFUNDED, REFUND_REVERSED, DISPUTED, DEFENDED, DISPUTED_WON, DISPUTED_LOST

PaymentMethod

string

The payment method of the Intent: one of the supported values of the ExternalProviderPaymentMethod

All available columns are set by default on the Echo reports. You can customize this in the Columns parameter by sending the full list of columns you wish to see in the report.

Run the report

Run the report by calling the POST Create a Report endpoint and setting the relevant ReportType.Send your desired date period in the AfterDate and BeforeDate fields, which refers to the transaction CreationDate. Ensure that the difference between them is no more than 12 months and the AfterDate is not more than 24 months ago.Send your defined filters in the Filters parameter and, if not using the default columns, the full list of columns you wish to include in the Columns parameter.

{
    "Tag": "Created using the Mangopay API Postman collection",
    "DownloadFormat": "CSV",
    "ReportType": "ECHO_INTENT",
    "AfterDate": 1740787200,
    "BeforeDate": 1743544740,
    "Filters": {
        "PaymentMethod": "MASTERCARD",
        "Status": "CAPTURED",
        "Type": "PAYIN"
    }
}

The API response shows the Status as PENDING, indicating that the report is being generated.

{
    "Id": "report_01K21WBZNWF8JYD5NDMKA3YA73",
    "Tag": "Created using the Mangopay API Postman collection",
    "CreationDate": 1754557447,
    "ReportDate": null,
    "Status": "PENDING",
    "ResultCode": null,
    "ResultMessage": null,
    "DownloadFormat": "CSV",
    "DownloadURL": null,
    "ReportType": "ECHO_INTENT",
    "Sort": "CreationDate:DESC",
    "AfterDate": 1740787200,
    "BeforeDate": 1743544740,
    "Filters": {
        "PaymentMethod": "MASTERCARD",
        "Status": "CAPTURED",
        "Type": "PAYIN"
    },
    "Columns": [
        {
            "Name": "Id",
            "IsDefault": true
        },
        {
            "Name": "Status",
            "IsDefault": true
        },
        {
            "Name": "Amount",
            "IsDefault": true
        },
        {
            "Name": "Currency",
            "IsDefault": true
        },
        {
            "Name": "FeesAmount",
            "IsDefault": true
        },
        {
            "Name": "FeesCurrency",
            "IsDefault": true
        },
        {
            "Name": "Type",
            "IsDefault": true
        },
        {
            "Name": "PaymentMethod",
            "IsDefault": true
        },
        {
            "Name": "BuyerId",
            "IsDefault": true
        },
        {
            "Name": "SellerId",
            "IsDefault": true
        }
    ]
}

Download when ready

The report is ready for download when its status changes from PENDING to GENERATED, which triggers the REPORT_GENERATED webhook.Call the GET View a Report endpoint to retrieve the DownloadURL value where you can download the report.If the Status changes to FAILED, triggering the REPORT_FAILED webhook, then more information about why the report could not be generated is available in the ResultCode and ResultMessage.

Repeat process as needed

All Echo reports are valid for 31 days. After this, the Status changes to EXPIRED at it is no longer available for download.You can re-generate another report with the same parameters and update the date range for the latest period.

Getting started

Integration options

Resources

Useful links

Types and columns

Intents

Intent actions

Settlements

Splits

Generate via API

Getting started

Integration options

Resources

Useful links

​Types and columns

​Intents

​Intent actions

​Settlements

​Splits

​Generate via API

Types and columns

Intents

Intent actions

Settlements

Splits

Generate via API