View validation errors for a Settlement

GET

/v3.0/:ClientId/payins/intents/settlements/:SettlementId/validations

Retrieve information about failed or partially matched settlements

If your Settlement’s Status is PARTIALLY_MATCHED or FAILED, this endpoint returns information about the errors in your CSV file’s footer or transaction lines.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

If your platform is using a proxy to take SCA-triggering action on behalf of users, you also need to integrate mTLS authentication and use the api-mtls base URL.

Bearer authentication of the form `Bearer <token>`, where token is your auth token. If your platform is using a [proxy](/guides/sca/proxy-management) to take SCA-triggering action on behalf of users, you also need to integrate [mTLS authentication](/guides/sca/platform) and use the `api-mtls` base URL.

Path parameters

ClientIdstringRequired

Platform's API account identifier, associated with the API key.

SettlementIdstringRequired

The unique identifier of the Settlement object.

Response

Success

FooterErrorslist of objects

The errors encountered in the CSV footer.

LinesErrorslist of objects

The errors encountered in the CSV's transaction lines.

1	{
2	"FooterErrors": [
3	{
4	"FooterName": "TotalNetSettlementAmount",
5	"Code": "SETTLEMENTAMOUNT_NOT_MATCH",
6	"Description": "TotalNetSettlement amount 1000 EUR is not matching to declared amount 9000 EUR."
7	}
8	],
9	"LinesErrors": [
10	{
11	"ExternalProviderReference": "auth-stripe-76f0baab-3d89-47e4-85f6-417864588055",
12	"ExternalTransactionType": "REFUND",
13	"Code": "MATCH_REF_NOT_FOUND",
14	"Description": "ExternalProviderReference not found for any existing Intent in the system"
15	}
16	]
17	}

$	curl https://api.sandbox.mangopay.com/v3.0/{ClientId}/payins/intents/settlements/{SettlementId}/validations \
>	-H "Authorization: Bearer <token>"