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

# Create a transaction

`POST /api/InstantSettlement/{instantSettlementNumber}`

## Request

- Base URL: `https://partners.staging-youlendapi.com/instantsettlement`
- URL: `https://partners.staging-youlendapi.com/instantsettlement/api/InstantSettlement/{instantSettlementNumber}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://youlend-stag.eu.auth0.com/oauth/token`

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/youlend-third-party-instant-settlement-api.md) - [All operations](https://skmtc.dev/youlend/apis/youlend-third-party-instant-settlement-api/llms.txt) - [OpenAPI document](https://skmtc.dev/youlend/apis/youlend-third-party-instant-settlement-api/revisions/68784baa0d13?raw)