# バーチャルカードを作成する

カード保有者を作成し、バーチャルカードを発行します。

[ダッシュボード](https://dashboard.stripe.com/issuing/cards)または [Create a card](https://docs.stripe.com/api/issuing/cards.md) エンドポイントを使用して、カード保有者にバーチャルカードを発行できます。カード保有者は、バーチャルカードを作成するとすぐに使用できます。

## カード保有者を作成する

[ダッシュボード](https://dashboard.stripe.com/issuing/cardholders)または [Cardholders API](https://docs.stripe.com/api/issuing/cardholders.md) を使用して、カード保有者を作成できます。

> ステーブルコイン担保型の消費者向けカードプログラムでは、Bridge がカード会員の作成と本人確認を管理します。詳細については、[Bridge のドキュメント](https://apidocs.bridge.xyz/platform/cards/overview/kyc)を参照してください。

# API


[Cardholder](https://docs.stripe.com/api/.md#issuing_cardholder_object) オブジェクトは、カードを発行できる個人または法人を表します。カードに表示する[名前](https://docs.stripe.com/api/issuing/cardholders/object.md#issuing_cardholder_object-name)と[請求先](https://docs.stripe.com/api/issuing/cardholders/object.md#issuing_cardholder_object-billing)住所で `Cardholder` を作成します。請求先住所は、カード保有者がオンラインで購入する際に要求されることが多く、通常は連結アカウントまたはプラットフォームのビジネスの住所です。

カード保有者を作成するとき、または後で更新するときに、[デジタルウォレット](https://docs.stripe.com/issuing/cards/digital-wallets.md)などの一部の機能に必要な `phone_number` や `email` などの追加情報を含めることができます。また、[preferred_locales](https://docs.stripe.com/api/issuing/cardholders/object.md#issuing_cardholder_object-preferred_locales) を指定して、[3D セキュア](https://docs.stripe.com/issuing/3d-secure.md)などの機能についてカード保有者の言語をカスタマイズすることもできます。

#### curl

```bash
curl https://api.stripe.com/v1/issuing/cardholders \
  -u <<YOUR_SECRET_KEY>>: \
  -d "name"="Jenny Rosen" \
  -d "email"="jenny.rosen@example.com" \
  -d "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]"="123 Main Street" \
  -d "billing[address][city]"="San Francisco" \
  -d "billing[address][state]"="CA" \
  -d "billing[address][postal_code]"="94111" \
  -d "billing[address][country]"="US"
```

Stripe は指定された情報が格納された `Cardholder` オブジェクトを返し、`issuing_cardholder.created` [Webhook](https://docs.stripe.com/webhooks.md) イベントを送信します。

### 個人タイプのカード保有者の要件

カード保有者の[タイプ](https://docs.stripe.com/api/issuing/cardholders/object.md#issuing_cardholder_object-type)はデフォルトで `individual` に設定されますが、必要に応じて `company` [タイプを設定](https://docs.stripe.com/issuing/other/choose-cardholder.md)することもできます。

Stripe が規制上のガイドラインに従って審査する個人のカード保有者の[姓](https://docs.stripe.com/api/issuing/cardholders/create.md#create_issuing_cardholder-individual-last_name)と名の値を入力してください。また、[生年月日](https://docs.stripe.com/api/issuing/cardholders/create.md#create_issuing_cardholder-individual-dob)の入力も検討してください。入力することで、[ウォッチリストの審査](https://support.stripe.com/questions/issuing-watchlist-reviews)を削減できる可能性があります。

### 認証済みユーザー利用規約を承諾する

Celtic Bank が支援するプログラムで個人向けにカードを発行する場合は、そのカード会員のカードを[有効化](https://docs.stripe.com/issuing/cards/virtual/issue-cards.md#activate-the-card)する前に、[Celtic Bank 認証ユーザー規約](https://stripe.com/legal/issuing/celtic-authorized-user-terms)への同意を記録する必要があります。アカウント保有者やカード会員に提示する必要がある規約の詳細については、[Issuing およびプラットフォーム向け Treasury 必須同意事項](https://docs.stripe.com/issuing/compliance-us.md#issuing-terms)をご覧ください。

該当する場合、Stripe は `Cardholder` オブジェクトの `requirements` プロパティでこの要件を通知します。

```json
{
  "id": "{{CARDHOLDER_ID}}",
  "name": "Jenny Rosen",
  ...
  "requirements": {
    "disabled_reason": "requirements.past_due",
    "past_due": [
      "individual.card_issuing.user_terms_acceptance.date",
      "individual.card_issuing.user_terms_acceptance.ip"
    ]
  }
  ...
}
```

`Cardholder`の代理で規約を承認するには、カード保有者が規約を承認した時間の Unix タイムスタンプに加え、カード保有者の IP アドレスを渡します。

```curl
curl https://api.stripe.com/v1/issuing/cardholders/{{ISSUINGCARDHOLDER_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "individual[card_issuing][user_terms_acceptance][date]=1470266163" \
  -d "individual[card_issuing][user_terms_acceptance][ip]=91.121.146.224"
```

カード有効化の要件を満たしたら (氏名と利用規約への同意の証明など)、そのカード保有者のカードを有効化できます。

## カードを作成

[カード](https://docs.stripe.com/api.md#issuing_card_object)を作成し、カード保有者に割り当てます。このリクエストには、`Cardholder` オブジェクトの ID、`currency`、カード種別の `virtual` が含まれます。

#### Issuing のみ

```curl
curl https://api.stripe.com/v1/issuing/cards \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "cardholder={{ISSUINGCARDHOLDER_ID}}" \
  -d currency=usd \
  -d type=virtual
```

#### プラットフォーム向けの Treasury での発行

[FinancialAccount](https://docs.stripe.com/api/treasury/financial_accounts.md) から売上を引き出すクレジットカードを作成するには、リクエストで `financial_account` を渡します。

```curl
curl https://api.stripe.com/v1/issuing/cards \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "cardholder={{ISSUINGCARDHOLDER_ID}}" \
  -d financial_account=fa_1KsZDkACgxNDEoMCVZko5z5F \
  -d currency=usd \
  -d type=virtual
```

Stripe は、作成後すぐに `Card` オブジェクトを返し、`issuing_card.created` [Webhook](https://docs.stripe.com/webhooks.md) イベントを送信します。

### 有効期限

バーチャルカードの有効期限はデフォルトで 3 年後になり、セキュリティ上の理由から最大 3 か月ごとにランダム化されます。有効期限は、発行から 2 年 9 か月から 3 年 3 か月の間で設定できます。

> [代替カード](https://docs.stripe.com/issuing/cards/replacements.md)を発行する際、2 枚の同一カードが使用できないように、異なる有効期限が設定されています。

#### Custom 有効期限の設定

クレジットカード作成時に有効期限年 ([exp_year](https://docs.stripe.com/api/issuing/cards/create.md#create_issuing_card-exp_year)) と有効期限月 ([exp_month](https://docs.stripe.com/api/issuing/cards/create.md#create_issuing_card-exp_month)) を設定して、クレジットカードの有効期限日を制御します。有効期限は、1 か月以上 5 年未満である必要があります。たとえば、2024 年 4 月の場合は、2024 年 5 月から 2029 年 3 月内税の日付を設定します。

> [代替カード](https://docs.stripe.com/issuing/cards/replacements.md)の発行時に希望する有効期限を再指定する必要があります。指定しない場合、新しいクレジットカードがデフォルトの有効期限に戻る可能性があります。


## カードを有効化

カードで[オーソリ](https://docs.stripe.com/issuing/purchases/authorizations.md)が承認されるには、カードの `status` を `active` に設定する必要があります。期限切れの[要件](https://docs.stripe.com/api/issuing/cardholders/object.md#issuing_cardholder_object-requirements-past_due)があると、カードの有効化はブロックされます。

### 作成時に有効化する

カードは、ダッシュボードまたは API での作成時に有効化できます。ダッシュボードでは、カードを作成するときに、**カードを有効にする**をクリックします。API を使用する場合は、[カード作成](https://docs.stripe.com/api/.md#create_issuing_card)エンドポイントを使用する際に `status` を `active` に設定します。

### 作成後に有効化する

別の方法として、非アクティブなカードを作成した後で、ダッシュボードまたは API を使用してこのカードを有効化することもできます。ダッシュボードを使用して有効化するには、有効化するカードを選択して、**カードを有効にする**をクリックします。API を使用してカードを有効にするには、[カード更新](https://docs.stripe.com/api.md#update_issuing_card)エンドポイントを使用して `status` を `active` に設定します。

```curl
curl https://api.stripe.com/v1/issuing/cards/{{ISSUINGCARD_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d status=active
```

### ブロック後に再度有効にする

取引で誤った PIN を複数回入力するとカードが無効化され、以降の承認ができなくなる場合があります。カードを再度有効にするには、ダッシュボードまたは [Update Card](https://docs.stripe.com/api.md#update_issuing_card) API を使用して、カードの `status` を `active` に設定します。