> ## 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>

## 3 つのステータスとは？

| ステータス     | 意味                     | 支払いを受け付けるか |
| --------- | ---------------------- | ---------- |
| **アクティブ** | 公開中で共有済み               | はい         |
| **完了**    | 全額支払われた、または利用回数の上限に達した | いいえ        |
| **無効**    | 自分で無効化したか、期限が切れた       | いいえ        |

ステータスで一覧を絞り込めば、まだ出回っているものが分かります。

## 各リンクには何が表示されますか？

ダッシュボードはリンクをひとつの表にまとめます。列は次のとおりです。

| 列         | 表示内容                     |
| --------- | ------------------------ |
| **作成日**   | いつ作ったか                   |
| **リンク**   | 共有できる URL                |
| **金額**    | あなたが請求している額、決済トークン建て     |
| **ステータス** | アクティブ、完了、無効              |
| **有効期限**  | 支払いの受け付けを止める日、または **なし** |
| **受取額**   | それに対して実際に支払われた額          |
| **説明**    | 支払う側に見えるもの               |
| **アクション** | **表示**、**共有**、**無効化**    |

## リンクはどう無効化しますか？

<Steps>
  <Step title="管理 → 支払いリンク を開く">
    ウェブのダッシュボードで。
  </Step>

  <Step title="リンクを探す">
    一覧が長ければ **アクティブ** で絞り込みます。
  </Step>

  <Step title="無効化する">
    ステータスが **無効** になり、ただちに支払いの受け付けを止めます。
  </Step>
</Steps>

<Warning>
  無効化は一方通行です。無効になったリンクは再度有効化できません。新しく作り直してください。

  また、URL を取り消すわけでもありません。リンクを持っている人は URL を持ったままで、動かなくなるだけです。公開ページに載せている場合は、そちらからも取り下げてください。
</Warning>

## リンクを自動で閉じさせる

Moove Widget で作成したリンクは **支払いを 1 回だけ受け付け、期限切れになりません**。全額支払われた時点で完了するので、請求書用のリンクは自動で片付きます。

[API](/api-reference/moove-receive/moove-payment-links) で作成したリンクでは、さらに 2 つの制限を設定できます。

* **`maxUsage`** — 完了するまでに受け付ける支払いの回数。
* **`expirationDate`** — 支払いの受け付けを止める日時。期限を過ぎたリンクは **無効** になります。

<Tip>
  請求書なら Moove Widget のリンクで十分です。1 回しか支払えないからです。期限も必要なら、API で `expirationDate` を指定してリンクを作成してください。
</Tip>

## Moove Transactions との突き合わせ

リンク経由の支払いはすべて、そのリンクの ID に紐づいています。ID はウェブの取引テーブルには表示されないため、そこでは説明で突き合わせてください。あるいは API でリンク ID を使って突き合わせます。

[Moove Transactions →](/ja-jp/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="/ja-jp/transact/moove-receive">
    次のリンクを作る。
  </Card>

  <Card title="Moove API Keys" icon="key" href="/ja-jp/manage/moove-api-keys">
    コードでリンクを作る。
  </Card>

  <Card title="Moove Transactions" icon="list" href="/ja-jp/manage/moove-transactions">
    何が支払われたか見る。
  </Card>
</CardGroup>

すべてのリンクを、きちんと把握。あなたのお金。あなたの一手。