01顧客の同意
明確な目的を持ったアクセス
顧客は、接続しているのか、AIを使用しているのか、購入を承認しているのかを理解します。
以下のときに検証可能：
認可フローを構築する トークンと操作は、意図されたアカウントとスコープを使用します。
SHAREAIで構築する
ShareAIで支払う: 同意からチェックアウトまで
顧客にAI使用、オプション料金、および各購入について明確な選択肢を提供します。顧客が理解し、制御できる支払いプロセスを構築しましょう。
あなたが設計する体験
ShareAIで支払う明確なアクセス。受諾された条件。確認された購入。
あなたの実装
説明と検証が可能な支払いフロー。
あなたの製品と実装の両方で、認可、受諾された条件、および確認された支払いを明確に保ちましょう。
02受諾された条件
従うことができる契約
理解可能なオファーを公開し、各顧客が受諾したバージョンを追跡します。
以下のときに検証可能：
オファーと契約を定義する 新しい条件は既存の顧客を黙って移行させません。
03確認済みの支払い
配送前の確認
意図された購入を1つ作成し、その支払い状況を確認してから履行します。
以下のときに検証可能：
チェックアウトフローを構築する 再試行、キャンセル、チェックアウトの拒否、制限が処理されます。
エディタに取り込む
エージェントと一緒に構築する。
実装目標、必要な入力、受け入れチェックを含む完全なガイドをコピーする。コード例、表、ドキュメントリンクを一緒に保持する。
完全ガイド実装コンテキスト検証チェック
必要な形式でプロジェクトの準備が整う。
更新済み
リファレンスを手動でコピーする
顧客が支払うものを選択する
アカウントの接続、AI使用の支払い、製品購入の確認を区別します。
作業場所 あなたの製品 → 支払い体験
Pay with ShareAI は、顧客が選択した ShareAI アカウントをアプリケーション内で使用できるようにします。請求フローは2つに分かれています：承認済みの認可の下での顧客負担のAIリクエスト、および顧客がチェックアウトで確認する製品購入。オプションの Builder マークアップは、AI使用に関する追加契約です。
| 顧客のアクション | 発生すること | 必要なアクセス |
|---|---|---|
| ウォレットを接続する | 選択されたアカウントと受諾された条件に対して認証を作成します。Connectをクリックしても製品は購入されません。 | openid アプリが使用する機能を含めて。 |
| AIリクエストを送信 | 認証されたアカウントの利用可能なAIクレジットと受諾された使用条件を使用します。 | 適用可能な推論アクセス; monetization_gateway 承認済みの Builder マークアップ条件に対して。 |
| 製品購入を確認 | 認証された確認後に特定の購入のみをデビットします。 | payments および成功した支払いリクエスト。 |
JamZY · 予約リファレンスアプリケーション スクリーンショットを拡大 ↗
- 予約タイプと期間を選択してください。
- 利用可能なデモスロットを選択してください。
- オプションのAIアシスタントを使用するにはShareAIを接続してください。
- AIはこの明示的なアクション後にのみ実行されます。予約だけではShareAIを呼び出しません。
JamZYのアポイントメントサンプルはAI使用ルートを示します。それには商人チェックアウトがなく、支払いスコープを要求せず、接続がサブスクリプションを購入することを主張しません。別の体験を追加する際には残りの章を使用してください。
次に進む準備が整いました。
ボタンと製品コピーは、顧客が接続しているのか、AIを使用しているのか、または購入を確認しているのかを示します。
顧客の認可を取得する
操作が使用される前に、対象の支払いアカウントから許可を取得します。
作業場所 コンソール → 使用例 → 顧客認証
- アプリケーションを作成し、オンボーディング、公開情報、プラットフォームコールバックを完了します。コンソールで関連する使用例を有効にします。
- Builder マークアップについては、そのアクセスリクエストを完了し、必要に応じて承認を待ちます。購入の場合は、Pay with ShareAI を有効にし、サブスクリプションで必要な支払いアクセス契約を設定します。
- Authorization Code + S256 PKCE を通じて有効なスコープをリクエストします。
paymentsは製品チェックアウト用、inferenceはネットワークコストでのAI用、monetization_gatewayは承認済みのAIマークアップ用に使用します。アプリケーションが実際に使用する機能のみをリクエストしてください。 - 顧客に正しい個人または組織アカウントを選択させ、表示された条件を受諾させます。追加スコープや変更された条件には再度認証が必要です。リフレッシュではそれらを付与しません。
ユースケース スクリーンショットを拡大 ↗
- ShareAIを使用したログインを構成します。
- 顧客資金による使用を有効化します。
クライアントIDはプラットフォームを識別します。アクセストークンは受諾された顧客認証を表します。契約バージョンは請求条件を記録します。これらのいずれも特定の製品支払いが確認されたことを単独で証明するものではありません。
次に進む準備が整いました。
トークンは対象の顧客に属し、これから実行する操作の許可を含みます。
オファーでAI料金を説明する
顧客が確認して受諾できる明確な使用条件を公開します。
作業場所 アプリケーション → サブスクリプション
サブスクリプションで明確に名前付けされたオファーを作成し、追加のAI料金を説明します。サブスクリプションIDは生成され、読み取り専用で、アプリケーションにスコープされています。これらのオファーはアプリのプラットフォームクライアント全体で共有されるため、WebとAndroidで異なる商業オファーを維持することはありません。
サブスクリプション · 概要 スクリーンショットを拡大 ↗
- 独自のエディターでオファーを作成してください。
サブスクリプション · オファーエディター スクリーンショットを拡大 ↗
- 顧客向けのオファー名を使用してください。
- このオファーのAI
surchargeを設定してください。
選択したモデルのネットワークコスト、追加料金、Builder収益を比較するためにEstimateを使用します。次の契約バージョンとしてレビュー済みドラフトを公開します。顧客は認証中にそのバージョンを受諾します。公開されたオファーは受諾された顧客契約と同じではありません。
製品 payments のみが必要な場合は、Builder マークアップを作成するのではなく、利用可能な無料の支払いアクセス契約フローを使用してください。固定サブスクリプション価格と間隔は、現在の使用オファーエディターでは設定されていません。AIオファーを自動的な定期請求と解釈しないでください。
次に進む準備が整いました。
あなたのオファーはAIコストに追加される内容を正確に説明します。顧客向けの同意画面には、同じ公開済みの条件が表示されます。
詳細が必要ですか？不変の請求契約 ↗
顧客に新しい条件を選択させる
各アカウントが受け入れた条件を追跡しながら、新しい契約を導入します。
作業場所 サブスクリプション → 契約
次の契約ドラフトで変更を準備します。既存の認可は、顧客が代替を受け入れるまで、受け入れられたサブスクリプションとバージョンを保持します。サブスクリプション概要でアカウント数と分布を比較し、すべてのアカウントが最新バージョンを使用していると仮定しないでください。
サブスクリプション · 契約 スクリーンショットを拡大 ↗
- 公開された契約バージョンを確認してください。
顧客に変更内容を伝え、必要に応じて新しいバージョンを受け入れるための同意フローを通じて送信します。更新されたトークンは同意を製造することはできません。受け入れられた契約を保持することがデフォルトの移行です。さらなるアクションの前に更新された同意を要求することを選択すると、顧客が新しい条件を承認するまで既存のアクセスが意図的に中断されます。公開前にその影響を確認してください。許可された減額は受け入れられた契約の規則に従う必要があります。料金の増額には顧客の承認が必要です。
アプリケーションレベルのビューとアイデンティティ境界を分離して保持します。プラットフォーム固有の顧客識別子は、商業的概要がアプリケーション全体を集約しても、クライアントコンテキストに限定されます。
次に進む準備が整いました。
各アカウントがどの契約を受け入れたかを特定し、それが次の契約に移行する方法を説明できます。
履行前に購入を確認する
意図された購入を1つ作成し、確認を取得し、配信前に支払いを検証します。
作業場所 あなたのバックエンド → ShareAI チェックアウト → 支払い検証
この章では、アポイントメント例を拡張し、別の製品購入を追加します。支払いを有効にし、そのスコープで顧客トークンを取得した後にのみ実行してください。注文と支払い状態をバックエンドに保持します。
# Real payment request: use scoped test access and an intentional amount.
curl --fail-with-body 'https://api.shareai.now/api/v1/console/builder/payments' \
-H "Authorization: Bearer $SHAREAI_ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: YOUR_UNIQUE_ORDER_REFERENCE' \
--data '{"title":"JamZY appointment preparation pack","amount":"1.00"}'- 返された支払いIDとチェックアウトURLを注文とともに保存します。正確な10進数の金額文字列を使用し、浮動小数点の金額計算を避けてください。
- 返されたチェックアウトURLを開きます。ShareAIは購入と支払者を提示します。顧客は、あなたのアプリを認可したアカウントを使用して確認する必要があります。チェックアウトを開くことはデビットを意味しません。
- 同じ顧客認可でAPIから支払いを読み取ります。支払いが確認済みの状態である場合のみ注文を履行します。
- 同じ意図された購入を同じ冪等性キーで再試行します。異なる購入には新しいキーが必要です。変更された条件でキーを再利用しないでください。
curl --fail-with-body --get \
'https://api.shareai.now/api/v1/console/builder/payments' \
-H "Authorization: Bearer $SHAREAI_ACCESS_TOKEN" \
--data-urlencode "id=$SHAREAI_PAYMENT_ID"| 支払い状態 | あなたの製品がすべきこと |
|---|---|
| 保留中 | 顧客確認がまだ必要であることを表示します。まだ履行しないでください。 |
| 支払われる | サーバーの注文と照合し、1回だけ履行します。 |
| 拒否済み | 決定を尊重し、顧客が別の購入を試みるかどうかを選択できるようにします。 |
| 期限切れ | 顧客が再試行を希望する場合、新しい冪等性キーで新しいリクエストを作成します。 |
信頼されたAPIから返されたチェックアウトURLのみを使用し、それを統合の許可された宛先ポリシーに対して検証してください。アプリへの復帰成功メッセージは支払いの証拠ではありません。支払者は自分自身のBuilderアカウントから購入することはできません。
既存の固定価格のサブスクリプション契約をサポートしている場合、支払いAPIは明示的に確認された期間のためにその受け入れられた条件を使用することができます。作り上げた定期的な価格を送信したり、新しい期間を黙って請求したりしないでください。JamZYのダウンロード可能なアポイントメントサンプルはその拡張機能を実装していません。
次に進む準備が整いました。
あなたのバックエンドが支払い済みを検証するまで注文は配達されません。また、確認フローを繰り返しても同じ注文を二度配達したり、デビットしたりすることはできません。
詳細が必要ですか？支払いエンドポイント & 応答リファレンス ↗
請求問題から顧客を回復させる
あなたはクレジット限度額と切断を重複請求や予期しないアカウント変更なしで処理します。
作業場所 あなたのアプリケーション → 請求回復
AI使用と製品購入には異なる適格クレジットルールがあります。アカウントには製品の支払いに使用できないAI適格クレジットがある場合があります。不足している資金やアプリケーションごとの支出制限をAPIエラーと顧客請求宛先を使用して処理してください。
顧客に選択された支払いアカウント、失敗したアクション、クレジットや制限を管理するルートを表示してください。顧客は自分自身の上限を管理します。アプリの所有者はそれを引き上げることはできません。成功させるために組織アカウントから個人アカウントに黙って切り替えないでください。
- 顧客管理はアプリケーションに集約されます。
切断は関連する認可を取り消し、ローカルセッションをクリアする必要があります。それは将来の認可されたリクエストを停止しますが、すでに確認された購入を元に戻したり、別の有料コミットメントを自動的にキャンセルしたりすることはありません。リフレッシュ失敗、認可取り消し、支払い期限切れには異なる回復メッセージが必要です。
次に進む準備が整いました。
不足クレジットと制限エラーは、顧客に情報を提供し、管理可能な状態を維持し、偶発的な重複注文や支払者変更を防ぎます。
完全な支払いプロセスを検証する
あなたは成功パスとその失敗ケースをテストし、プラットフォームを公開に含める前に確認します。
作業場所 OAuth設定 → 検証
アプリケーション全体のテスター名簿とBuilderとは異なる適格な支払いアカウントを使用してください。保留中の招待を含めて最大5つのテスター枠があります。公開に含まれるすべてのプラットフォームについて、実際のエンドポイントとスコープ検証を完了してください。
Web · 検証 スクリーンショットを拡大 ↗
- コンソールは実際のエンドポイント成功を記録します。
- 要求されたすべてのスコープも実行される必要があります。
- 認可が受け入れられた場合とキャンセルされた場合をテストし、選択された顧客/アカウントの境界を確認してください。
inferenceまたはmonetization_gatewayに対するスコープ付きAIリクエストの成功をテストし、paymentsに対する必要な成功した支払いAPIコールを確認します。支払いリクエストはデビットなしで保留中の場合があります。完全なチェックアウトテストでは、明示的な確認と支払いが追加で検証されます。- 重複リクエスト、拒否されたチェックアウト、期限切れチェックアウト、不足している適格クレジット、アカウント支出制限、期限切れトークン、リフレッシュローテーション、認可取り消しをテストしてください。
- 顧客、サブスクリプション、分析を確認し、結果として得られる顧客、受け入れられた条件、帰属された活動を確認してください。顧客向けUIに機密資格情報や内部組織IDが表示されないことを確認してください。
- 構成と記録されたチェックが合格したプラットフォームのみを含めてください。未完成のプラットフォームは除外するか削除してください。その後、Dashboardからアプリを提出してください。
次に進む準備が整いました。
あなたの統合は、承認されたアクセス、承認された条件、要求された支払い、確認された支払いを区別し、それぞれの失敗パスを処理します。
組織検証とプログラムアクセス
プログラム登録を適用する前に、個人または組織アカウントを選択して所有者を指定します。組織は検証前に申請を提出できますが、スタッフの承認だけではアクセスが有効化されません。Consoleのオンボーディングチェックリストで組織のメールと会社の検証を完了してください。承認された組織は、両方のチェックが完了するまで「Pending verification」の状態のままです。Builder、Provider、およびCreatorプログラムはこのルールに従います。
Monetization Gateway 価格設定を表示 · ShareAI for Startups を探索する · スコープと権限
権限と受け入れられた条件
公開された利用規約、プライバシーポリシー、および削除手順はアプリケーションと一致し、サインインなしでアクセス可能な状態を維持する必要があります。ShareAI プログラム受け入れ、Monetization Gateway 承認、顧客のOAuth許可、および受け入れられた請求契約は別々の決定です。リフレッシュでは権限を追加したり、新しい商業条件を受け入れたりすることはできません。
レガシーsurchargeスコープは既存の統合で引き続き受け入れられます。新しい例ではmonetization_gatewayを使用します。surcharge_bpsやsurcharge_percentageなどの既存のワイヤフィールドは変更せずに保持してください。
Monetization Gateway 価格設定を表示 · ShareAI for Startups を探索する · スコープと権限
ゲートウェイ料金とStartupサポート
標準料金 5% は Builder のマークアップです。AIネットワークコストの €2.00 と 10% のマークアップに対して、顧客は €2.20 を支払います。ShareAI は €0.01 を受け取り、€0.20 のマークアップを適用します。Builder は Event Ingestion 前に €0.19 を持っています。
最初の1,000確定済みProductionMonetization Gatewayリクエストは、各暦月（UTC）において無料で、Builderアカウント全体で共有されます。追加のリクエストは、適用可能な割引前に€0.04ごとに1,000の費用がかかります。1つの確定済みリクエストは1つのイベントを生成します。
Pay with ShareAI 単体、inference のみのアクセス、通常のアカウントAPIキーおよびステージングまたはテストトラフィックは Monetization Gateway イベントインジェスチョンを発生させません。
ShareAI for Startupsは、承認されたアプリケーションにおける実際のShareAI料金に対する共有月額手当を提供します。現在のLaunch、Growth、Momentumの各ティアは、月額€1,000、€5,000、€10,000をリストしています。同じ予算は、ShareAIのBuilderマークアップに対する割合料金と請求可能なイベントインジェストを一緒にカバーします。これは総マークアップ手当、別々の無料イベントクォータ、または無料AIinferenceではありません。アカウントの最初の1,000無料イベントはこれを消費しません。
残りのイベントインジェスト料金はリクエストの新しいBuilder収益から支払われ、その後利用可能なBuilderAI収益および制限のないAIクレジットが使用されます。顧客AI料金と製品paymentsは別々に保持されます。
ShareAIは、固定期間または変更されるまでのアプリケーション固有の料金や料金支援を承認できます。コンソールでアプリケーションの現在の価格設定および特別プログラムを確認し、承認された条件、有効性、および消費された手当を確認してください。ティア変更や価格設定の上書きは、アプリケーションの月間使用量をリセットしません。
LaunchではShareAIを使用したログインがオプションのままです。GrowthおよびMomentumではこれが必要であり、Momentumではさらにアプリケーションフッターに公式ShareAI for Startupsバッジが必要です。ShareAIはバッジを毎週チェックします。要件を回避しようとする試みが確認された場合、Startup Programからの降格、削除、または受け入れられたプログラム条件に基づくMarketplaceからの撤退につながる可能性があります。
エンタープライズ料金は、ShareAI チームが Builder アカウントに対して個別のオファーに合意した後に設定されます。割り当てられた割合とイベント料金は、将来のリクエストに適用されます。
Monetization Gateway 価格設定を表示 · ShareAI for Startups を探索する · スコープと権限