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

Cardholder オブジェクトは、カードを発行できる個人または法人を表します。カードに表示する名前と請求先住所で Cardholder を作成します。請求先住所は、カード保有者がオンラインで購入する際に要求されることが多く、通常は連結アカウントまたはプラットフォームのビジネスの住所です。

カード保有者を作成するとき、または後で更新するときに、デジタルウォレットなどの一部の機能に必要な phone_number や email などの追加情報を含めることができます。また、preferred_locales を指定して、3D セキュアなどの機能についてカード保有者の言語をカスタマイズすることもできます。

curl https://api.stripe.com/v1/issuing/cardholders \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -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 イベントを送信します。

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

カード保有者のタイプはデフォルトで individual に設定されますが、必要に応じて company タイプを設定することもできます。

Stripe が規制上のガイドラインに従って審査する個人のカード保有者の姓と名の値を入力してください。また、生年月日の入力も検討してください。入力することで、ウォッチリストの審査を削減できる可能性があります。

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

Celtic Bank が支援するプログラムの個人にカードを発行する場合は、そのカード保有者のカードを有効化する前に、Celtic Bank 認定ユーザー規約への同意を記録する必要があります。アカウント保有者とカード保有者に提示する必要がある契約書の詳細については、発行と財務に必要な契約書を参照してください。

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

{
  "id": "ich_1MGlTC2eZvKYlo2CJnowP9Z5",
  "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 https://api.stripe.com/v1/issuing/cardholders/ich_1MGlTC2eZvKYlo2CJnowP9Z5 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "individual[card_issuing][user_terms_acceptance][date]"=1470266163 \
  -d "individual[card_issuing][user_terms_acceptance][ip]"="91.121.146.224"

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

カードを作成

カードを作成し、カード保有者に割り当てます。このリクエストには、Cardholder オブジェクトの ID、currency、カード種別の virtual が含まれます。

curl https://api.stripe.com/v1/issuing/cards \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d cardholder=ich_1MGlTC2eZvKYlo2CJnowP9Z5 \
  -d currency=usd \
  -d type=virtual

Stripe は、作成後すぐに Card オブジェクトを返し、issuing_card.created Webhook イベントを送信します。

有効期限

バーチャルカードのデフォルトの有効期限は 3 年後であり、セキュリティ強化のために追加で 3 カ月または 3 カ月未満の調整があります。バーチャルカードのデフォルトの有効期限は、2 年 9 カ月後から 3 年 3 カ月後の間のいずれかになります。

Customの有効期限

カード作成時に有効期限年 (exp_year) および有効期限月 (exp_month) のパラメータを設定して、カードの有効期限を Custom 制御できます。

カードの有効期限は、最低でも 1 カ月以上先、5 年未満先である必要があります。

たとえば、現在が 2024 年 4 月の場合、カードの有効期限は 2024 年 5 月から 2029 年 3 月までの範囲内である必要があります。