---
title: "Create a payment session"
method: POST
path: "/terminal/payment-session"
tags: ["payment-session"]
---

# Create a payment session

`POST /terminal/payment-session`

Initialization of a payment session will trigger a payment authorization user experience on the paired Authsignal payment terminal application.

## Request body

- object
  - `amount` number — The amount intended to be authorized at the terminal.
  - `reference` string — A reference identifier originating from the point of sale system.
  - `currency` string — The currency intended to be authorized at the terminal.

## Response `200`

OK

- PaymentSession
  - `challengeId` string — The ID of the payment session.
  - `status` 'PENDING' | 'COMPLETED' | 'EXPIRED' | 'FAILED'
  - `reference` string — A reference identifier originating from the point of sale system.

## Other responses

- `400` — Invalid Request
- `401` — Unauthorized

---

[API](https://skmtc.dev/authsignal/apis/call-connect-api.md) · [All operations](https://skmtc.dev/authsignal/apis/call-connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/authsignal/call-connect-api/revisions/5604d744e3ad/schema)