Issuing と Connect の実装を設定する

カードを発行するには、各法人が連結アカウントを使用する必要があります。Issuing は、Stripe がホストするダッシュボードを使用せず、プラットフォームが要件の収集と損失に対する責任を負う連結アカウント (Custom 連結アカウントとも呼ばれる) のみをサポートします。Issuing と連携可能な連結アカウントの作成方法についてご確認ください。すべてのアカウントは card_issuing と transfers アカウントケイパビリティをリクエストする必要があります。

アカウントを作成する

新しい連結アカウントを、ダッシュボード経由でまたは create Account を指定した API を使用して作成します。

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d country=US \
  -d "capabilities[transfers][requested]"=true \
  -d "capabilities[card_issuing][requested]"=true \
  -d "controller[stripe_dashboard][type]"=none \
  -d "controller[fees][payer]"=application \
  -d "controller[losses][payments]"=application \
  -d "controller[requirement_collection]"=application

既存の連結アカウントで Issuing を有効にする

プラットフォームにすでに連結アカウントとの Connect 連携がある場合は、それらのアカウントでダッシュボードからまたは API を通じて Issuing をリクエストできます。

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "capabilities[card_issuing][requested]"=true

また、API を使用してアカウント情報を取得し、capabilities プロパティで Issuing ケイパビリティがリクエストされていることを確認することもできます。このケイパビリティは、すべての要件が満たされるまでアクティブになりません。

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

{
  "object": "list",
  "data": [
    {
      "id": "acct_1234",
      "object": "account",
    ...
      "capabilities": {
        "card_issuing": "inactive",
        "transfers": "active",
      },
    ...
      "controller": {
        "stripe_dashboard": {
          "type": "none"
        },
        "fees": {
          "payer": "application"
        },
        "losses": {
          "payments": "application"
        },
        "is_controller": true,
        "type": "application",
        "requirement_collection": "application"
      },
    },
  ...
  ]
}

連結アカウントの作成後、アカウント所有者に関する詳細情報を提出する必要があります。Capability (ケイパビリティ) オブジェクトには requirements ハッシュがあり、このハッシュには currently_due の本人確認要件が格納されています。ユーザーは、Issuing のケイパビリティを有効にするために、requirements ハッシュに列挙されている詳細を提供する必要があります。

Test Account オブジェクトを作成し、オンボーディング要件をバイパスして機能をテストする場合は、Accounts Update API を使用して、すべての要件を満たすテスト値を指定します。

ユーザーはビジネスタイプに応じて、個人、企業、非営利組織、政府機関に関する詳細を提供します (Stripe Treasury は政府機関には対応していません)。

次のアカウント登録オプションのいずれかを選択します。

curl https://api.stripe.com/v1/account_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account={{CONNECTED_ACCOUNT_ID}} \
  --data-urlencode refresh_url="https://example.com/reauth" \
  --data-urlencode return_url="https://example.com/return" \
  -d type=account_onboarding

{
  "object": "account_link",
  "created": 1612927106,
  "expires_at": 1612927406,
  "url": "https://connect.stripe.com/setup/s/…"
}

必要な情報を収集して確認する

連結アカウントを作成してケイパビリティをリクエストすると、レスポンスですべての必須情報のリストが返されます。ケイパビリティ固有の要件を確認するには、アカウントのケイパビリティを取得して、requirements.past_due をご覧ください。

card_issuing ケイパビリティの本番環境利用の申請に必要な要件は次のとおりです。

代表者および会社代表者

企業と非営利団体の場合は、代表者 (取締役 [relationship.director]、エグゼクティブ [relationship.executive])、および会社の 25% 超を所有する会社代表者 (relationship.owner) に関するアカウント登録情報がさらに必要になります。連結アカウントのそれぞれに 1 人以上の代表者が必要です。通常、この代表者はアカウントの所在地に応じてエグゼクティブか、取締役になります。代表者は提供した情報が正しいことを証明できなければなりません。会社代表者は必要ありません。

会社代表者、代表者、取締役の詳細をご確認ください。

アカウントは、すべての必要な情報を提供した後で、追加の詳細情報や書類を提供しなければならない場合があります。このような新しい要件は、requirements.eventually_due 配列または requirements.currently_due に表示されます。Webhook を使用してアカウントの要件の変更をリッスンするように、システムを設定してください。

ケイパビリティがすでに active であり、アカウントがそのケイパビリティの新しい要件を現在の期日までに満たさない場合、要件が満たされるまで、ケイパビリティは inactive になります。

書類のアップロード

アカウントの情報を確認できない場合、Stripe では、本人確認のための書類 (パスポートなど) か、法人に関する情報を確認できる (税務当局からの通知などの) 書類が必要になることがあります。書類要件を満たすには、プラットフォームがユーザーを Connect アカウント登録 (書類のアップロードを求められます) に送るか、別のインターフェイスでアカウントから書類を収集して API でアップロードします。

最初の申し込みから 29 日以内に本人確認ができない

アカウントが Issuing に必要な情報をすべて提出して、Issuing の利用規約に同意すると、Stripe は、申し込みが完了したものと見なします。アカウントの情報を確認できない場合は、アカウントが追加の情報を提供するか、書類をアップロードするまで、ケイパビリティは inactive のままになります。

アカウントが申請の完了後に 29 日間 inactive のままである場合は、本人確認を行うことができなかったことが記載されたメール通知 (テンプレートを参照) をアカウントに送信する必要があります。

Stripe は未確認の ID で完了したアプリケーションを監視し、本番環境では 29 日後、テスト環境では 1 時間後に次のアクションを実行します。

• アカウント通知を生成する
• Issuing の利用規約への同意ハッシュをクリアして、利用規約への同意を currently_due 要件にする

ビジネス情報を更新して Issuing の規約の新たな同意を記録することで、いつでも新しい申し込みを提出できます。

Stripe は、アカウント登録の最後のステップとして利用規約を提示することをお勧めします。こうすると、利用規約の同意日付を参照して、申し込みの完了のタイミングを追跡できます。

利用規約の違反

Stripe は、Stripe の利用規約に違反した Connect アカウントを確認すると、そのアカウントで Issuing ケイパビリティを inactive に設定して、カードを無効にし、アカウントに通知します (メールテンプレートをご覧ください)。これは、アカウントのカードが禁止 / 制限付き業種 (違法行為、ギャンブル、銃、アダルトコンテンツ、仮想通貨など)、または Issuing で禁止されている活動 (消費者支出、主に海外での使用、ローン、その他の不正または非準拠の使用など) に関連して使用された場合に起こることがあります。

395 日以上利用されていないアカウント

Stripe は、過去 13 カ月 (395 日間) にカード取引を完了していないアカウントに対して Issuing を無効にします。追加機能を利用するアカウントの場合、Stripe は、過去 395 日間に支払いまたは Treasury の取引がなく、Treasury の残高が 9.99 USD 以下である場合にのみ、Issuingを無効にします。非アクティブであることが原因で Issuing が無効になると、Connect アカウントの card_issuing ケイパビリティのステータスは inactive になり、ケイパビリティ要件の disabled_reason には rejected.inactivity と表示されます。Issuing での非アクティブなアカウントの管理の詳細をご覧ください。

Cardholder オブジェクトは、カードの発行対象になり得る個人や法人を表します。バーチャルカードや物理カードの発行先になるには、カード保有者のそれぞれに連結アカウントが関連付けられている必要があります。1 つの連結アカウントに多数のカード保有者が存在できます。

カード保有者とカードの詳細をご覧ください。

Issuing 残高は、連結アカウントのメインの残高とは分離されます。発行されたカードが取引に使用されたときは、Issuing 残高から引き落とされます。

発行されたカードを取引に使用するには、事前にカードに関連付けられた連結アカウントの Issuing 残高に資金を割り当てる必要があります。Issuing 残高にはカードに予約された資金が保持され、利益、入金、他の Stripe プロダクトからの資金から安全に分離されます。Issuing の連結アカウントへの資金追加方法をご確認ください。