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

# PayPal

> ウェブサイトでPayPalの支払いとサブスクリプションを受け付けます。

PayPal決済の設定は、すべてLumiのチャットで行えます。依頼の中でPayPalを指定し、販売したいものを説明してください。

* 「電子書籍を一回払いの\$15で、PayPalで買えるようにして。」
* 「PayPalで請求する月額\$9.99のメンバーシップを追加して。」

PayPalアプリの認証情報があれば、LumiがPayPalのビジネスアカウント上で直接作業し、ウェブサイトに決済フロー全体を構築します。

* **一回払い**: 購入者をPayPalに移動させて支払いを承認してもらうPayPalボタンを作り、完了した支払いをデータベースに記録します。
* **サブスクリプション**: LumiがPayPalアカウントに商品とサブスクリプションプランを作成し(同じ名前と価格のものがあれば再利用します)、登録ボタンを追加して、各サブスクリプションのステータスを最新の状態に保ちます。
* **Webhook**: LumiがWebhookを登録し、支払いの完了や返金、サブスクリプションの有効化、解約、一時停止、更新の失敗をウェブサイトが受け取れるようにします。
* **料金ページとアクセス制限**: 有料コンテンツは、支払いを済ませた顧客にのみ表示されます。

PayPalアカウントについて、いつでもLumiに尋ねることもできます。たとえば「最近の取引を見せて」「サブスクリプションプランを一覧表示して」「この注文を返金して」「このサブスクリプションを解約して」のように依頼できます。

> [!NOTE]
>
> PayPalは、Webプロジェクトで利用できます。決済サービスを指定しない場合、Lumiは[Stripe](https://docs.lumi.new/ja/features/stripe.md)を使います。

## PayPalの認証情報を接続する

**1. PayPalでRESTアプリを作成する**

PayPal Developer Dashboardで**Apps & Credentials**に進み、RESTアプリを作成するか開きます。テストには**Sandbox**タブを、実際の支払いには**Live**タブを使います。アプリの**Client ID**と**Secret key**をコピーします。

**2. Lumiに認証情報を入力する**

Lumiがチャットに表示するPayPalの認証情報カードに入力するか、ワークスペースの**ツール**タブを開いて**PayPal**カードをクリックします。**PayPal client ID**と**PayPal client secret**を入力し、**Environment**(**サンドボックス（テスト）**または**本番**)を選んでから、**保存**と**確認**をクリックします。

> [!WARNING]
>
> 認証情報をチャットのメッセージに貼り付けないでください。認証情報はプロジェクトの[シークレット](https://docs.lumi.new/ja/features/secrets.md)に安全に保存されます。サンドボックスの認証情報はサンドボックス環境でのみ、本番の認証情報は本番環境でのみ使えます。この組み合わせの食い違いが、PayPalに認証情報を拒否される最もよくある原因です。

### Lumiが変更できる範囲を管理する

ツールタブの**PayPal**カードでは、PayPalアカウントを変更する操作ごとに、**常に許可**、**毎回確認**、**許可しない**のいずれかの承認設定があります。デフォルトでは、商品とプランの作成は許可され、**返金**と**サブスクリプションの解約**は毎回あなたの承認を求めます。取引の一覧表示などの読み取り専用の操作は、常に許可されます。

## テストと本番公開

**1. サンドボックスでテストする**

サンドボックスの認証情報では、実際のお金は動きません。PayPalのページでは、サンドボックスの購入者アカウントでログインします(PayPal Developer Dashboard → **Testing Tools** → **Sandbox Accounts** → Personalアカウントのメールアドレスとパスワード)。支払い後、支払いまたはサブスクリプションの記録が[クラウド → データ](https://docs.lumi.new/ja/features/databases.md)に表示され、ページに購入内容が表示されることを確認します。

**2. 本番に切り替える**

PayPalでLiveアプリを作成し、**PayPal**カードでそのClient IDとSecretを入力して、Environmentを**本番**に設定します。Lumiに本番への切り替えを依頼してください。サンドボックスの商品とプランは引き継がれないため、Lumiが本番アカウントにそれらを作り直し、Webhookを登録し直します。

**3. 最終テストと公開**

低価格の商品でもう一度テストしてから、ウェブサイトを公開して共有しましょう。

どの手順で問題が起きても、Lumiに伝えてください。PayPalアカウントと関数のログを確認して、問題を見つけて修正します。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.