---
title: "Create a transaction"
method: POST
path: "/api/InstantSettlement/{instantSettlementNumber}"
tags: ["InstantSettlement"]
---

# Create a transaction

`POST /api/InstantSettlement/{instantSettlementNumber}`

When a 4xx client error occurs, response body may have schema YL.Domain.Messages.ResultWrapper
and contain more details on the error.<br /><br /><b>Possible values of YL.Domain.Messages.ResultWrapper.ErrorType for this endpoint:</b><br /><br /><b>2</b> - Instant settlement not found<br /><b>4</b> - Attempted to create a transaction on an Instant Settlement for which automatic creation of loans is disabled.<br /><b>5</b> - CurrencyISOCode for the requested transaction does not match the CurrencyISOCode on the Instant Settlement.<br /><b>6</b> - Attempted to create transaction with YL.Web.Api.ThirdParty.Loan.InstantSettlement.Models.CreateInstantSettlementTransactionModel.TotalSettlementAmount equal to 0.<br /><b>7</b> - Attempted to create a transaction that was not from today.<br /><b>8</b> - The size of the requested transaction is too large.<br /><b>9</b> - A transaction with the same transaction reference has already been created recently (within last 50 created transactions).<br /><br />
Sample request:
    POST /api/InstantSettlement/30000001
    {
        "transactionReference": "ref",
        "currencyISOCode": "GBP",
        "totalSettlementAmount": 10000,
        "transactionDate" : "2020-02-16T18:25:43-05:00"
    }

## Path parameters

- `instantSettlementNumber` integer, required

## Headers

- `api-version` string

## Request body

- CreateInstantSettlementTransactionModel — Model for creating an instant settlement transaction
  - `transactionReference` string, required — Gets or sets a transaction reference that will be shown in the account where the funds are transfered. This is a string of maximum 35 characters (a-zA-Z0-9/-?:.+ blank/space). It needs to be unique for each transaction request.
  - `currencyISOCode` string, nullable — Gets or sets Currency ISO code string
  - `totalSettlementAmount` number, double — Gets or sets Total settlement amount
  - `transactionDate` string, date-time — Gets or sets transaction date (needs to be within the settlement cycle length specified for each Instant Settlement)

## Response `200`

Instant settlement transaction successfully created

- InstantSettlementTransactionDetailsModel[]
  - `instantSettlementNumber` integer — Gets or sets the InstantSettlementNumber
  - `instantSettlementTransactionNumber` integer — Gets or sets transaction number, a unique identifier of the transaction for the corresponding InstantSettlementNumber

## Other responses

- `400` — Something went wrong!
- `401` — Unauthorized request
- `403` — Forbidden request
- `404` — Instant settlement not found
- `422` — CreateInstantSettlementTransactionModel from request body failed validation
- `500` — Servers are unavailable

---

[API](https://skmtc.dev/youlend/apis/prequalification.md) · [All operations](https://skmtc.dev/youlend/apis/prequalification/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/youlend/prequalification/revisions/a76313c6cc3d/schema)