Skip to main content
POST
/
v3.0
/
{ClientId}
/
payins
/
intents
/
settlements
curl -X POST ".../v3.0/{ClientId}/payins/intents/settlements" \
-H "Authorization: Bearer token" \
-H "Content-Type: multipart/form-data" \
-F "file=@/example/file-path.csv"
{
    "SettlementId": "int_stlmnt_019778c1-fe45-7864-8d2c-c2394e0f105c",
    "Status": "UPLOADED",
    "CreationDate": 1750077669,
    "DeclaredIntentAmount": 0,
    "ExternalProcessorFeesAmount": 0,
    "ActualSettlementAmount": 0,
    "FundsMissingAmount": 0
}
Use this endpoint to send Mangopay CSV settlement files in Mangopay’s defined template. You need to send one file per currency, as soon as it becomes available. Read more about providing settlement files to Mangopay.
Caution – Use settlement file example as templateYou must follow the specifications provided here.Use this example CSV file (right click and Save as…), which contains the correct column and row labels and example data for 3 transactions. Remove the example data lines before generating your own file.There are no requirements for the file name: you can name your file how you like.

Body parameters

file
csv
required
The settlement file, provided by the external PSP and formatted to comply with Mangopay’s settlement file structure.

Responses

200 - OK

SettlementId
string
The unique identifier of the Settlement.
Status
string
The status of the Settlement:
  • UPLOADED – Settlement file received.
  • CREATED – Settlement file parsed but reconciliation not possible for any lines.
  • UNMATCHED – Settlement file parsed and reconciliation in progress.
  • PARTIALLY_MATCHED – Settlement file parsed and some lines matched successfully.
  • PENDING_FUNDS_RECEPTION – Settlement file parsed and fully matched with Intents; waiting for funds to arrive on the escrow wallet.
  • INSUFFICIENT_FUNDS – Partial amount received: FundsMissingAmount shows the shortfall.
  • RECONCILED – Full settlement amount (ActualSettlementAmount) received on the escrow wallet.
  • FAILED – Settlement file rejected due to a technical error (e.g. format, timeout).
CreationDate
Unix timestamp
The date and time the Settlement was created.
DeclaredIntentAmount
integer
The total amount declared through Intent API calls, using the following calculation: (Sum of captured intents) - (Sum of refunded amounts) + (Sum of refund reversed amounts) - (Sum of DISPUTED disputes) + (Sum of DISPUTED_WON disputes)
ExternalProcessorFeesAmount
integer
The total fees charged by the external provider
ActualSettlementAmount
integer
The total amount due to the platform, to be held in the escrow wallet. This amount corresponds to the TotalSettlementAmount of the settlement file.A negative amount results in this parameter being set to zero, indicating no incoming funds to the escrow wallet.
FundsMissingAmount
integer
The difference between ActualSettlementAmount and the amount received on the escrow wallet

curl -X POST ".../v3.0/{ClientId}/payins/intents/settlements" \
-H "Authorization: Bearer token" \
-H "Content-Type: multipart/form-data" \
-F "file=@/example/file-path.csv"
{
    "SettlementId": "int_stlmnt_019778c1-fe45-7864-8d2c-c2394e0f105c",
    "Status": "UPLOADED",
    "CreationDate": 1750077669,
    "DeclaredIntentAmount": 0,
    "ExternalProcessorFeesAmount": 0,
    "ActualSettlementAmount": 0,
    "FundsMissingAmount": 0
}
I