---
title: "Initialize payment link"
method: POST
path: "/v1/pay/initialize"
tags: ["Payment Links"]
---

# Initialize payment link

`POST /v1/pay/initialize`

## Request body

- InitializePaymentLinkRequest
  - `customer` CustomerInput, required
    - `email` string, email, required
    - `firstName` string
    - `lastName` string
    - `phoneNumber` string
  - `expiresAt` string, date-time, required
  - `localCurrency` 'NGN' | 'KES' | 'ZAR' | 'GHS' | 'XOF' | 'USD', required
  - `description` string, required
  - `metadata` LineItem[], required
    - `name` string, required
    - `amount` number, required
    - `quantity` number, required
  - `feeBearer` 'MERCHANT' | 'CUSTOMER'
  - `taxChargeable` 'INCLUSIVE' | 'EXCLUSIVE'
  - `taxEnabled` boolean

## Response `201`

Payment link created.

- GenericResponse
  - `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)