支払いデータのインポートをリクエストする

機密性の高い支払いデータを安全にインポートします。

Stripe では、Stripe に移行する際に既存の顧客データと支払いデータを保持できます。必要に応じて、お客様のチームと現在のペイメントプロバイダーと連携し、情報を安全に移行します。

このプロセスにより、移行が完了するまで、Stripe で新規顧客を受け入れて請求し、現在の決済代行業者を使用して既存の顧客に請求し続けることができます。顧客にダウンタイムは発生しません。移行プロセスが完了すると、すべての支払いを Stripe で処理できるようになります。

このガイドでは、別の決済代行業者またはカスタム決済ソリューションから Stripe へ移行する方法を説明します。また、本番環境へ移行する前にテスト可能な Stripe 導入を構築することもできます。移行プロセスや Stripe との連携についてご不明な点がある場合は、サポートページをご覧ください。まだ確認していない場合は、Stripe の料金体系もご確認ください。

決済に関する機密情報を転送する必要がある場合には、移行前にこちらのデータ移行のリクエストにご記入ください。Stripe では安全かつ PCI に準拠した方法で機密情報を転送するお手伝いをさせていただきます。

Stripe のシステム連携機能を確認

Stripe は、顧客がお客様のサイトに留まるまま支払いを完了できるように、お客様のセキュリティ要件を簡素化します。これは、クライアント側とサーバー側のステップの組み合わせで実現されます。

顧客のブラウザーで実行されているウェブサイトから、Stripe によって支払い詳細が安全に収集されます。
Stripe が、代表のトークンで応答します。
ブラウザーからフォームの他のデータとともに、トークンがサーバーに送信されます。
サーバー側のコードは API リクエスト (支払いの作成時など) でそのトークンを使用します

このアプローチにより、機密性の高い支払い情報がお客様のサーバーに一切触れることなく、Web サイトの決済フローを簡素化できます。これにより、PCI 法令遵守規制に従って運用でき、時間の節約や経済的なメリットが得られます。

Stripe の決済処理フロー

他の決済代行業者と比べて、Stripe の組み込みは以下の点で異なります。

顧客がウェブサイトを離れることはありません。
トークン作成が特定の商品や金額に紐づけられません。
クライアント側のキーをオンデマンドで作成する必要はありません。代わりに、設定済みの公開可能APIキーを使用します。

Stripe アカウントを作成

Stripe を導入する前に、Stripe アカウントを作成する必要があります。

メールアドレス、氏名、国を入力し、パスワードを作成してアカウントを作成します。
ビジネスプロフィールを入力します。
ダッシュボードでメールアドレスを確認をクリックします。Stripe から、アカウントに登録されているメールアドレス宛に確認メールが送信されます。
メールアドレスを確認

Stripe システムの構築

すべての新しい顧客トークン (インポートされていない) に対して、以下を実装します。

カード情報の保存にはCustomer オブジェクトをご利用ください。
顧客のカード情報は、当社が推奨する payments integrations で収集、トークン化しましょう。Stripe の連携機能を構築してから、貴社の決済代行業者にデータを Stripe に移行するよう依頼してください。スタートアップの場合、Embedded Checkout の連携機能を構築するよう推奨しております。これは貴社のウェブサイトに埋め込む決済フォームです。
この連携機能の設定については、組み込み型チェックアウトののクイックスタートガイドをご覧の上、1 回限りの支払い、またはサブスクリプションに対する支払いを受け付けられるようにしてください。
これらの新しい顧客の支払いを作成します。

このアプローチを使用すると、移行プロセス中に既存の決済代行業者の現在の顧客に影響を及ぼさずに、Stripe で新しい顧客からの支払いを受け付けることができます。

導入に関する考慮事項

インポートされたデータを処理する最も効率的な方法は、決済代行業者に Stripe へのデータ転送を依頼する前に組み込みを設計することです。インポートをリクエストする前に実行できる対応は、次のとおりです。

顧客レコードを再マッピングする
移行中に保存された決済手段の更新を保護します。
Adaptive Acceptance、CAU (自動カード更新機能)、ネットワークトークンなどの最適化ツールを有効にしてください。

オプション顧客を Stripe ID にマッピングする

必要に応じて、以前のレコードに基づく支払い方法データを既存の Stripe Customer オブジェクトにインポートするよう、連携を構成できます。これにより、以前の決済代行業者から受信したファイル内の各顧客 ID ごとに、Stripe アカウント上で新しい（重複する可能性のある）Customer が作成されてしまうのを防ぐことができます。

移行後、次の場合には、新しい Stripe Customer 識別子に対応するように一部のレコードを更新する必要がある場合があります。

移行前に Stripe Customer を作成し、その後決済情報をインポートしてこの Customer レコードを更新しました。
支払い情報を新しい顧客レコードとしてインポートしました。

たとえば、顧客 jenny.rosen@example.com の ID は、データベースでは 42 で、以前の決済代行業者のシステムでは ID 1893 に対応していますが、Stripe アカウントでは ID cus_12345 です。この場合、データベースで ID 42 を Stripe ID cus_12345 にマッピングする必要があります。Stripe は、必要な再マッピングを識別するのに役立つ、インポート後のマッピングファイルを提供します。

オプション保存された決済手段の更新を保護する

データの転送からインポートの完了までの間に、顧客が以前の決済代行業者で支払い情報を更新した場合、その変更は失われます。

保存された決済の更新を処理するサイトのプロセスを更新して、顧客に対するエラーや請求の問題を防止します。これには、Stripe Customer ID が保存されていない顧客について、ご自身で移行を実行するための以下の準備が含まれます。

Stripe で顧客用の新しい Customer オブジェクトを作成します。
決済手段を Customer オブジェクトに関連付けます。
必要に応じて、サブスクリプションを移行します。

移行が完了すると、有効期限の変更など、Stripe はカードによってトリガーされる更新を自動的に処理します。

Stripe の連携システムをテストする

埋め込みの決済フォームの導入をテストする方法は以下のとおりです。

埋め込み型の Checkout セッションを作成し、決済フォームを自社のページに搭載します。
以下の表に記載の方法を使用して、決済の詳細を入力します。
- カードの有効期限として任意の将来の日付を入力します。
- 任意の 3 桁のセキュリティコード (CVC) を入力します。
- 請求先の任意の郵便番号を入力します。
支払う をクリックします。return_url にリダイレクトされます。
ダッシュボードに移動して、取引ページで支払いを探します。支払いが成功すると、そのリストに表示されます。
支払いをクリックすると詳細が表示され、請求先情報と購入されたアイテムのリストが含まれた Checkout サマリーなどを確認できます。これを使用して注文の処理を実行できます。

詳しくは導入のテストをご覧ください。

カード番号	シナリオ	テスト方法
	カード支払いは成功し、認証は必要とされません。	クレジットカード番号と、任意の有効期限、セキュリティコード、郵便番号を使用してクレジットカードフォームに入力します。
	カード支払いには認証が必要です。	クレジットカード番号と、任意の有効期限、セキュリティコード、郵便番号を使用してクレジットカードフォームに入力します。
	カードは、`insufficient_funds` などの拒否コードで拒否されます。	クレジットカード番号と、任意の有効期限、セキュリティコード、郵便番号を使用してクレジットカードフォームに入力します。
	UnionPay カードは、13 ～ 19 桁の可変長です。	クレジットカード番号と、任意の有効期限、セキュリティコード、郵便番号を使用してクレジットカードフォームに入力します。

実装内容をテストするためのその他の情報については、テストをご覧ください。

移行の詳細をリクエストして確定する

組み込みを完了し、Stripe で支払いを処理する準備が整ったら、以前の決済代行業者に支払いデータをリクエストします。多くの決済代行業者では、アカウント所有者がデータ転送をリクエストする必要があります。
Stripe アカウントにログインして移行リクエストフォームを送信し、インポート移行をリクエストします。
移行リクエストの受信後に作成される認証済みのメールスレッドを通じて、Stripe とやり取りします。

警告

機密性の高いクレジットカードの詳細や顧客情報を Stripe に直接送信しないでください。これらのデータをお持ちの場合は、移行リクエストフォームでお知らせください。データを安全に転送できるようサポートします。

Stripe は貴社の顧客の請求先住所と決済情報の詳細をインポートできます。その他、下記のことも可能になります。

特定の決済タイプを移行する
Billing Migration Toolkit を使用してサブスクリプションを移行するか、インポートします。

お客様が以前ご利用になっていた決済代行業者が最終データを Stripe に転送するのに数日から数週間かかる場合があります。移行計画を立てる際には、この移行にかかる時間を十分見込んでください。以前の代行業者からのデータ転送が完了したら、Stripe がデータを確認し、インポート時に問題がなかったかを明らかにします。問題の解消には貴社および貴社の以前の代行業者と協力して行います。そしてインポートの概要をお送りしますので、最終確認と承認をお願いいたします。

承認されたら、Stripe はそのデータをお客様のアカウントにインポートします。転送されたデータファイルにある一意の各顧客に対して Customer オブジェクトを作成し、顧客のカードを Card オブジェクトまたはPayment Method オブジェクトとして作成して関連付けます。転送されたデータで顧客のデフォルトのカードが指定されている場合には、Stripe はそれを、顧客の支払いとサブスクリプションのデフォルトの支払い方法として設定します。

移行時までに Stripe アカウントに大量の顧客レコードが蓄積されている場合は、新しい Customer オブジェクトを作成する代わりに、インポートデータを既存の Stripe Customer オブジェクトにマッピングすることを検討してください。

Stripe では通常、以前の決済代行業者から正しいデータを受け取ってから 10 営業日以内に、Stripe チームとの共有を希望される補足データファイルとともにデータをインポートします。

組み込みを更新する

インポートが完了すると、Stripe から、現在の決済代行業者の ID とインポートされた Stripe オブジェクト ID 間のマッピングされた関係を示す CSV ファイルまたは JSON ファイルの選択肢が送信されます。このマッピングファイルを解析し、それに従ってデータベースを更新します。移行中に行われたカードの更新が実装によって処理されていることを確認してください。

インポート後のマッピングファイル

このマッピングファイルで組み込みを更新すると、Stripe ですべての顧客への請求を開始できます。

{
  "1893": {
    "cards": {
      "2600": {
        "id": "card_2222222222",
        "fingerprint": "x9yW1WE4nLvl6zjg",
        "last4": "4242",
        "exp_month": 1,
        "exp_year": 2020,
        "brand": "Visa"
      },
      "3520": {
        "id": "card_3333333333",
        "fingerprint": "nZnMWbJBurX3VHIN",
        "last4": "0341",
        "exp_month": 6,
        "exp_year": 2021,
        "brand": "Mastercard"
      }
    },
    "id": "cus_abc123def456"
  }
}

上記の JSON マッピングの例は、次のようになります。

顧客 ID 1893 を ID cus_abc123def456 の新しい Stripe Customer としてインポートしました。
顧客カード ID 2600 を ID card_2222222222 の新しい Stripe Card としてインポートしました。
顧客カード ID 3520 を ID card_3333333333 の新しい Stripe Card としてインポートしました。

移行リクエストで指定すると、Stripe はカードデータを Card オブジェクトではなく PaymentMethods としてインポートできます。以下の例は、さまざまな種類の決済情報のインポートのマッピングファイルを示しています。

old_customer_id,customer_id,old_card_id,card_id,card_fingerprint,card_last4,card_exp_month,card_exp_year,card_brand
old_cus_100,cus_abc123def456,old_src_100,card_2222222222,x9yW1WE4nLvl6zjg,424242,09,2024,Visa

インポートされた支払いを把握する

移行後は、支払いのパフォーマンスを監視して、インポートされた支払いデータの承認率が想定どおりであることを確認します。

決済の受け付け (またはカード発行会社オーソリ成功率) は、支払いのために送信されたすべての取引のうち、カード発行会社が正常に承認した取引の割合です。この指標には、承認のために送信されることのないブロックされた取引 (Radar ルールなどによる) は含まれません。

一般的なアプローチと移行後の両方で、支払いのオーソリの最適化の目標を事業目標に合わせます。たとえば、単価の低いデジタル商品ビジネスでは、リスクレベルを設定して、ブロックする支払いの数を減らすことができます。潜在的な影響を考慮してください。

ユーザーの負担を減らすことで、コンバージョン率が向上します。
リスクの高い支払いが実行されることにより、詐欺の被害に遭う可能性が高まります。
発行者による不正モデルブロックにより、発行者の未対応のオーソリ率が低下します。

正確なデータ (カード会員名、請求先住所、メールアドレスなど) をご提供ください。カード保有者の意図を反映することで、オーソリが成功する可能性が最大限に高まります。

登録済みのカードで本人確認を行う

支払いデータの移行には、登録済みのカード (同じ顧客に対する今後の加盟店が開始した支払いまたはオフセッション支払いのために保存されたカード) が関係します。インポートした支払いデータを保存し、正しい off_session パラメーターを使用して登録済みのカードを使用した支払いにラベルを付けるようにしてください。登録済みのカードで正しく本人確認を行えない場合は、次のようになります。

今後の支払いや定期的な支払いに対するカード保有者の同意を確認できない発行者は、支払いを拒否する可能性があります。
支払いデータは、自動カード更新機能 (CAU) やネットワークトークン (NT) などの特定の Stripe 最適化製品では対象外となる可能性があります。

最適化の機会を特定するために拒否の理由を確認する

移行後に、発行者の拒否の理由は、移行された支払いデータが想定どおりに処理されているかどうかを確認するのに役立ちます。特定の種類の拒否の急増には、次の最適化製品が役立つ場合があります。

自動カード更新機能: Stripe はカードネットワークとの提携により、有効期限切れや再発行されたカードの最新情報を、リアルタイムおよびバックグラウンドで自動取得します。
自動再試行 (督促): 移行後などに多数のカードを再試行すると、カード発行会社に不審に見える可能性があるため、注意が必要です。請求（継続課金）の支払いに Stripe の Smart Retries を使用すると、AI モデルが支払いの失敗コード、支払い方法の更新、銀行のリスクしきい値に関するアクティビティを分析し、継続課金の支払いをより戦略的に再試行します。
ネットワークトークン: 特定の支払い口座番号 (PAN) をカードネットワークの安全なトークンに置き換えて、PAN の更新 (更新や交換など) がトークンに自動的に反映されるようにします。
Adaptive Acceptance: Stripe は AI を使用して、オーソリリクエストのわずかな調整(フォーマットなど)の影響をリアルタイムで評価し、支払いの再試行を調整したうえで、最終的に最初の拒否結果を顧客に返します。
顧客への連絡: 顧客にログインして支払いの詳細を再入力または再確認するよう依頼することで、多くの場合、顧客と支払いプロバイダーの間でビジネスの信頼性が再確立されます。テキストメッセージやアプリ内通知など、メール以外のチャネルによる顧客への通知もご検討ください。

次の表は、さまざまな拒否の理由に対して、どの最適化製品で改善できるかを示しています。

拒否コードには以下が含まれます:	移行の影響	すべきこと	すべきでないこと
`incorrect_number` `invalid_number` `expired_card`	自然な移行の遅延中にカードデータを更新すると、保存されたカードデータが古くなる可能性があります。	自動カード更新機能ネットワークトークン Adaptive Acceptance 顧客に連絡する	再試行
`generic_decline` `do_not_honor`	明細書表記やその他の識別マーカーを変更すると、発行者リスクモデルがトリガーされたり、顧客が混乱したりする可能性があります。	再試行ネットワークトークン Adaptive Acceptance 顧客に連絡する	自動カード更新機能
`transaction_not_allowed` `try_again_later` `authentication_required` `incorrect_cvc`	移行された支払いデータの中には、ネットワークトークンや元の取引 ID などの初期のカード検証の詳細が不足しているものがあります。	自動カード更新機能再試行 Adaptive Acceptance 顧客に連絡する	ネットワークトークン
`lost_card` `stolen_card` `invalid_account` `pickup_card` `card_not_supported`	移行の遅延中に、顧客からカードの紛失または盗難の報告を受ける場合があります。これらの拒否に関連する特別な CONTAC イベントに注意してください。	ネットワークトークン顧客に連絡する	CAU 再試行¹ Adaptive Acceptance

¹ 紛失または盗難に遭った支払いデータを再試行すると、カード発行会社に疑わしい印象を与える可能性があります。

オプションサブスクリプションを移行する

サブスクリプションを含む移行には、通常、以下のステージが含まれます。

Billing の導入を設定します。
顧客と決済代行業者の情報を移行します。
サブスクリプションを Stripe Billing にインポートします。
Subscriptions API またはダッシュボードの Billing 移行ツールキットを使用して、既存のサブスクリプションをインポートできます。
決済代行業者から離脱したら、顧客への自動請求がすべてキャンセルされていることを確認します。

移行用の PGP キー

PGP に詳しくない場合は、GPG をご覧いただき、公開キーのインポートから始めてください。PGP の基本を理解したら、次の PGP キーを使用して、 PCI 準拠の移行用に機密データ (クレジットカード情報など) を暗号化します。

移行用の PGP キー

これにより、次の情報を含む FILENAME.gpg が作成されます。

キー ID: 9C78B7620C1E99AD
キータイプ: RSA
キーサイズ: 4096 bits
フィンガープリント: AEBF 7C48 38C4 4D2F DC99 A3F9 9C78 B762 0C1E 99AD
ユーザー ID: Stripe Import Key (PCI) <support-migrations@stripe.com>

キーをインポートした後、コマンドラインプロンプトで次のコマンドを実行して、送信するファイルを暗号化することができます。

gpg --encrypt --recipient 9C78B7620C1E99AD FILENAME

暗号化されたデータを Stripe に提供する詳細については、補足データのアップロードを参照してください。

支払いデータのインポートをリクエストする

機密性の高い支払いデータを安全にインポートします。

Stripe のシステム連携機能を確認

Stripe アカウントを作成

Stripe システムの構築

導入に関する考慮事項

オプション顧客を Stripe ID にマッピングする

オプション保存された決済手段の更新を保護する

Stripe の連携システムをテストする

移行の詳細をリクエストして確定する

警告

組み込みを更新する

インポート後のマッピングファイル

インポートされた支払いを把握する

登録済みのカードで本人確認を行う

最適化の機会を特定するために拒否の理由を確認する

オプションサブスクリプションを移行する

移行用の PGP キー

移行用の PGP キー

参照情報