# バーチャルカードを作成する カード保有者を作成し、バーチャルカードを発行します。 [ダッシュボード](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) を使用して、カード保有者を作成できます。 # ダッシュボード > This is a ダッシュボード for when testing-method is without-code. View the full page at https://docs.stripe.com/issuing/cards/virtual/issue-cards?testing-method=without-code. 1. Issuing ダッシュボードの[カード保有者タブ](https://dashboard.stripe.com/issuing/cardholders)にアクセスします。 ![Issuing カード保有者のページ](https://b.stripecdn.com/docs-statics-srv/assets/cardholders-page.636c014a4cc28707df5118006f76eb6c.png) 1. 右上の **カード保有者を作成** をクリックします。 1. カード保有者タイプ (個人または会社) を選択します。カード保有者名とビジネス名に使える文字はどちらも、英数字と `/ -&:().'` です。24 文字の文字数制限があります。 ![Issuing カード保有者フォームの種類と名前フィールド](https://b.stripecdn.com/docs-statics-srv/assets/cardholder-form-type-name.580d1c848e5cd8c4cf4af9d50fac3d27.png) 1. 請求先住所を追加します。 ![Issuing カード保有者フォームの請求先住所フィールド](https://b.stripecdn.com/docs-statics-srv/assets/cardholder-form-billing-address.889782c18b84111b57f0fd8152ebb4ad.png) 1. 法人カードを作成する場合は、納税者番号を追加します。 1. デジタルウォレットなどの特定の機能に必要な連絡先情報を追加します。 ![Issuing カード保有者フォームの連絡先情報フィールド](https://b.stripecdn.com/docs-statics-srv/assets/cardholder-form-contact-information.389c419fa3ab62f8df53ed06084b20ff.png) 1. **カード保有者を作成** をクリックします。 ### 個人タイプのカード保有者の要件 個々のカード保有者タイプを選択する場合は、カード保有者の正式な姓名および[生年月日](https://docs.stripe.com/api/issuing/cardholders/create.md#create_issuing_cardholder-individual-dob)を追加する必要があります。[政府発行の身分証明書](https://docs.stripe.com/api/issuing/cardholders/create.md#create_issuing_cardholder-individual-verification)をアップロードすると、[ウォッチリストのレビュー](https://support.stripe.com/questions/issuing-watchlist-reviews)を減らすことができます。 ![Issuing カード保有者フォームの本人確認フィールド](https://b.stripecdn.com/docs-statics-srv/assets/cardholder-form-identity-fields.ac65dc239b5c14e3eb85e550d23b8f34.png) Cross River Bank または Fifth Third Bank が支援するプログラムで個人にカードを発行する場合は、そのカード会員のカードを[有効化する](https://docs.stripe.com/issuing/cards/physical/issue-cards.md?testing-method=without-code#activate-the-card)前に、該当する認定ユーザー規約に同意したことを記録する必要があります。 - [Cross River Bank 認定ユーザー規約](https://stripe.com/legal/issuing/crb-authorized-user-terms) - [Fifth Third Bank 認定ユーザー規約](https://stripe.com/legal/issuing/fifth-third-authorized-user-terms)。 アカウント所有者とカード会員に提示する必要がある契約の詳細については、[Issuing とプラットフォーム向け Treasury 必須同意事項](https://docs.stripe.com/issuing/compliance-us.md)を参照してください。 ### 会社タイプのカード保有者の要件 会社名を追加する際は、2 単語以上にしてください (例: Stripe Inc.)。 ## カードを作成 [ダッシュボード](https://dashboard.stripe.com/issuing/cards)を使用して、新しいカードを作成できます。 1. Issuing ダッシュボードの[カードタブ](https://dashboard.stripe.com/issuing/cards)にアクセスします。 ![Issuing カードページ](https://b.stripecdn.com/docs-statics-srv/assets/cards-page.e8e9728de4c5cbf6bf3b557dc634ed56.png) 1. 右上の **カードを作成** をクリックします。 1. [カード保有者を作成する](https://docs.stripe.com/issuing/cards/virtual/issue-cards.md#create-cardholder)で作成したカード保有者を検索します。 1. タイプとして **バーチャル** を選択します。 1. **カードを有効にする** を選択します。 ![仮想カードドロワーを作成する](https://b.stripecdn.com/docs-statics-srv/assets/create-virtual-card.c049ecd7b3aa31853fb43d870c9680ad.png) 1. **作成** をクリックします。 # API > This is a API for when testing-method is with-code. View the full page at https://docs.stripe.com/issuing/cards/virtual/issue-cards?testing-method=with-code. [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 <>: \ -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 "<>:" \ -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 "<>:" \ -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 "<>:" \ -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 "<>:" \ -d status=active ``` ### ブロック後に再度有効にする 取引で誤った PIN を複数回入力するとカードが無効化され、以降の承認ができなくなる場合があります。カードを再度有効にするには、ダッシュボードまたは [Update Card](https://docs.stripe.com/api.md#update_issuing_card) API を使用して、カードの `status` を `active` に設定します。