---
title: "Link IBAN Orders"
method: POST
path: "/v3/orders/link"
tags: ["IBAN"]
---

# Link IBAN Orders

`POST /v3/orders/link`

This API allows you to assign an unmapped IBAN deposit to a registered user. 
Upon successfully linking the user, the system evaluates standard compliance checks. 
If all checks pass, the deposit is marked as fund_settled. 
If any check fails, the deposit remains in initiated

## Headers

- `MID` string

## Request body

- object
  - `orderId` string, required — Order ID of the created IBAN Order that we want to link with a existing User Record
  - `userId` string, required — User ID to identify the User Record that needs to be linked to the IBAN Order

## Response `200`

OK

- object
  - `status` string
  - `data` object
    - `orderId` string
    - `userId` string
    - `orderStatus` string
    - `message` string

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found

---

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