PAN データのインポートをリクエストする
別の決済代行業者から既存の顧客データを取得して、Stripe アカウントにインポートできます。Stripe は、お客様の現在の決済代行業者と協力し、支払い情報を含むデータを安全に移行します。これにより、中断したり、顧客に支払いの詳細の再提出を求めたりすることなく、顧客への請求を続行できます。
データの移行プロセス
Stripe へのデータの移行は通常、以下のステップで行われます。
- Stripe の実装を構築します。
- 現在の決済代行業者に Stripe へのデータ移行をリクエストします。
- 組み込みをアップグレードして移行を完了します。
- (オプション) 存在する場合は、サブスクリプションを移行します。
移行プロセスが完了すると、すべての支払いを Stripe で処理できるようになります。
現在の決済代行業者にデータをリクエストする前に、Stripe の実装を構築してテストします。このようにすることで、新しい実装を検証しテストするための十分な時間が得られます。移行プロセスや Stripe の実装についてご不明な点がございましたら、お問い合わせください。
Stripe の組み込みを構築する
Stripe は、顧客がお客様のサイトに留まったまま支払いを完了できるように、お客様のセキュリティ要件を簡素化します。これは、クライアント側とサーバー側のステップの組み合わせで実現されます。
- 顧客のブラウザーで実行されているウェブサイトから、Stripe によって顧客の支払い詳細が安全に収集されます。
- Stripe が、代表のトークンで応答します。
- ブラウザーからフォームの他のデータとともに、トークンがサーバーに送信されます。
- サーバー側のコードは API リクエスト (支払いの作成時など) でそのトークンを使用します
このアプローチでは、機密の支払い情報をサーバーに保存することなく、ウェブサイトの決済フローが効率化されます。これは、PCI 準拠を徹底するのに役立ちます。
Stripe での決済処理フロー
Stripe を実装すると、以下のようになります。
- 顧客がウェブサイトを離れることはありません。
- トークン作成が特定の商品や金額に紐づけられません。
- オンデマンドでクライアント側のキーを作成する必要がありません (代わりに設定された公開可能な API キーを使用)。
組み込みを準備する
移行を開始する前に、Checkout を使用して Stripe の実装を設定します。これは、Stripe がホストするページまたはお客様の Web サイトの埋め込みフォームとして導入できます。
このアプローチを使用すると、現在の顧客に影響を及ぼさずに Stripe で決済を受け付けることができます。
重要な考慮事項
決済代行業者に Stripe へのデータ転送を依頼する前に、以下の準備をしてください。
顧客レコードを再マッピングする
移行後に、顧客レコードをお客様側でマッピングしなおす必要があります。たとえば、お客様のデータベースではメールアドレスが jenny.rosen@example.com の顧客の ID が 42
で、以前の決済代行業者のシステムの顧客 ID 1893 に対応しているとします。
移行後、Stripe アカウントでのこの同じ顧客の ID は cus_12345
になっています。新しいリファレンスでお客様のデータベースを更新できるように、Stripe の移行スペシャリストがメールでのやり取りの際にインポートマッピングファイルを提供します。まれに、セキュアなファイルドロップでこのファイルをお客様のダッシュボードにアップロードすることもあります。
以前の決済代行業者から受け取ったファイル内の固有の顧客 ID ごとに Stripe アカウントに新しい顧客を作成する方法の代替として、以前のレコードからの決済手段データを既存の Stripe Customer オブジェクトにインポートできます。このオプションを選択するには、以下のようにします。
お問い合わせフォームで、「お客様の Stripe アカウントにすでに存在する Stripe Customer オブジェクトにデータをインポートしますか?」という質問に対して、はいを選択します。
次の 2 列が含まれた CSV マッピングファイルを作成します。
old_customer_id
: 以前の決済代行業者が使用していた一意の IDstripe_customer_id
:cus_xxxx
という形式の、当該顧客に対応する Stripe 顧客 ID
ファイルに機密データは含めないでください。
Stripe は お問い合わせフォームを受け取ると、CSV マッピングファイルの提供メールで依頼します。作成したファイルを添付してメールに返信してください。
支払い情報の更新を処理する
お客様が以前の決済代行業者にデータの転送を依頼した後、Stripe がそのデータを受信およびインポートする前に、顧客が支払い情報を更新する必要が生じる場合があります。この期間に以前の決済代行業者に送信された決済手段の変更は、転送データに含まれないため失われてしまいます。さらに、まだデータがインポートされておらず、新しい Stripe の顧客 ID がまだ分からないため、これらの変更を Stripe で行うこともできません。
これを処理する最善の方法は、保存された支払い情報の更新を処理するサイトのプロセスを変更することです。これには、Stripe の顧客 ID が保存されていない顧客について、お客様ご自身で移行を実行するための以下の準備が含まれます。
- Stripe で顧客用の新しい Customer (顧客) オブジェクトを作成します。
Customer
オブジェクトに決済手段を関連付けます。- (オプション) サブスクリプションを再作成します。
このような場合にも対応できるように組み込みを更新することにより、顧客にエラーが発生したり、請求で問題が起きることを防げます。
移行が実施されると、有効期限日の変更などのカードに基づく更新は、Stripe によって自動的に処理されます。
現在の決済代行業者にリクエストする
組み込みを構築し、Stripe で支払いを処理する準備が整ったら、以前の決済代行業者に支払いデータをリクエストします。ほとんどの決済代行業者はアカウントの所有者からリクエストがあった場合にのみデータを転送するため、アカウントの所有者から決済代行業者に連絡するとこのプロセスがスムーズに進みます。
以前の決済代行業者にデータの移行をリクエストしたら、Stripe にお知らせください。Stripe は、顧客の決済詳細 (クレジットカード、ACH や SEPA 決済の銀行口座情報など) および請求先住所情報をインポートできます。ただし、サブスクリプションはインポートできないため、別途作成し直す必要があります。
警告
機密のクレジットカード詳細や顧客情報を Stripe に直接送信しないでください。このような情報をお持ちの場合には、移行サポートにお問い合わせください。情報を安全に送信するためのお手伝いをいたします。
以前の決済代行業者が最終データを Stripe に送信するまでには数日から数週間かかるため、この時間を移行プランに組み込んでおいてください。受信したデータが使用できない場合には、Stripe は問題の要点をまとめ、以前の決済代行業者と協力してデータを修正します。
以前の決済代行業者がデータを転送したら、Stripe はそのデータをお客様のアカウントにインポートします。Stripe は、転送されたデータファイルにある一意の各顧客に対して Customer (顧客) オブジェクトを作成し、顧客のカードを Card (カード) オブジェクトまたは Source (ソース) オブジェクトとして作成して関連付けます。転送されたデータで顧客のデフォルトのカードが指定されている場合には、Stripe はそれを、顧客の支払いとサブスクリプションのデフォルトの決済手段として設定します。
通常このインポートプロセスは、以前の決済代行業者から正しい完全なデータを受信してから 10 営業日以内に行われます。
組み込みを更新する
インポート処理が完了すると、Stripe は JSON ファイルを送信します。このファイルは、現在の決済代行業者の ID を、インポートされた Stripe オブジェクト ID にマッピングします。お客様は、このマッピングファイルを解析し、それに従ってデータベースを更新する必要があります。インポートの試行前に Stripe の実装を構築すると、移行中に発生したカードの更新をシステムが処理していることになります。
このマッピングファイルで組み込みを更新したら、Stripe ですべての顧客への請求を開始できます。下記に、インポートされたデータの例を示しています。
- 顧客 ID
1893
は、IDcus_abc123def456
の新しい Customer (顧客) としてインポートされます。 - 顧客の ID
2600
のカードは、IDcard_2222222222
の新しい Card (カード) としてインポートされます。 - ID
3520
の顧客のカードは、IDcard_3333333333
の新しい Card (カード) としてインポートされます。
必要に応じて、移行リクエストを送信する際に PaymentMethods としてデータをインポートするようにリクエストできます。この形式とマッピングファイルとの唯一の相違点は、ID が pm_2222222222
の形式であることです。
移行完了後に顧客のクレジットカードが拒否された場合には、カードのセキュリティコード番号の提供、またはカード情報の更新を顧客にリクエストします。その後、再度請求を試行します。
サブスクリプションを使用する (オプション)
サブスクリプションを含む移行には、通常、以下のステージが含まれます。
- Billing の実装を設定します。
- 顧客と決済代行業者の情報を移行します (こちらのページで説明)。
- サブスクリプションを Stripe Billing にインポートします。他の決済代行業者から Stripe へのサブスクリプションの移行の詳細をご確認ください。
既存のサブスクリプションをインポートするには、以下を行います。
決済代行業者から離脱したら、顧客への自動請求がすべてキャンセルされていることを確認します。
移行用の PGP キー
PGP に詳しくない場合は、GPG をご覧いただき、公開キーのインポートから始めてください。PGP の基本を理解したら、次の PGP キーを使用して、 PCI に準拠した移行のために機密データ (クレジットカード情報など) を暗号化します。ご不明な点や問題がありましたら、お問い合わせフォームから連絡してください。
移行用の PGP キー
キーをインポートしたら、以下を実行して、送信するファイルを暗号化することができます。
gpg --encrypt --recipient 9C78B7620C1E99AD FILENAME
これにより、次の情報を含む FILENAME.gpg が作成されます。
- キー ID:
9C78B7620C1E99AD
- キータイプ: RSA
- キーサイズ: 4096 ビット
- フィンガープリント:
AEBF 7C48 38C4 4D2F DC99 A3F9 9C78 B762 0C1E 99AD
- ユーザー ID:
Stripe Import Key (PCI) <support-migrations@stripe.com>