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

# AgencyHandyでStripeを接続してオンライン支払いを受け付ける

> StripeアカウントをAgencyHandyに連携させ、プラットフォームを離れることなくクライアントに請求書を送信し、安全なオンライン決済を収集します。

AgencyHandyのStripe連携により、プラットフォーム内で送信する請求書を通じて、クライアントからカード支払いを直接受け取ることができます。接続後、クライアントにはStripeがホストするなじみのあるチェックアウト画面が表示され、支払い状態はAgencyHandyに自動的に同期されます — 手動での照合は不要です。

<Note>
  Stripe連携の接続または管理ができるのは **スーパー管理者** と **管理者** ロールのみです。また、開始前に適切な権限を持つ認証済みのStripeアカウントが必要です。
</Note>

## Stripeを接続する

<Steps>
  <Step title="Stripe連携の設定を開く">
    左サイドバーで **連携 → Stripe連携** に移動します。
  </Step>

  <Step title="Stripeで認証する">
    **Stripeを接続** をクリックします。Stripeの認証画面にリダイレクトされます。Stripeアカウントにサインインし、**許可** をクリックしてAgencyHandyへのアクセスを許可します。承認されると、StripeはAgencyHandyに自動的にリダイレクトします。
  </Step>

  <Step title="支払い設定を構成する">
    リダイレクト後、以下のオプションを設定します：

    * **通貨** — ワークスペースのデフォルト請求通貨を選択します。
    * **支払い方法** — Stripeアカウントでサポートされているカードタイプ（Visa、Mastercardなど）を有効または無効にします。
    * **請求設定** — オプションで税率、請求書のプレフィックス、またはデフォルトの支払い条件と支払期日を設定します。
  </Step>

  <Step title="保存して確認する">
    **保存** をクリックします。連携が有効になると確認バナーが表示されます。Stripeがワークスペースとリンクされたことでクライアントがオンラインで請求書を支払えるようになります。
  </Step>
</Steps>

## 連携をテストする

ライブの請求書を送信する前に、クイックなエンドツーエンドテストを実行して接続が正しく機能していることを確認してください。

<Steps>
  <Step title="テスト請求書を作成する">
    AgencyHandy内でドラフト請求書を作成し、少額の金額を割り当てます。
  </Step>

  <Step title="自分自身に送信する">
    自分のメールアドレスまたはテストを手伝えるチームメンバーに請求書を送信します。
  </Step>

  <Step title="テスト支払いを完了する">
    請求書リンクを開き、Stripeアカウントがテストモードの場合はStripeテストカード（例：`4242 4242 4242 4242`）を使用して支払いを完了するか、ライブモードの場合は実際のカードを使用します。
  </Step>

  <Step title="状態の更新を確認する">
    AgencyHandyに戻り、請求書の状態が **支払い済み** に変更されたことを確認します。変更されていれば、連携は正しく機能しています。
  </Step>
</Steps>

## Stripe接続を管理する

**連携 → Stripe連携** にいつでも戻って以下の操作が可能です：

* **支払い設定を更新** — 通貨、支払い方法、または請求設定を変更します。
* **接続状態を確認** — Stripeが現在アクティブかどうかを確認します。
* **接続解除** — **接続解除** をクリックしてStripeアカウントのリンクを解除します。再接続するまで支払い収集は即座に停止します。
* **再接続** — **Stripeを接続** を再度クリックして、再認証により連携を復元します。

<Warning>
  Stripeを接続解除すると、すべての未払い請求書に対する支払い収集が停止します。再接続して再認証するまで、クライアントはオンラインで支払いができなくなります。
</Warning>

## 追加の注意事項

<Note>
  AgencyHandyは支払い認証情報を保存しません。すべての支払いデータはStripeの安全なインフラストラクチャのみによって処理されます。
</Note>

* **ワークスペースごとに1アカウント** — 各AgencyHandyワークスペースには1つのStripeアカウントのみ接続できます。アカウントを切り替えるには、まず現在のアカウントを接続解除してから、新しいアカウントで再接続してください。
* **ライブ請求書の状態** — Stripeにリンクされたすべての請求書は、Stripeから直接受信したリアルタイムの状態更新を継続して反映します。
* **通貨** — 支払いエラーを避けるために、AgencyHandyで設定した通貨がStripeアカウントで有効になっている通貨と一致していることを確認してください。