コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン
概要
事業で活用する
カード即時通貨換算
プラットフォームに組み込む
カードを発行する

連結アカウント、カード保有者、カード

Stripe Connect でカード保有者とカードを作成し、管理する方法をご紹介します。

連結アカウントは法人に相当します。カード保有者はそうした法人に関連付けられている個人を表します。1 つの連結アカウントに複数のカード保有者を設定できます。たとえば、中小企業の連結アカウントで複数のカードを設定して、オーナーと従業員が使用できるようにすることができます。カード保有者を作成したら、バーチャルカードか物理カードを保有者に発行します。

カード保有者を作成する

Cardholder を作成するには、Cardholder API を使用して必要な情報を入力します。デジタルウォレットを使用する場合は、有効な電話番号とメールアドレスが必要ですが、法人カードの場合は任意です。

メモ

Connect プラットフォームは、Stripe-Account ヘッダーと連結アカウントのアカウント ID を含めて、連結アカウントの代わりに API コールを実行します。

フィールドパラメーター説明
請求先情報billingカード保有者の請求先住所 (通常はビジネスのメインの住所)。私書箱、高速道路の契約ボックス、私設郵便受けの住所は使用できませんが、カードの配送先住所としては使用できます。
タイプtypeカード保有者が company か individual か。ガイダンスについては、カード保有者の種類を選択するを参照してください。
電話番号phone_numberデジタルウォレットを使用する場合は必須
メールアドレスemailカード保有者のメールアドレス。デジタルウォレットを使用する場合は必須
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/issuing/cardholders \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_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]"="510 Townsend Street" \
  -d "billing[address][city]"="San Francsico" \
  -d "billing[address][state]"=CA \
  -d "billing[address][postal_code]"=94111 \
  -d "billing[address][country]"=US

Stripe は指定された情報が格納された Cardholder オブジェクトを返し、issuing_cardholder.created Webhook イベントを送信します。

Cardholder を作成したら、変更が必要なパラメーターを指定して カード保有者の更新エンドポイントを呼び出します。コールが成功すると、更新後の Cardholder オブジェクトが返されます。

カード会員は、初期設定では active ステータスです。これは、プラットフォームがカード会員を有効化することを意味し、その結果、当該カード会員に紐付くすべてのカードがオーソリを承認できるようになります。

Stripe には、法務および規制ガイドラインに従ってカード会員の本人確認情報をスクリーニングする義務があります。これにより、カード保有者のステータスが active であっても、その会員の属性に基づく承認がブロックされる可能性があります。ウォッチリストレビューの詳細はこちらをご覧ください。

カード会員を更新することで、status を inactive に変更することができます。Cardholder が inactive ということは、紐付けられたカードについて、cardholder_inactive という理由ですべての承認が拒否されるということです。

カードを作成する

Cardholder を作成したら、Cards API を使用してカードを発行します。

Card オブジェクトは物理カードおよびバーチャルカードを表します。物理カードを作成するには配送先住所が必要です。追加の引数を指定して配送用の梱包と配送サービスを指定できます。

カード保有者cardholderカード保有者の ID
通貨currency3 文字 (小文字) の ISO 通貨コード。対応可能な通貨は、アメリカの usd、イギリスの gbp、ユーロ圏諸国の eur です。
タイプtypephysical または virtual のいずれか

次の呼び出しは、指定されたカード保有者に関連付けられたバーチャルカードを発行する例です。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/issuing/cards \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d cardholder=ich_1234 \
  -d currency=usd \
  -d type=virtual

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

カードを有効にする

オーソリが承認されるには、カードが有効化されている必要があります。

カードの作成時にステータスを指定しない場合は、デフォルトのステータス inactive が設定されます。カードの更新エンドポイントでステータスが変更されるまで、カードのステータスは inactive のままになります。

カードを有効化する方法

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/issuing/cards/{{CARD_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d status=active

カードを無効にする

カード更新エンドポイントで status を inactive に設定すると、カードを無効化できます。このようにするとそのカードでは「新たな」オーソリを承認できなくなります。ただし、ステータスを inactive に設定する前に開始されたオーソリは承認できます。新たなオーソリを承認するには、カードのステータスを active に変更する必要があります。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/issuing/cards/{{CARD_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d status=inactive

オーソリを管理するについてもっと知る。

カードをキャンセルする

カード更新エンドポイントでステータスを canceled に変更すると、カードをキャンセルすることができます。キャンセルされたステータスは最終決定であり、取り消すことはできません。canceled ステータスが指定されたカードで新たなオーソリを承認することはできません。ただし、ステータスを canceled に設定する前に開始されたオーソリは承認することができます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/issuing/cards/{{CARD_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d status=canceled

カード会員のリスト

Cardholders API の GET リクエストを実行し、特定の Stripe-Account をヘッダーに渡すと、連結アカウントに関連付けられているカード保有者を検索できます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/issuing/cardholders \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
"

成功すると、レスポンスでカード保有者のリストが返されます。

{
  "object": "list",
  "data": [
    {
      "id": "ich_1234a",
      "object": "issuing.cardholder",
      "billing": {
        "address": {
          "city": "San Francisco",
          "country": "US",
          "line1": "510 Townsend Street",
          "line2": null,
          "postal_code": "94111",
          "state": "CA"
        }
      },
      "company": null,
      "created": 1657144326,
      "email": "jenny.rosen@example.com",
      "individual": null,
      "livemode": false,
      "metadata": {},
      "name": "Jenny Rosen",
      "phone_number": "+18008675309",
      "requirements": {
        "disabled_reason": null,
        "past_due": []
      },
      "spending_controls": {
        "allowed_categories": [],
        "blocked_categories": [],
        "spending_limits": [],
        "spending_limits_currency": null
      },
      "status": "active",
      "type": "individual"
    },
    {
      "id": "ich_1234b",
      "object": "issuing.cardholder",
      "billing": {
        "address": {
          "city": "San Francisco",
          "country": "US",
          "line1": "510 Townsend Street",
          "line2": null,
          "postal_code": "94111",
          "state": "CA"
        }
      },
      "company": null,
      "created": 1656537695,
      "email": "jenny.rosen@example.com",
      "individual": null,
      "livemode": false,
      "metadata": {},
      "name": "Jenny Rosen",
      "phone_number": "+18008675309",
      "requirements": {
        "disabled_reason": null,
        "past_due": []
      },
      "spending_controls": {
        "allowed_categories": [],
        "blocked_categories": [],
        "spending_limits": [],
        "spending_limits_currency": null
      },
      "status": "active",
      "type": "individual"
    }
  ],
  "has_more": false,
  "url": "/v1/issuing/cardholders"
}

カードをリストする

Cards API の GET リクエストを実行し、特定の Stripe-Account をヘッダーに渡すと、連結アカウントで作成されているカードのリストを表示できます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/issuing/cards \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
"

成功すると、カードのリストが返されます。

{
  "object": "list",
  "data": [
    {
      "id": "ic_1234a",
      "object": "issuing.card",
      "brand": "Visa",
      "cancellation_reason": null,
      "cardholder": {
        "id": "ich_1234a",
        "object": "issuing.cardholder",
        "billing": {
          "address": {
            "city": "San Francisco",
            "country": "US",
            "line1": "510 Townsend Street",
            "line2": null,
            "postal_code": "94111",
            "state": "CA"
          }
        },
        "company": null,
        "created": 1656537695,
        "email": "jenny.rosen@example.com",
        "individual": null,
        "livemode": false,
        "metadata": {},
        "name": "Jenny Rosen",
        "phone_number": "+18008675309",
        "requirements": {
          "disabled_reason": null,
          "past_due": []
        },
        "spending_controls": {
          "allowed_categories": [],
          "blocked_categories": [],
          "spending_limits": [],
          "spending_limits_currency": null
        },
        "status": "active",
        "type": "individual"
      },
      "created": 1656537950,
      "currency": "usd",
      "exp_month": 5,
      "exp_year": 2025,
      "last4": "0021",
      "livemode": false,
      "metadata": {},
      "pin": null,
      "replaced_by": null,
      "replacement_for": null,
      "replacement_reason": null,
      "shipping": null,
      "spending_controls": {
        "allowed_categories": [
          "car_rental_agencies"
        ],
        "blocked_categories": null,
        "spending_limits": [
          {
            "amount": 8000,
            "categories": [],
            "interval": "per_authorization"
          }
        ],
        "spending_limits_currency": "usd"
      },
      "status": "active",
      "type": "virtual",
      "wallets": {
        "apple_pay": {
          "eligible": true,
          "ineligible_reason": null
        },
        "google_pay": {
          "eligible": true,
          "ineligible_reason": null
        },
        "primary_account_identifier": null
      }
    },
    {
      "id": "ic_1234b",
      "object": "issuing.card",
      "brand": "Visa",
      "cancellation_reason": null,
      "cardholder": {
        "id": "ich_1234a",
        "object": "issuing.cardholder",
        "billing": {
          "address": {
            "city": "San Francisco",
            "country": "US",
            "line1": "510 Townsend Street",
            "line2": null,
            "postal_code": "94111",
            "state": "CA"
          }
        },
        "company": null,
        "created": 1656537695,
        "email": "jenny.rosen@example.com",
        "individual": null,
        "livemode": false,
        "metadata": {},
        "name": "Jenny Rosen",
        "phone_number": "+18008675309",
        "requirements": {
          "disabled_reason": null,
          "past_due": []
        },
        "spending_controls": {
          "allowed_categories": [],
          "blocked_categories": [],
          "spending_limits": [],
          "spending_limits_currency": null
        },
        "status": "active",
        "type": "individual"
      },
      "created": 1656537947,
      "currency": "usd",
      "exp_month": 5,
      "exp_year": 2025,
      "last4": "0013",
      "livemode": false,
      "metadata": {},
      "pin": null,
      "replaced_by": null,
      "replacement_for": null,
      "replacement_reason": null,
      "shipping": null,
      "spending_controls": {
        "allowed_categories": null,
        "blocked_categories": null,
        "spending_limits": [
          {
            "amount": 50000,
            "categories": [],
            "interval": "daily"
          }
        ],
        "spending_limits_currency": "usd"
      },
      "status": "active",
      "type": "virtual",
      "wallets": {
        "apple_pay": {
          "eligible": true,
          "ineligible_reason": null
        },
        "google_pay": {
          "eligible": true,
          "ineligible_reason": null
        },
        "primary_account_identifier": null
      }
    }
  ],
  "has_more": false,
  "url": "/v1/issuing/cards"
}

Cards API の GET リクエストに cardholder パラメーターを含めると、特定のカード保有者に関連付けられたカードのリストを表示できます。特定の Stripe-Account をヘッダーに渡して、カード保有者 ID を cardholder パラメーターに渡します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -G https://api.stripe.com/v1/issuing/cards \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d cardholder=ich_1234a