---
title: "Initialize transaction"
method: POST
path: "/v1/transactions/initialize"
tags: ["Transactions"]
---

# Initialize transaction

`POST /v1/transactions/initialize`

## Request body

- InitiatePaymentRequest
  - `email` string, email, required
  - `firstName` string
  - `lastName` string
  - `phoneNumber` string
  - `localCurrency` 'NGN' | 'KES' | 'ZAR' | 'GHS' | 'XOF' | 'USD', required
  - `reference` string
  - `channels` string[]
  - `amount` number, required
  - `amountCurrency` 'settlement' | 'local'
  - `metadata` object
  - `redirectUrl` string
  - `feeBearer` 'MERCHANT' | 'CUSTOMER'
  - `taxChargeable` 'INCLUSIVE' | 'EXCLUSIVE'

## Response `201`

Transaction initialized.

- InitializeTransactionResponse
  - `status` boolean
  - `message` string
  - `code` integer
  - `data` unknown

---

[API](https://skmtc.net/kyshi/apis/kyshi-mor-public-api.md) · [All operations](https://skmtc.net/kyshi/apis/kyshi-mor-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kyshi/kyshi-mor-public-api/versions/3c46fabe8df7/schema)