> 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/payment-links/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.tiankii.com/_mcp/server.

# Overview

## Payment Links — Base: `/v1/payment-requests/links`

A **payment link** is a **hosted, shareable payment page**: created once and able to collect one or many payments, with branding (CSS/colors), buyer fields to collect (contact, email, phone, address), fixed or ranged quantity, security PIN, partial payments, coupons and more.

Here you **create and update** the link (type `PAYMENT_LINK`). Every other operation —list, pay, activate/deactivate, archive, complete, delete, PDF statement, coupons— uses the common `/payment-requests` routes (*General operations* subfolder).

Scopes: `Merchant.payment_link.{create,update}`.


## API Docs

- Payment Links [Create payment link](https://docs.tiankii.com/api-reference/tiankii-api-api-key/payment-requests/payment-links/create.md)
- Payment Links [Update payment link](https://docs.tiankii.com/api-reference/tiankii-api-api-key/payment-requests/payment-links/update.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/payment-links/openapi.json)
- [OpenAPI YAML](https://docs.tiankii.com/api-reference/tiankii-api-api-key/payment-requests/payment-links/openapi.yaml)