> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.tiankii.com/api-reference/tiankii-api-api-key/payment-requests/general-operations/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.tiankii.com/_mcp/server.

# Overview

## General operations — for any payment request type

**Type-agnostic** operations: they work on any payment request (payment link, invoice or subscription). The response is shaped by each record's `type` (`PaymentLinkResponseDto` or `BillingInvoiceResponseDto`).

Includes: list/filter, read coupons, lifecycle (activate, deactivate, archive, complete) and delete.

> Creation and update are **not** here: they are type-specific (see the *Payment Links* and *Invoices* subfolders).

Base: `/v1/payment-requests`. Scopes: `Merchant.payment_link.{read,update,delete}`.


## API Docs

- General Operations [List payment requests](https://docs.tiankii.com/api-reference/tiankii-api-api-key/payment-requests/general-operations/list.md)
- General Operations [List available apps](https://docs.tiankii.com/api-reference/tiankii-api-api-key/payment-requests/general-operations/list-available-apps.md)
- General Operations [Get associated app](https://docs.tiankii.com/api-reference/tiankii-api-api-key/payment-requests/general-operations/get-app.md)
- General Operations [List coupons](https://docs.tiankii.com/api-reference/tiankii-api-api-key/payment-requests/general-operations/list-coupons.md)
- General Operations [Activate payment request](https://docs.tiankii.com/api-reference/tiankii-api-api-key/payment-requests/general-operations/activate.md)
- General Operations [Deactivate payment request](https://docs.tiankii.com/api-reference/tiankii-api-api-key/payment-requests/general-operations/deactivate.md)
- General Operations [Archive payment request](https://docs.tiankii.com/api-reference/tiankii-api-api-key/payment-requests/general-operations/archive.md)
- General Operations [Complete payment request](https://docs.tiankii.com/api-reference/tiankii-api-api-key/payment-requests/general-operations/complete.md)
- General Operations [Delete payment request](https://docs.tiankii.com/api-reference/tiankii-api-api-key/payment-requests/general-operations/delete.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.tiankii.com/api-reference/tiankii-api-api-key/payment-requests/general-operations/openapi.json)
- [OpenAPI YAML](https://docs.tiankii.com/api-reference/tiankii-api-api-key/payment-requests/general-operations/openapi.yaml)