Upload a settlement file to the secure URL
To send your CSV settlement file to Mangopay, use the SettlementFileUploadUrl value dynamically returned by POST Create a Settlement and generate upload URL endpoint.
Caution – Use settlement file example as template
You must follow the specifications provided here.
Use this Example_Mangopay_Settlement_File.csv, which contains the correct column and row labels and example data for 3 transactions. Remove the example data lines before generating your own file.
You need to send one file per currency, as soon as it becomes available. Read more about providing settlement files to Mangopay.
When calling the pre-signed SettlementFileUploadUrl:
- Ensure you integrate the full URL (host, path, queries) dynamically as it is unique to each file upload attempt
- Don’t include the Authorization header, as the URL is already authenticated in the query strings
- Set the
Content-Typeheader totext/csvand send the file as a raw binary stream usingdata-binary
Note that the FileName used by Mangopay is the one you sent on the POST Create a Settlement and generate upload URL endpoint (with a timestamp automatically appended); the name of the file on your system is only relevant for the data-binary stream in this call.
Authentication
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.
Path parameters
The variable URL is only documented as a path parameter on this path for documentation reasons. I allows it to be rendered visiablly on the page, and because there are two dynamic server URLs in the spec (so both would be on the / path). The variable URL is the server for this request, and it has a variable host and path and query parameters. You do not need to add anything to it.