---
title: "Initialize a payment"
method: POST
path: "/payments"
---

# Initialize a payment

`POST /payments`

## Request body

- union
  - object
    - `amount` number, required
    - `currency` string, required
    - `email` string, required
    - `phone` string
    - `customer` union
      - string
      - object
        - `name` string
        - `email` string
        - `phone` string
    - `description` string
    - `reference` string
    - `callback` string
    - `locked_currency` string
    - `locked_channel` string
    - `locked_country` string
    - `items` object[]
    - `shipping` object
    - `address` object
    - `customer_meta` object
  - object
    - `amount` number, required
    - `currency` string, required
    - `email` string
    - `phone` string, required
    - `customer` union
      - string
      - object
        - `name` string
        - `email` string
        - `phone` string
    - `description` string
    - `reference` string
    - `callback` string
    - `locked_currency` string
    - `locked_channel` string
    - `locked_country` string
    - `items` object[]
    - `shipping` object
    - `address` object
    - `customer_meta` object
  - object
    - `amount` number, required
    - `currency` string, required
    - `email` string
    - `phone` string
    - `customer` union, required
      - string
      - object
        - `name` string
        - `email` string
        - `phone` string
    - `description` string
    - `reference` string
    - `callback` string
    - `locked_currency` string
    - `locked_channel` string
    - `locked_country` string
    - `items` object[]
    - `shipping` object
    - `address` object
    - `customer_meta` object

## Response `201`

Payment initialized

- object
  - `status` string, required
  - `message` string, required
  - `code` integer, required
  - `authorization_url` string

## Other responses

- `401` — Unauthorized
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/notchpay/apis/notch-pay-api.md) · [All operations](https://skmtc.net/notchpay/apis/notch-pay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/notchpay/notch-pay-api/versions/483106380733/schema)