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

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 Authorized User Terms に同意したことを記録してから、そのカード会員のために カードをアクティベートする必要があります。口座保有者やカード会員に提示する必要のある契約書の詳細については、Required Agreements for Issuing and Financial Accounts for platforms をご参照ください。

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

{
  "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 https://api.stripe.com/v1/issuing/cardholders/
{{CARDHOLDER_ID}} \
  -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=
"{{CARDHOLDER_ID}}" \
  -d currency=usd \
  -d type=virtual

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

有効期限

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

Custom 有効期限の設定

クレジットカード作成時に有効期限年 (exp_year) と有効期限月 (exp_month) を設定して、クレジットカードの有効期限日を制御します。有効期限は、1 か月以上 5 年未満である必要があります。たとえば、2024 年 4 月の場合は、2024 年 5 月から 2029 年 3 月内税の日付を設定します。