MonstarX で Paddle を使う
要点「バックエンド」→「クラウド」の Paddle の行で「サンドボックス」か「本番」を選び、Paddle の API キーを貼り付けます。MonstarX のエージェントが Paddle の商品、顧客、取引、サブスクリプションを読み取れるようになり、たとえば実際の商品に合った料金ページを作れます。読み取るだけで、Paddle の内容を変えることはありません。
商品、顧客、サブスクリプションを調べます。
- 種類
- ビジネスツール · API キー
- カテゴリ
- 決済と請求
- 接続方法
- API キー
Paddle は、ソフトウェアやデジタル商品をあなたに代わって販売し、請求、税金、サブスクリプションを引き受けるサービスです。API キー（ソフトウェアがあなたのアカウントを使うための、パスワードのようなコード）で Paddle のアカウントを接続すると、あなたがチャットしている AI である MonstarX のエージェントが、作業中に商品カタログや請求データを読めるようになります。実際の商品から料金ページを作ったり、購読者がどのプランを使っているかをまとめたりできます。
これはビジネスツールです。MonstarX があなたの代わりに Paddle を読みます。作っているアプリがあなたのキーを受け取ることはありません。アプリで決済を受け付けるには、Stripe をご覧ください。
MonstarX にできること
Section titled “MonstarX にできること”| MonstarX ができること | 使える場面 |
|---|---|
| 商品を一覧 | どのモードでも |
| 顧客を一覧 | どのモードでも |
| 取引を一覧 | どのモードでも |
| サブスクリプションを一覧 | どのモードでも |
一覧は一度に 20件（最大 30件）ずつで、MonstarX はページをめくって続きを読めます。決してしないこと：商品、価格、顧客、取引、サブスクリプション、返金の作成・変更・キャンセル。
- Paddle のアカウント。サンドボックスのアカウントにはテストデータが、本番のアカウントには実際のデータがあります。この 2つは別のアカウントで、キーも別です。
- MonstarX のプロジェクトのオーナーであること。ツールを接続・接続解除できるのはオーナーだけです。
キーを取得する
Section titled “キーを取得する”-
接続したい Paddle（サンドボックスまたは本番）で Developer Tools > Authentication に移動し、API keys タブを開きます。
-
New API key をクリックし、
MonstarXのような名前を付けます。 -
読み取り権限
product.read、customer.read、transaction.read、subscription.readを付けます。MonstarX に必要なのはこれだけで、書き込み権限は使いません。 -
有効期限を設定し（Paddle の初期値は 90日）、保存してキーをコピーします。サンドボックスのキーは
pdl_sdbx_apikey_、本番のキーはpdl_live_apikey_で始まります。
Paddle 公式のガイド：Create and manage API keys
MonstarX で接続する
Section titled “MonstarX で接続する”-
プロジェクトを開き、上部バーの バックエンド をクリックしてから クラウド を開きます。
-
コネクタ までスクロールし、Paddle を見つけて 接続 をクリックします。
-
キーに合わせて サンドボックス か 本番 を選び、キーの入力欄に貼り付けて 接続 をクリックします。
-
MonstarX が Paddle でキーを確認します。問題がなければ、行に サンドボックス に接続中 または 本番 に接続中 と表示されます。キーと環境が合っていないと Paddle が拒否し、何も保存されません。
MonstarX に頼んでみる
Section titled “MonstarX に頼んでみる”| 入力する内容 | どうなるか |
|---|---|
| 「Paddle の商品を読んで、そのプランと名前で料金ページを作って」 | MonstarX が商品を一覧し、ビルドモードならそれをもとにページを作ります。 |
| 「Paddle に有効なサブスクリプションはいくつある？どのプラン？」 | サブスクリプションをページごとに読み、チャットで集計します。 |
| 「Paddle の直近 20件の取引を見て、いちばん売れている商品を教えて」 | 取引を読んで答えます。 |
セキュリティとプライバシー
Section titled “セキュリティとプライバシー”- MonstarX の中だけに保管。 キーは MonstarX のサーバーで暗号化して保存されます。アプリのコードに書き込まれることも、アプリに渡されることもありません。
- 読み取り専用。 MonstarX が Paddle に求めるのは一覧だけです。キーに読み取り権限だけを付けておけば、万一漏れても請求の内容を変えられることはありません。
- 機密データ。 顧客や請求の情報は非公開のものとして、また情報として扱い、指示としては扱いません。
- いつでも接続を解除。 バックエンドクラウド で Paddle の横にある 接続を解除 をクリックし、このプロジェクトから Paddle の接続を解除しますか？ で確定します。MonstarX はキーを破棄します。不要になったキーは Paddle でも無効にしてください。
知っておくと便利なこと
Section titled “知っておくと便利なこと”- 作っている間は サンドボックス で始め、あとで切り替えましょう。切り替えるには、接続を解除してから本番のキーで接続し直します。
- Paddle でキーの有効期限が切れると、MonstarX のリクエストは失敗します。新しいキーを作成して、接続し直してください。
- 1つのプロジェクトに接続できる Paddle アカウントは、一度に 1つです。
よくある質問
Section titled “よくある質問”これでアプリから Paddle の決済を受け付けられますか？
いいえ。この接続は、MonstarX のエージェントが Paddle のデータを読むためのものです。アプリで決済を受け付けるには、MonstarX の Stripe コネクタを使えます。ほかの決済サービスを使う場合は、キーを バックエンド → シークレット に追加し、MonstarX に作成を頼んでください。
キーにはどの権限が必要ですか？
product.read、customer.read、transaction.read、subscription.read です。MonstarX に読ませたくないものは外してください。その一覧が失敗するだけです。
MonstarX が返金やサブスクリプションのキャンセルをすることはありますか？
ありません。できるのは商品、顧客、取引、サブスクリプションの一覧だけです。
キーが拒否されたのはなぜですか？
多くの場合、キーがもう一方の環境のものです。pdl_sdbx_ のキーには サンドボックス、pdl_live_ のキーには 本番 が必要です。期限切れや無効化されたキーも拒否されます。