---
title: "Create transaction"
method: POST
path: "/simulator/{connected_account_id}/transactions"
tags: ["Bank Simulator"]
---

# Create transaction

`POST /simulator/{connected_account_id}/transactions`

Create a transaction to test your integration. This endpoint can only be used in the sandbox environment.

## Path parameters

- `connected_account_id` string, uuid, required

## Request body

- object[]
  - `amount` integer, required — The absolute value of the transaction, in the specified currency's smallest unit.
  - `currency` string — The three-letter ISO 4217 currency code, in lowercase.
  - `direction` 'debit' | 'credit', required — The direction of the transaction, either `debit` or `credit`.
  - `type` 'credit_transfer' | 'direct_debit' | 'instant_credit_transfer', required — The type of the transaction.
  - `account_servicer_reference` string, required — The account servicer reference.
  - `reference` string — The reference.
  - `booking_date` string, date — The date when a transaction is registered on the account.
  - `value_date` string, date — The date when a transaction is effectively credited or debited on the account.
  - `bank_data` object
    - `end_to_end_id` string — The end to end ID.
    - `transaction_id` string — The transaction ID.
    - `instruction_id` string — The instruction ID.
    - `payment_information_id` string — The payment information ID.
  - `external_account_id` string — The ID of the external account linked to the transaction.
  - `external_account` object — The external account, which is either the debtor or the creditor depending on the transaction's `direction`.
    - `account_number` string, required — The external account number, which can be the IBAN or any other identification provided by the bank.
    - `holder_name` string, required — The name of the external account holder.
  - `internal_account_id` string — The ID of the internal account linked to the transaction.
  - `internal_account` object — The internal account, which is either the debtor or the creditor depending on the transaction's `direction`.
    - `account_number` string, required — The account number of the internal account, which is a virtual account number.

## Response `200`

Transaction was successfully created.

- SimulatorV2Response
  - `files` object[], required — The created files
    - `file_id` string, uuid — The created file ID. This field will be available only in some particular case like instant incoming payments.
    - `file_name` string, required — The created file name.
    - `created_at` string, date-time, required — The UTC timestamp representing the moment we ingested the file.

## Other responses

- `400` — Bad request. Validation error or missing required fields.
- `401` — Unauthorized. API key is missing or invalid.
- `403` — Forbidden. Feature is not enabled for this API key.

---

[API](https://skmtc.net/numeral/apis/payments.md) · [All operations](https://skmtc.net/numeral/apis/payments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/numeral/payments/versions/220f101cc2ef/schema)