Stripe for Salesforce Platform の設定

Stripe アカウント認証を OAuth から API キーに切り替える

Stripe for Salesforce Platform のバージョン 1.17 以降、OAuth ベースの認証は提供されていません。Stripe アカウントを OAuth から API キーを使用するように移行するには、次の手順に従います。

Salesforce の Setup (設定) タブから、App Launcher (アプリケーションランチャー) > Stripe for Salesforce Platform に移動します。
Account Management (アカウント管理) で、移行する Stripe アカウントをクリックします。
Reauthorize using API key (API キーを使用して再認証) をクリックします。
このアカウントの Stripe API キーを入力し、API キーが適切な環境 (本番またはテスト) 用であることを確認します。Save (保存) をクリックします。

サンドボックスと環境の複製を使用する

Stripe for Salesforce Platform でサンドボックスを作成するか、本番データをコピーする場合は、選択済みのデータを必ず複製から除外してください。本番環境や他の環境から接続や設定をコピーすることはできません。stripeGC オブジェクトを含まないサンドボックステンプレートを使用してください。

Stripe for Salesforce Platform を Salesforce 組織ごとに個別に設定し、Salesforce 組織ごとに設定プロセスを実行します。

複製にコピーしたデータを削除する

StripeGC オブジェクトから新しい Salesforce 組織にデータをコピーする際は、以下のように Anonymous Apex スクリプトを実行してデータを削除します。

delete [SELECT Id FROM stripeGC__Setup_Data__c];
delete [SELECT Id FROM stripeGC__Stripe_Account__c];
delete [SELECT Id FROM stripeGC__Stripe_Event__c];
delete [SELECT Id FROM stripeGC__Stripe_Webhook_Endpoint__c];
delete [SELECT Id FROM stripeGC__Sync_Log__c];

再帰検出から除外されるデフォルトのイベント

Stripe の Salesforce プラットフォームには、ループで操作が止まることを防ぐためにチェック機能が搭載されています。一連のリソースが別のリソースによる更新を絶えず検出・応答すると、論理ループが発生する可能性があります。たとえば、Stripe の customer.updated イベントをリッスンして Salesforce の Account を更新するフローがあるとします。一方で、Salesforce の Account の更新を検出して、Stripe の顧客を更新する別のフローがあった場合、無制限に続く継続的なループが発生します。

charge.captured	charge.expired	charge.failed
charge.pending	charge.refunded	charge.succeeded
charge.updated	credit_note.created	credit_note.updated
credit_note.voided	invoice.created	invoice.deleted
invoice.finalization_failed	Invoice.finalized	invoice.marked_uncollectible
invoice.paid	invoice.payment_action_required	invoice.payment_failed
invoice.payment_succeeded	invoice.sent	invoice.upcoming
invoice.updated	invoice.voided	invoiceitem.created
invoiceitem.deleted	invoiceitem.updated	issuing_card.created
issuing_card.updated	issuing_cardholder.created	issuing_cardholder.updated
issuing_dispute.closed	issuing_dispute.created	issuing_dispute.funds_reinstated
issuing_dispute.submitted	issuing_dispute.updated	issuing_transaction.created
issuing_transaction.updated	mandate.updated	order.created
order.payment_failed	order.payment_succeeded	order.updated
payment_intent.amount_capturable_updated	payment_intent.canceled	payment_intent.created
payment_intent.partially_funded	payment_intent.payment_failed	payment_intent.processing
payment_intent.requires_action	payment_intent.succeeded	payment_link.created
payment_link.updated	payment_method.attached	payment_method.automatically_updated
payment_method.detached	payment_method.updated	payout.canceled
payout.created	payout.failed	payout.paid
payout.updated	quote.accepted	quote.canceled
quote.created	quote.finalized	setup_intent.canceled
setup_intent.created	setup_intent.requires_action	setup_intent.setup_failed
setup_intent.succeeded	customer.source.created	customer.source.deleted
customer.source.expiring	customer.source.updated	source.canceled
source.chargeable	source.failed	source.mandate_notification
source.refund_attributes_required

再帰検出の設定

再帰検出には特定のイベントを含めたり除外したりできます。管理者の場合は、再帰検出を設定して、設定内でこれらのイベントを変更できます。

Recursion Detection Configuration (再帰検出の設定) には次のステップに従ってアクセスできます。

Setup (設定) > Custom Code (カスタムコード) > Custom Metadata Types (カスタムメタデータタイプ) に移動します。
Recursion Detection Configuration (再帰検出の設定) で、Manage Records (レコードの管理) をクリックします。
Default (デフォルト) の横で、Edit (編集) をクリックします。

この設定内で、管理者は Included Events (含まれるイベント) または Excluded Events (除外されるイベント) を追加できます。

同期の設定の構成

Sync Preference (同期の設定) を指定するには、Stripe Connector for Salesforce App ウィザードを立ち上げ、App Launcher (アプリケーションランチャー) > Stripe Universal Connector for Salesforce に移動します。
Sync Preferences (同期の設定) ボタンをクリックします。
Enable Stripe Event Data Cleanup (Stripe Event Data Cleanup の有効化) を有効または無効にします。
Maximum Stripe Event Records Retained (Count) (Stripe Event Record の最大保持数 (件数)) を修正します。
Sync Log Records (同期ログレコード) を有効または無効にします。
Maximum Sync Log Records Retained (Count) (Sync Log Record の最大保持数 (件数)) を修正します。