> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moove.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Moove Payment Links

> 만든 결제 링크를 모두 추적하고, 무엇이 결제되었는지 확인하고, 더는 살려두고 싶지 않은 것을 비활성화하세요.

공유한 모든 링크와 그 링크가 받아낸 것을 보고, 다 끝난 것은 닫으세요.

<Info>
  **웹 전용.** 결제 링크는 Moove Widget에서 만들고 [moove.xyz/dashboard/payment-link](https://www.moove.xyz/dashboard/payment-link)에서 관리합니다. Moove App에는 결제 링크 화면이 없으며, **받기** 화면이 대신 핸들과 QR 코드를 공유합니다.
</Info>

## 세 가지 상태는?

| 상태      | 의미                   | 결제 수락 |
| ------- | -------------------- | ----- |
| **활성**  | 살아 있고 공유됨            | 예     |
| **완료됨** | 전액 결제되었거나 사용 한도에 도달함 | 아니요   |
| **비활성** | 직접 비활성화했거나 만료됨       | 아니요   |

상태로 목록을 걸러 아직 밖에 나가 있는 것을 확인하세요.

## 각 링크는 무엇을 보여주나요?

대시보드는 링크를 하나의 표로 나열합니다. 표의 열은 다음과 같습니다.

| 열       | 보여주는 것                   |
| ------- | ------------------------ |
| **생성일** | 만든 시점                    |
| **링크**  | 공유 가능한 URL               |
| **금액**  | 요청하는 금액, 정산 토큰 기준        |
| **상태**  | 활성, 완료됨, 비활성             |
| **만료일** | 결제 수락을 멈추는 시점, 또는 **없음** |
| **수신됨** | 이 링크로 실제 결제된 금액          |
| **설명**  | 결제하는 사람이 보는 내용           |
| **동작**  | **보기**, **공유**, **비활성화** |

## 링크를 어떻게 비활성화하나요?

<Steps>
  <Step title="관리 → 결제 링크 열기">
    웹 대시보드에서.
  </Step>

  <Step title="링크 찾기">
    목록이 길면 **활성**으로 걸러내세요.
  </Step>

  <Step title="비활성화하기">
    상태가 **비활성**이 되고 즉시 결제 수락을 멈춥니다.
  </Step>
</Steps>

<Warning>
  비활성화는 되돌릴 수 없습니다. 비활성 링크는 다시 활성화할 수 없으니 새로 만드세요.

  또한 이미 보낸 URL을 회수하지도 않습니다. 링크를 가진 사람은 URL을 계속 갖고 있고, 다만 작동하지 않을 뿐입니다. 링크가 공개된 페이지에 있다면 거기서도 내려주세요.
</Warning>

## 링크가 스스로 닫히게 하기

Moove Widget에서 만든 링크는 **결제를 한 번만 받고 만료되지 않습니다**. 전액 결제되는 즉시 완료되므로, 청구서 링크는 저절로 정리됩니다.

[API](/api-reference/moove-receive/moove-payment-links)로 만든 링크는 두 가지 한도를 추가로 정할 수 있습니다.

* **`maxUsage`** — 링크가 완료되기 전까지 받을 수 있는 결제 횟수.
* **`expirationDate`** — 결제를 더 이상 받지 않는 시점. 만료가 지난 링크는 **비활성**이 됩니다.

<Tip>
  청구서라면 Moove Widget 링크로 이미 충분합니다. 한 번만 결제할 수 있기 때문입니다. 기한도 필요하다면 `expirationDate`를 넣어 API로 링크를 만드세요.
</Tip>

## Moove Transactions와 대조하기

링크로 이루어진 모든 결제는 그 링크의 ID와 연결됩니다. 웹의 거래 내역 표에는 ID가 표시되지 않으므로, 거기서는 설명으로 맞추거나 API에서 링크 ID로 맞추세요.

[Moove Transactions →](/ko-kr/manage/moove-transactions)

## 코드로는 어떻게 하나요?

API는 같은 상태와 같은 필드로 링크를 나열하며, 대시보드에서 만든 것이나 계정의 다른 키가 만든 것도 포함합니다 — 그래서 대조하기에 적합한 엔드포인트입니다.

```bash theme={null}
curl -sS "https://api.moove.xyz/v1/payment-link?status=active" \
  -H "X-API-Key: $MOOVE_API_KEY"
```

<Note>
  API는 링크를 만들고 읽을 수 있습니다. 링크 비활성화는 대시보드에서 하는 작업입니다.
</Note>

[Moove Payment Links API →](/api-reference/moove-receive/moove-payment-links)

## 다음에 읽을 것

<CardGroup cols={3}>
  <Card title="Moove 받기" icon="hand-coins" href="/ko-kr/transact/moove-receive">
    다음 링크 만들기.
  </Card>

  <Card title="Moove API Keys" icon="key" href="/ko-kr/manage/moove-api-keys">
    코드로 링크 만들기.
  </Card>

  <Card title="Moove Transactions" icon="list" href="/ko-kr/manage/moove-transactions">
    무엇이 결제되었는지 보기.
  </Card>
</CardGroup>

모든 링크를 빠짐없이. 당신의 돈. 당신의 선택.