# 別の処理業者から移行する

Payment Methods API を使用して、別の決済処理業者から銀行口座を移行します。

口座振替の権限は、顧客のアカウントからの引き落としをオーソリするために顧客が指定する同意書です。移行する前に、移行する予定の各顧客について口座振替の権限のコピーを保持してください。Stripe は権限のコピーの提出を求める場合があるため、速やかに提出する必要があります。移行前に行われた不審請求の申請については、引き続きお客様が責任を負うことにご注意ください。

## 移行の通知

移行が行われる前に、移行について顧客に通知します。次の情報を含める必要があります。

- 新しい処理業者の名前: Stripe New Zealand Limited (口座引落所コード: `3143978`)
- 送金が行われる日付 (つまり、移行が完了し、Stripe が口座引き落としによる決済処理を開始する日付)
- カスタマーサポートの連絡先の詳細

顧客が同意書のキャンセルを選択しない限り、それ以上のアクションは必要ないことを顧客に伝えます。

## 引き落としの初回通知

移行後の最初の支払いが正常に処理されたら、顧客に通知します。この通知は、顧客の銀行口座情報が正常にインポートされた後に Stripe が送信する自動通知と一緒に送信する必要があります。

## Stripe の通知

顧客の銀行口座の詳細が正常にインポートされると、Stripe は顧客に自動的に通知します。詳細については、[同意書の確認メール](https://docs.stripe.com/payments/nz-bank-account.md#mandate-confirmation-emails)をご覧ください。

さらに、Stripe は移行後の新しい支払いについてそれぞれ顧客に通知します。詳しくは、[引き落とし前の通知メール](https://docs.stripe.com/payments/nz-bank-account.md#pre-debit-notification-emails)をご覧ください。

Stripe による自動通知をオフにした場合は、顧客に通知する必要があります。これらの要件には特定の要件が適用されます。詳細については、[同意書の確認メール](https://docs.stripe.com/payments/nz-bank-account.md#mandate-confirmation-emails)および[引き落とし前の通知メール](https://docs.stripe.com/payments/nz-bank-account.md#pre-debit-notification-emails)をご覧ください。

## 別の決済代行業者から銀行口座を手動で移行する

顧客と銀行口座ごとに、[SetupIntent](https://docs.stripe.com/api/setup_intents.md) を作成します。

1. 顧客を表す新しいオブジェクト (顧客設定の [Account](https://docs.stripe.com/api/v2/core/accounts/object.md) または [Customer](https://docs.stripe.com/api/customers.md)) を作成するか、既存のオブジェクトを取得してこの銀行口座に関連付けます。
1. 保存した銀行口座の詳細と顧客の口座引き落としの元のオーソリ日を指定して SetupIntent を作成し、*確定* (Confirming an intent indicates that the customer intends to use the current or provided payment method. Upon confirmation, the intent attempts to initiate the portions of the flow that have real-world side effects) します。Stripe は同意書の確認と引き落としの事前通知メールを顧客に自動的に送信するため、`billing_details.email` と `billing_details.name` を含める必要があります。

#### Accounts v2

```curl
curl https://api.stripe.com/v1/setup_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "customer_account={{CUSTOMERACCOUNT_ID}}" \
  -d confirm=true \
  -d "payment_method_data[type]=nz_bank_account" \
  -d "payment_method_data[nz_bank_account][bank_code]={{BANK_CODE}}" \
  -d "payment_method_data[nz_bank_account][branch_code]={{BRANCH_CODE}}" \
  -d "payment_method_data[nz_bank_account][account_number]={{ACCOUNT_NUMBER}}" \
  -d "payment_method_data[nz_bank_account][suffix]={{SUFFIX}}" \
  -d "payment_method_data[billing_details][email]={{CUSTOMER_EMAIL}}" \
  -d "payment_method_data[billing_details][name]={{CUSTOMER_NAME}}" \
  -d "mandate_data[customer_acceptance][type]=offline" \
  -d "mandate_data[customer_acceptance][accepted_at]=1692821946"
```

#### Customers v1

```curl
curl https://api.stripe.com/v1/setup_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d customer={{CUSTOMER_ID}} \
  -d confirm=true \
  -d "payment_method_data[type]=nz_bank_account" \
  -d "payment_method_data[nz_bank_account][bank_code]={{BANK_CODE}}" \
  -d "payment_method_data[nz_bank_account][branch_code]={{BRANCH_CODE}}" \
  -d "payment_method_data[nz_bank_account][account_number]={{ACCOUNT_NUMBER}}" \
  -d "payment_method_data[nz_bank_account][suffix]={{SUFFIX}}" \
  -d "payment_method_data[billing_details][email]={{CUSTOMER_EMAIL}}" \
  -d "payment_method_data[billing_details][name]={{CUSTOMER_NAME}}" \
  -d "mandate_data[customer_acceptance][type]=offline" \
  -d "mandate_data[customer_acceptance][accepted_at]=1692821946"
```

1. レスポンスから [PaymentMethod ID](https://docs.stripe.com/api/setup_intents/object.md#setup_intent_object-payment_method) を取得して保存し、[将来の支払い](https://docs.stripe.com/payments/nz-bank-account/accept-a-payment.md)に使用します。また、顧客のすべての PaymentMethods を [listing](https://docs.stripe.com/api/payment_methods/list.md) して取得することもできます。