# Stripe Issuing のカードを使用する

Stripe Issuing と金融口座をプラットフォーム向けに導入する方法をご紹介します。

> #### Accounts v2 API 互換性
> 
> Accounts v2 API は Issuing ワークフローをサポートしていません。Accounts v2 で作成されたアカウントがある場合は、Accounts v1 を使用して `treasury` と `card_issuing` の機能を管理できます。詳細については、[顧客として Account を使用する](https://docs.stripe.com/connect/use-accounts-as-customers.md)を参照してください。

[Stripe Issuing](https://docs.stripe.com/issuing.md) では、資金源として金融口座を使用してカードとバーチャルカードを作成できます。

## 連結アカウントで Issuing を有効にする

プラットフォームで連結アカウントに `card_issuing` [アカウントケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md)をリクエストし、アカウント登録に[必要な情報](https://docs.stripe.com/issuing/connect.md#required-verification-information)を入力します。

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "capabilities[treasury][requested]=true" \
  -d "capabilities[card_issuing][requested]=true" \
  -d "capabilities[transfers][requested]=true"
```

成功すると、レスポンスとして連結アカウントの [Account オブジェクト](https://docs.stripe.com/api/accounts/object.md)が返されます。このオブジェクトには、リクエストしたケイパビリティが `active` としてリストされた `capabilities` ハッシュが含まれます。

金融口座の `card_issuing` 機能へのアクセスをまだリクエストしていない場合は、リクエストしてください。

```curl
curl https://api.stripe.com/v1/treasury/financial_accounts/{{TREASURYFINANCIALACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d "treasury[access][requested]=true" \
  -d "card_issuing[access][requested]=true"
```

成功するとレスポンスで、機能が `active_features` 配列または `pending_features` 配列にリストされた金融口座オブジェクトが返されます。

## カードを作成する

`card_issuing` ケイパビリティが有効になると、プラットフォームの連結アカウントを所有する売り手とサービスプロバイダーはカード保有者とカードを作成できます。カードを発行するために使用できるのは API のみです。

[Cardholder (カード保有者) オブジェクト](https://docs.stripe.com/api/.md#issuing_cardholder_object) はカード発行の対象となる個人または法人を表します。最初に、氏名、請求先情報、および `individual` と `company` のどちらかであるかを指定し `Cardholder` を作成します。

```curl
curl https://api.stripe.com/v1/issuing/cardholders \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d "name=Jenny Rosen" \
  --data-urlencode "email=jenny.rosen@example.com" \
  --data-urlencode "phone_number=+18008675309" \
  -d status=active \
  -d type=individual \
  -d "individual[first_name]=Jenny" \
  -d "individual[last_name]=Rosen" \
  -d "individual[dob][day]=1" \
  -d "individual[dob][month]=11" \
  -d "individual[dob][year]=1981" \
  -d "billing[address][line1]=1234 Main Street" \
  -d "billing[address][city]=San Francisco" \
  -d "billing[address][state]=CA" \
  -d "billing[address][postal_code]=94111" \
  -d "billing[address][country]=US"
```

成功するとレスポンスで、新しく作成された `Cardholder` オブジェクトが返されます。

[Card (カード)](https://docs.stripe.com/api/.md#issuing_card_object) を作成し、先ほど作成した `Cardholder` と金融口座の両方に割り当てます。カード保有者と金融口座を割り当てるには、`/v1/issuing/cards` リクエストの `cardholder` パラメーターでカード保有者 ID を指定し、`financial_account` パラメーターで金融口座 ID を指定します。

```curl
curl https://api.stripe.com/v1/issuing/cards \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d cardholder={{CARDHOLDER_ID}} \
  -d "financial_account={{TREASURYFINANCIALACCOUNT_ID}}" \
  -d currency=usd \
  -d type=virtual \
  -d status=active
```

成功するとレスポンスで、新しく作成された `Card` オブジェクトが返されます。

## オーソリを処理する

[Issuing オーソリ](https://docs.stripe.com/issuing/purchases/authorizations.md)ガイドを確認し、オーソリを正しく処理します。

### テスト用のオーソリを作成する

[Issuing をテストする](https://docs.stripe.com/issuing/testing.md)の手順を実行して、発行したカードをテストし、購入をシミュレーションできます。

発行されたカードに関連付けられた金融口座で [outbound_flows](https://docs.stripe.com/api/treasury/financial_accounts/create.md#create_financial_account-platform_restrictions-outbound_flows) が制限されている場合には、そのカードでオーソリすることはできません。

テスト対象のさまざまな取引タイプについては、[Issuing の取引](https://docs.stripe.com/issuing/purchases/transactions.md#handling-other-transactions)ガイドをご覧ください。

## キャプチャーと返金を処理する

返金とキャプチャーの処理方法については、[Issuing の取引](https://docs.stripe.com/issuing/purchases/transactions.md)ガイドをご覧ください。

## 不審請求の申請を処理する

不審請求の申請の適切な処理方法については、[Issuing の不審請求の申請](https://docs.stripe.com/issuing/purchases/disputes.md)ガイドをご覧ください。