---
title: "Create a scan-to-pay session (a human pays by card via QR when there is no wallet)."
method: POST
path: "/pay/sessions"
tags: ["Provision"]
---

# Create a scan-to-pay session (a human pays by card via QR when there is no wallet).

`POST /pay/sessions`

## Request

- Base URL: `https://api.stacktr.ee`
- URL: `https://api.stacktr.ee/pay/sessions`
- Auth: one of:
  - none
  - HTTP bearer

No wallet, no account required. Returns a short pay URL, a terminal-printable QR, and a poll URL. A human scans and pays by card; the agent polls and continues mid-task. Paying above the price leaves a prepaid balance future paid actions draw from silently.

## Request body

- object
  - `feature` string: provision | topup | make_permanent | custom_domain | higher_limits
  - `amount_minor` integer: Optional amount in minor units; surplus becomes a prepaid balance.

## Response `201`

Session created.

- object
  - `code` string
  - `url` string
  - `qr` string
  - `amount` string

---

[API](https://skmtc.dev/stacktr/apis/stacktree-api.md) · [All operations](https://skmtc.dev/stacktr/apis/stacktree-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stacktr/apis/stacktree-api/revisions/5878cce46977?raw)