---
title: "Create transaction"
method: POST
path: "/transactions"
tags: ["Transactions"]
---

# Create transaction

`POST /transactions`

Enables the client to apply debit or credit transactions to an account. For example to apply a fee or provide a credit for a charge.

## Headers

- `unique-request-id` string

## Request body

- CreateTransactionDto
  - `account_id` integer — Account ID
  - `amount` number — Transaction amount
  - `transaction_type_id` integer — This field identifies the type of the transaction that is registered under the balance. Example transactions: 16 - Debit – Fee External 32 – Credit – Credit Adjustment 51 – Credit - Repayment
  - `description` string — Description of the transaction
  - `transaction_reference` string — Optional client reference, if provided it must be unique
  - `settled` string — Insert “Y” to confirm transaction is settled
  - `total_fee_bill` number
  - `merchant_category_code` string

## Response `200`

Transaction was created successfully.

## Other responses

- `403` — Invalid request body or validation error.
- `404` — Unexpected error.

---

[API](https://skmtc.net/paymentology/apis/payapi-docs.md) · [All operations](https://skmtc.net/paymentology/apis/payapi-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paymentology/payapi-docs/versions/a675891b0365/schema)