---
title: "Create a settlement file"
method: POST
path: "/api/v1.4/reconciliations/settlement-files/"
tags: ["v1.4"]
---

# Create a settlement file

`POST /api/v1.4/reconciliations/settlement-files/`

Creates a new settlement file and returns a presigned URL for uploading. After uploading the file to the presigned URL, the client must call the confirm upload endpoint to confirm that the file has been uploaded and is ready to be processed.

## Request body

- SettlementFileInit
  - `id` string — File id - Returned after creating the settlement file instance, used for confirming the upload
  - `template_type` 'CHECKOUTCOM' | 'PAYFORT_MAGNATI' | 'TAP_CHARGE' | 'TAP_REFUND' | 'PEACH_PAYMENTS', required — Type of the settlement file being uploaded. This determines the expected format of the file and how it will be processed. Supported types are: CHECKOUTCOM, PAYFORT_MAGNATI, TAP_CHARGE, TAP_REFUND, PEACH_PAYMENTS * `CHECKOUTCOM` - CHECKOUTCOM * `PAYFORT_MAGNATI` - PAYFORT_MAGNATI * `TAP_CHARGE` - TAP_CHARGE * `TAP_REFUND` - TAP_REFUND * `PEACH_PAYMENTS` - PEACH_PAYMENTS
  - `file_name` string, required — Name of the settlement file being uploaded, including extension.
  - `upload_url` string, required — Presigned URL to which the settlement file should be uploaded. This is returned after creating the settlement file instance.

## Response `201`

- SettlementFileInit
  - `id` string — File id - Returned after creating the settlement file instance, used for confirming the upload
  - `template_type` 'CHECKOUTCOM' | 'PAYFORT_MAGNATI' | 'TAP_CHARGE' | 'TAP_REFUND' | 'PEACH_PAYMENTS', required — Type of the settlement file being uploaded. This determines the expected format of the file and how it will be processed. Supported types are: CHECKOUTCOM, PAYFORT_MAGNATI, TAP_CHARGE, TAP_REFUND, PEACH_PAYMENTS * `CHECKOUTCOM` - CHECKOUTCOM * `PAYFORT_MAGNATI` - PAYFORT_MAGNATI * `TAP_CHARGE` - TAP_CHARGE * `TAP_REFUND` - TAP_REFUND * `PEACH_PAYMENTS` - PEACH_PAYMENTS
  - `file_name` string, required — Name of the settlement file being uploaded, including extension.
  - `upload_url` string, required — Presigned URL to which the settlement file should be uploaded. This is returned after creating the settlement file instance.

## Other responses

- `400`
- `401`

---

[API](https://skmtc.net/moneyhash/apis/moneyhash-api.md) · [All operations](https://skmtc.net/moneyhash/apis/moneyhash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/moneyhash/moneyhash-api/revisions/111e4c2e0826/schema)