---
title: "Upload payment file and store valid payments"
method: POST
path: "/payment-files"
tags: ["File Upload"]
---

# Upload payment file and store valid payments

`POST /payment-files`

Uploads the payment file and store the valid files extracted payments for later creating payments

## Request body

- PaymentfileuploadFileUploadRequest — File upload request body
  - `fileName` string, required — Original file name
  - `content` string, required — The file content must be zipped using gzip format and then Base64 encoded
  - `submissionType` 'BATCH' | 'BULK' — BATCH restricts operations to batch level. BULK (default) allows payment level operations such as approval
  - `processingDate` string — Allows overriding the file processing date

## Response `200`

File upload response with the file bid

- PaymentfileuploadFileUploadResponse
  - `fileId` string, required — Unique id of the uploaded file

## Other responses

- `400` — Invalid upload content or file size exceeded
- `500` — 500 error code is issued when problem occurred during decoding and decompressing file content

---

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