v2

latestOpenAPI 3.1.02026-07-262279731.3 MB

Settlements

Create a Settlement and generate a secure URL for file upload

Generate a pre-signed URL to which you can upload your Mangopay-format settlement file

This endpoint returns a unique temporary pre-signed URL, SettlementFileUploadUrl, that you can use to upload your Mangopay-format settlement file (see PUT Upload a settlement file to the secure URL).

post/v3.0/{ClientId}/payins/intents/settlements

Path parameters

ClientIdstring required

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

Headers

Authorizationstring required

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.

Request body

FileNamestring required

The name of your file, which can be anything you wish. The file extension must be .csv.

Response

Success

UploadUrlstring

The unique temporary pre-signed URL to which to upload your CSV file. Use the full dynamic URL including the host, path, and all query parameters. The URL is already authenticated, so the call does not require an Authorization header. See PUT Upload a settlement file to the secure URL for details

SettlementIdstring

The unique identifier of the Settlement.