製品とサブスクリプションの支払い
ウォレットチェックアウトを作成し、ShareAIで顧客に確認させ、支払い結果を検証してから実行する。
このページについて
ユースケースで「ShareAIで支払う」を有効にします。サブスクリプションプランでは、サブスクリプションやAI追加料金なしで一回限りの購入に対して無料の支払いアクセスを公開するか、サブスクリプションプランを公開します。顧客はウォレットを接続する際にこの契約を受け入れます。各支払いは個別に確認されます。
「ShareAIで支払う」を有効にし、顧客OAuthトークンを取得します payments. サブスクリプションの場合、サブスクリプションプランを公開し、顧客にそれを承認させます。金額は正確なEUR建てのウォレットクレジット文字列であり、浮動小数点計算を送信しないでください。
https://api.shareai.now/api/v1/console/builder/payments保留中のチェックアウトリクエストを作成する
- ベースURL
https://api.shareai.now- 認証
- 顧客OAuthベアラートークン
- 必須スコープ
payments
cURL
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: order-2026-09-example-001' --data '{"title":"Research report","amount":"12.50"}'
サブスクリプションチェックアウト#
同じエンドポイントと新しい冪等性キーを使用して、対象の請求期間を指定します {"subscription":true}. ShareAIは、受け入れられた不変のプランから価格、タイトル、期間を取得します。送信された製品金額はサブスクリプション価格を上書きできません。
確認と検証#
- 返された支払いIDとcheckout_urlを保存します。同じリクエストと冪等性キーを繰り返すと同じ支払いが返されます。異なる条件でキーを再利用すると拒否されます。
- checkout_urlを顧客のために開きます。顧客はサインインし、認証時に使用したのと同じ個人または組織アカウントを選択します。
- ShareAIはアプリケーション、購入、金額、支払者を表示します。明示的かつ認証された確認のみがウォレットを引き落とします。リンクを開くだけでは課金されません。
- 同じ顧客トークンで再度支払いを読み取ります。ステータスが「支払い済み」になった後にのみ実行してください。ブラウザの成功メッセージだけを信用しないでください。
https://api.shareai.now/api/v1/console/builder/payments?id={payment_id}顧客の支払いを読み取る
- ベースURL
https://api.shareai.now- 認証
- 顧客OAuthベアラートークン
- 必須スコープ
payments
cURL
curl --fail-with-body --get 'https://api.shareai.now/api/v1/console/builder/payments' -H "Authorization: Bearer $SHAREAI_ACCESS_TOKEN" --data-urlencode "id=$PAYMENT_ID"
| ステータス | 意味 |
|---|---|
| 保留中 | 確認待ち;チェックアウトは15分後に期限切れになります。 |
| 支払われる | 確認済みで一度引き落とされました。サブスクリプションには支払い済み期間の終了が含まれます。 |
| 顧客が拒否しました。 | 期限切れ. |
| 確認ウィンドウが終了しました。新しいキーで新しいリクエストを作成してください。 | 購入済み、制限なし、有効期限切れでないウォレットクレジットのみが製品とサブスクリプションの支払いに使用できます。プロモーションクレジットや推論専用の収益は使用できません。支払者は自分のBuilderアカウントに支払うことはできません。クレジットが不足している場合、支払いは引き落とされません。チェックアウトと認証が有効な間に、顧客はチャージを追加して再試行できます。 |
各更新には新しいチェックアウトと顧客の確認が必要です。アクティブなサブスクリプション期間は二重に課金されることはありません。確認時に元の付与がまだ有効である必要があります。有効期限が切れたトークンを更新し、必要に応じて新しいリクエストを作成してください。
リクエストはOAuthクライアントと顧客にスコープされます。製品とサブスクリプションの収益はAI追加料金の収益とは別に記録され、45日間のレビュー期間があります。Builderのデフォルトの1.5%手数料はAI追加料金の収益にのみ適用されます。
リクエストはOAuthクライアントと顧客に限定されています。製品およびサブスクリプションの収益はAI追加料金の収益とは別に記録され、45日間のレビュー期間があります。Builderのデフォルトの1.5%手数料はAI追加料金の収益にのみ適用されます。
コンソール分析 → 支払いには、支払い状況、日別合計、リリース状況が表示されます。 ハイブリッドプランの条件.
最終更新日 2026年9月18日