Upload settlement file to secure URL

PUT

https://{settlementfileuploadurl}/:SettlementFileUploadUrl

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 (click here to download), 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-Type header to text/csv and send the file as a raw binary stream using data-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.

To send your CSV settlement file to Mangopay, use the `SettlementFileUploadUrl` value dynamically returned by [POST Create a Settlement and generate upload URL](/api-reference/settlements/create-settlement) endpoint. <Warning icon="fa-regular fa-triangle-exclamation"> **Caution – Use settlement file example as template** You must follow the [specifications provided here](/api-reference/settlements/settlement-file). Use this **Example\_Mangopay\_Settlement\_File.csv** ([click here to download](https://docs.mangopay.com/api-reference/settlements/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. </Warning> You need to send one file per currency, as soon as it becomes available. Read more about [providing settlement files to Mangopay](/guides/echo#send-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-Type` header to `text/csv` and send the file as a raw binary stream using `data-binary` Note that the `FileName` used by Mangopay is the one you sent on the [POST Create a Settlement and generate upload URL](/api-reference/settlements/create-settlement) 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

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

SettlementFileUploadUrlstringRequired

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.

Request

This endpoint expects a string.

Response

No response body. A 200 response indicates that the file was uploaded successfully.

$	curl -X PUT https://{settlementfileuploadurl}/SettlementFileUploadUrl \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: text/csv" \
>	-d "string"