# クレジット規約を管理する 連結アカウントのクレジット規約を管理する方法をご紹介します。 CreditPolicy の [credit_limit_amount](https://docs.stripe.com/api/issuing/credit_policy/object.md#issuing_credit_policy_object-credit_limit_amount) または [credit_period_interval](https://docs.stripe.com/api/issuing/credit_policy/object.md#issuing_credit_policy_object-credit_period_interval) を更新して、連結アカウントのクレジット規約を変更します。プラットフォームの Issuing アカウントによってサポートされる、連結アカウントの支出機能を `inactive` にすることもできます。 ## クレジット限度額を更新する CreditPolicy の `credit_limit_amount` を更新して、連結アカウントのクレジット限度額を変更できますが、まず CreditUnderwritingRecord でリスク評価判定を報告する必要があります。最初に CreditUnderwritingRecord で同じ金額を申告せずに `credit_limit_amount` を更新しようとすると、エラーが発生します。 CreditUnderwritingRecord API を使用してクレジット限度額を変更するためのリスク評価判定の報告には、3 つのシナリオがあります。 #### クレジット限度額の増額を承認する ## アカウントのクレジット限度額の増額リクエストを承認する 連結アカウントがクレジット限度額の引き上げをリクエストする場合、まずはリクエストを申し込みとして報告し、承認または拒否の決定を報告します。 CreditUnderwritingRecord API の [create_from_application](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_application.md) エンドポイントを使用して、アカウントのリクエストを記録します。申し込みの [purpose (目的)](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_application.md#create_from_application-application-purpose) を `credit_limit_increase` とし、`submitted_at` を使用して顧客がリクエストを送信した日時を報告します。これが既存ユーザーの場合であっても、`credit_user` ハッシュで `name` と `email` を提供する必要があります。 ```curl curl https://api.stripe.com/v1/issuing/credit_underwriting_records/create_from_application \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "credit_user[name]=Barbell Gym" \ --data-urlencode "credit_user[email]=barbell-gym@gmail.com" \ -d "application[purpose]=credit_limit_increase" \ -d "application[submitted_at]=1681138952" ``` ### レスポンスの例 ```json { "object": "issuing.credit_underwriting_record", "id": "cur_1NiHAD2eZvKYlo2CmWGpt5OX", "credit_user": { "name": "Barbell Gym", "email": "barbell-gym@gmail.com" }, "created_from": "application", "application": { "purpose": "credit_limit_increase", "submitted_at": 1681138952, "application_method": "online" }, "decision_deadline": 1683601352 // 30 days after submission } ``` 2 つ目のステップは、[report_decision](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/report_decision.md) エンドポイントを使用した、申し込みの承認または拒否です。顧客が申し込みを送信してから 30 日後の [decision_deadline](https://docs.stripe.com/api/issuing/credit_underwriting_record/object.md#credit_underwriting_record_object-decision_deadline) までに、決定内容を必ず報告してください。 申し込みを承認するには [decision type](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/report_decision.md#report_decision-decision-type) に `credit_limit_approved` を設定し、承認済みの金額を指定します。 ```curl curl https://api.stripe.com/v1/issuing/credit_underwriting_records/{{CREDITUNDERWRITINGRECORD_ID}}/report_decision \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "decided_at={{DECISIONTIMESTAMP_ID}}" \ -d "decision[type]=credit_limit_approved" \ -d "decision[credit_limit_approved][amount]=200000" \ -d "decision[credit_limit_approved][currency]=usd" ``` 一方で申し込みを拒否するには、上記と同じステップに従いますが、決定のタイプを `application_rejected` に設定し、拒否の理由を [application_rejected.reasons](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/report_decision.md#report_decision-decision-application_rejected-reasons) で指定します。このシナリオについて、詳細は[クレジット限度額の増額の申し込みを拒否し、拒否理由を報告する](https://docs.stripe.com/issuing/credit/report-credit-decisions-and-manage-aans.md#reject-application)をご覧ください。 #### クレジット限度額を事前に増額する ## 顧客のリクエストを受ける前にクレジット限度額を増額する 顧客からの申し込みを受け取らずに、連結アカウントのクレジット限度額を増額するには、CreditUnderwritingRecord の [create_from_proactive_review](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_proactive_review.md) エンドポイントを使用して 1 つのステップで決定を報告します (詳細は、[リスク評価判定を事前に行う](https://docs.stripe.com/issuing/credit/report-credit-decisions-and-manage-aans.md#make-proactive-decisions)をご覧ください)。 [決定のタイプ](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_proactive_review.md#create_from_proactive_review-decision-type)を `credit_limit_approved` に設定し、新しい金額を [credit_limit_approved.amount](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/report_decision.md#report_decision-decision-credit_limit_approved-amount) に指定します。 ```curl curl https://api.stripe.com/v1/issuing/credit_underwriting_records/create_from_proactive_review \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "credit_user[name]=Barbell Gym" \ --data-urlencode "credit_user[email]=barbell-gym@gmail.com" \ -d "decided_at={{DECISIONTIMESTAMP_ID}}" \ -d "decision[type]=credit_limit_approved" \ -d "decision[credit_limit_approved][amount]=2000000" \ -d "decision[credit_limit_approved][currency]=usd" ``` ### レスポンスの例 ```json { "object": "issuing.credit_underwriting_record", "id": "cur_1NiHAD2eZvKYlo2CmWGpt5OX", "credit_user": { "name": "Barbell Gym", "email": "barbell-gym@gmail.com" }, "created_from": "proactive_review", "decided_at": 1681138965, "decision": { "type": "credit_limit_approved", "credit_limit_approved": { "amount": 2000000, "currency": "usd" } }, "decision_deadline": null // no deadline for proactive review } ``` #### クレジット限度額を事前に減額する ## クレジット限度額を減額し、理由を報告する 連結アカウントのクレジット限度額を減額するには、CreditUnderwritingRecord の [create_from_proactive_review](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_proactive_review.md) エンドポイントを使用して 1 つのステップでプラットフォームの決定を報告します (詳細は、[リスク評価判定を事前に行う](https://docs.stripe.com/issuing/credit/report-credit-decisions-and-manage-aans.md#make-proactive-decisions)をご覧ください)。 [決定タイプ](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_proactive_review.md#create_from_proactive_review-decision-type)を `credit_limit_decreased` に設定し、[credit_limit_approved.amount](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/report_decision.md#report_decision-decision-credit_limit_approved-amount)に新しい金額を指定します。クレジット限度額の引き下げは不利な処置に該当するため、[credit_limit_decreased.reasons](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_proactive_review.md#create_from_proactive_review-decision-credit_limit_decreased-reasons) にある理由リストから、引き下げの `reason` を少なくとも 1 つ (最大 4 つ) 提供する必要があります。これらは、申請却下の「主要な理由」であり、銀行承認済みのクレジットポリシーで定義された却下理由と一致している必要があります。不利な処置通知には、提供したすべての理由を含める必要があります (詳細は[不利な処置通知メールの送信](https://docs.stripe.com/issuing/credit/report-credit-decisions-and-manage-aans.md#sending-adverse-action-notice-emails)をご覧ください)。 ```curl curl https://api.stripe.com/v1/issuing/credit_underwriting_records/create_from_proactive_review \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "credit_user[name]=Barbell Gym" \ --data-urlencode "credit_user[email]=barbell-gym@gmail.com" \ -d "decided_at={{DECISIONTIMESTAMP_ID}}" \ -d "decision[type]=credit_limit_decreased" \ -d "decision[credit_limit_decreased][reasons][]=debt_to_cash_balance_ratio_too_high" \ -d "decision[credit_limit_decreased][reasons][]=runway_too_short" \ -d "decision[credit_limit_decreased][amount]=500000" \ -d "decision[credit_limit_decreased][currency]=usd" ``` ### レスポンスの例 ```json { "object": "issuing.credit_underwriting_record", "id": "cur_1NiHAD2eZvKYlo2CmWGpt5OX", "credit_user": { "name": "Barbell Gym", "email": "barbell-gym@gmail.com" }, "created_from": "proactive_review", "decided_at": 1681138965, "decision": { "type": "credit_limit_decreased", "credit_limit_decreased": { "reasons": ["debt_to_cash_balance_ratio_too_high", "runway_too_short"], "amount": 500000, "currency": "usd" } }, "decision_deadline": null // no deadline for proactive review } ``` > アカウントの `credit_limit_amount` を減額する場合には慎重に行ってください。アカウントのこれまでの支出が新しい `credit_limit_amount` をすでに超えている場合、オーソリが即時拒否されるようになる可能性があるからです。 それぞれのシナリオで、決定の報告後に CreditPolicy API を使用して、承認したものと同じ金額に `credit_limit_amount` を更新します。 ```curl curl https://api.stripe.com/v1/issuing/credit_policy \ -u "<>:" \ -H "Stripe-Version: 2026-04-22.preview; issuing_credit_beta=v1; issuing_underwritten_credit_beta=v1" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d credit_limit_amount=200000 ``` このアクションにより、`issuing_credit_policy.updated` Webhook イベントがトリガーされ、`CreditPolicy` の `credit_limit_amount` フィールドが即時に更新されます。 ### レスポンスの例 ```json { "livemode": true,"credit_limit_amount": 200000, // 2,000.00 USD "credit_limit_currency": "usd", "credit_period_interval": "month", "credit_period_interval_count": 1, "days_until_due": 1, "last_effective_attributes": { "effective_until": 1681138965, "credit_limit_amount": 100000, "credit_period_interval": "month", "credit_period_interval_count": 1, "days_until_due": 1, "status": "active" }, "upcoming_attributes": null } ``` ## クレジット期間を更新する 設定するクレジット期間は、銀行で承認されたクレジットポリシーに関するドキュメントで定義されたクレジット期間と必ず一致する必要があります。API でクレジット期間を変更する前に、作成したクレジットポリシーのドキュメントのクレジット期間を調整するための承認を Stripe から得る必要があります。また、影響を受けるアカウント所有者に、利用規約の変更に関する通知を送信する必要もあります。[platform-compliance@stripe.com](mailto:platform-compliance@stripe.com) に問い合わせて、必要な承認を収集してからアクションを実行するようにしてください。 Stripe から承認を受け取ったら、以下のステップに従って CreditPolicy API でクレジット期間を変更します。クレジット期間の変更時に CreditUnderwritingRecord を使用する必要はありません。 [upcoming_attributes](https://docs.stripe.com/api/issuing/credit_policy/update.md#update_issuing_credit_policy-upcoming_attributes) ハッシュのフィールドを更新することで、連結アカウントのクレジット期間を変更できます。`upcoming_attributes` を設定する際に `effective_at` タイムスタンプを渡して、変更を有効にするタイミングを設定する必要があります。 上記の例を使用して、プラットフォームである Gymbox が顧客のクレジット期間を 1 カ月から 15 日に変更することにしたとします。さらに、プラットフォームではこの変更を翌月の初日に有効にしたいと考えています。Stripe は、`upcoming_attributes` によるすべての変更を 00:00 UTC に有効にすることを求めているため、`effective_at` タイムスタンプは 10 桁で末尾を 00 にする必要があります。 プラットフォームは `upcoming_attributes` ハッシュを使用して、連結アカウントの `CreditPolicy` を次のように更新します。 ```curl curl https://api.stripe.com/v1/issuing/credit_policy \ -u "<>:" \ -H "Stripe-Version: 2026-04-22.preview; issuing_credit_beta=v1; issuing_underwritten_credit_beta=v1" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "upcoming_attributes[credit_period_interval]=day" \ -d "upcoming_attributes[credit_period_interval_count]=15" \ -d "upcoming_attributes[effective_at]={{EFFECTIVEATTIMESTAMP_ID}}" \ -d "upcoming_attributes[days_until_due]=0" ``` ### レスポンスの例 ```json { "livemode": true, "credit_limit_amount": 200000, "credit_limit_currency": "usd", "status": "active", "credit_period_interval": "month", "credit_period_interval_count": 1, "days_until_due": 1, "last_effective_attributes": { "effective_until": 1681138965, // time of previous update to credit period "credit_limit_amount": 200000, "credit_period_interval": "month", "credit_period_interval_count": 1, "days_until_due": 1, "status": "active" }, "upcoming_attributes": {"effective_at": 1693526400, // 1st day of the next month, 00:00 UTC "credit_period_interval": "day", "credit_period_interval_count": 15, "days_until_due": 0, } } ``` `effective_at` タイムスタンプになると、`CreditPolicy` が、`upcoming_attributes` ハッシュで指定された内容に自動的に更新されます。`last_effective_attributes` ハッシュは変更前の値を反映して更新されます。 ### レスポンスの例 ```json { "livemode": true, "credit_limit_amount": 200000, "credit_limit_currency": "usd", "status": "active","credit_period_interval": "day", "credit_period_interval_count": 15, "days_until_due": 0, "last_effective_attributes": { "effective_until": 1693526400, // 1st day of the next month, 00:00 UTC "credit_limit_amount": 200000, "credit_period_interval": "month", "credit_period_interval_count": 1, "days_until_due": 1, "status": "active" }, "upcoming_attributes": null } ``` これにより、`issuing_credit_policy.updated` イベントがトリガーされます。`effective_at` タイムスタンプの時点になると、クレジット期間の変更が有効になり、現在の期間の [FundingObligation (資金追加の義務)](https://docs.stripe.com/api/issuing/funding_obligations.md) が確定し、新しい `FundingObligation` が作成されて、新しいクレジット規約での新しいクレジット期間の開始がマークされます。 ## クレジットラインをクローズし、理由を報告する 連結アカウントのクレジットラインは、以下の 2 つのステップでクローズできます。 まず、CreditUnderwritingRecord API を使用して、決定の詳細を [create_from_proactive_review](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_proactive_review.md) エンドポイント経由で送信します。決定のタイプを `credit_line_closed` に設定して、少なくとも 1 つ、最大 4 つまでの理由を指定します。これらは申し込みを拒否する「主要な」理由であり、銀行が承認するクレジットポリシーで定義されている拒否理由と一致している必要があります。[クレジットラインのクローズは不利益措置](https://docs.stripe.com/issuing/credit/report-credit-decisions-and-manage-aans.md#credit-line-closed) であるため、該当するクローズ理由を記載した通知の送信が必要です。`credit_line_closed` の決定に対する [有効な決定理由の完全なリスト](https://docs.stripe.com/api/issuing/credit_underwriting_record/object.md#credit_underwriting_record_object-decision-credit_line_closed-reasons) をご覧ください。 ```curl curl https://api.stripe.com/v1/issuing/credit_underwriting_records/create_from_proactive_review \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "credit_user[name]=Barbell Gym" \ --data-urlencode "credit_user[email]=barbell-gym@gmail.com" \ -d "decided_at={{DECISIONTIMESTAMP_ID}}" \ -d "decision[type]=credit_line_closed" \ -d "decision[credit_line_closed][reasons][]=incomplete_application" ``` ### レスポンスの例 ```json { "object": "issuing.credit_underwriting_record", "id": "cur_1NiHAD2eZvKYlo2CmWGpt5OX", "credit_user": { "name": "Barbell Gym", "email": "barbell-gym@gmail.com" }, "created_from": "proactive_review", "decided_at": identifier("decisionTimestamp"), "decision": { "type": "credit_line_closed", "credit_line_closed": { "reasons": ["incomplete_application"] } }, "decision_deadline": null // no deadline for proactive review } ``` 次に、アカウントの CreditPolicy の[ステータス](https://docs.stripe.com/api/issuing/credit_policy/update.md#update_issuing_credit_policy-status)を `inactive` に設定します。 ```curl curl https://api.stripe.com/v1/issuing/credit_policy \ -u "<>:" \ -H "Stripe-Version: 2026-04-22.preview; issuing_credit_beta=v1; issuing_underwritten_credit_beta=v1" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d status=inactive ``` ### レスポンスの例 ```json { "livemode": true, "credit_limit_amount": 200000, "credit_limit_currency": "usd","status": "inactive", "credit_period_interval": "month", "credit_period_interval_count": 1, "days_until_due": 1, "last_effective_attributes": { "effective_until": "time_of_deactivation", "credit_limit_amount": 200000, "status": "active", "credit_period_interval": "month", "credit_period_interval_count": 1, "days_until_due": 1 }, "upcoming_attributes": null } ``` このステータスにより、`issuing_credit_policy.updated` イベントがトリガーされます。`CreditPolicy` を無効にすると、それから 31 日間、決済された [Transactions (取引)](https://docs.stripe.com/api/issuing/transactions/object.md) について説明する `FundingObligation` の更新を受け取り続けることになります。これは、無効化前に行われたオーソリが最大 31 日後までキャプチャーされる可能性があるためです。 連結アカウントの [Issuing 残高](https://docs.stripe.com/issuing/connect/funding.md)が 0 を下回る場合 (アカウントは Stripe に借入があることを示します)、CreditPolicy を `inactive` に設定しようとするとエラーが送信され、残高にトップアップ (資金を追加) してゼロに戻すことで CreditPolicy を無効にします。CreditPolicy のステータスが `inactive` になると、そのアカウントのカードでオーソリを試行するとアカウントの [Issuing 残高](https://docs.stripe.com/issuing/connect/funding.md)から資金供給され、残高が不足している場合は拒否されます。 ステータスを `inactive` にしてクレジットラインをクローズしたら、顧客から新しい申し込みを受け取っていない限り、ステータスを `active` に戻してもラインを再オープンすることはできません。この場合は、[新たに承認された信用取引の申し込みを報告する](https://docs.stripe.com/issuing/credit/connect-credit-setup.md#record-application-details)ための手順に従います。 ## card_issuing_charge_card ケイパビリティを取り消す 銀行によって承認されたクレジットポリシーのリスク評価基準を満たさなくなった、または利用規約に違反しているため、プラットフォームの Issuing アカウントを使用した連結アカウントのサポートを停止した場合、`CreditPolicy` を無効のままにします。また、`card_issuing_charge_card` ケイパビリティのリクエストを解除することで、これを無効化する必要もあります。 ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTED_STRIPE_ACCOUNT_ID}} \ -u "<>:" \ -d "capabilities[card_issuing_charge_card][requested]=false" ``` ユーザーが[連結アカウントにクレジットを設定する](https://docs.stripe.com/issuing/credit/connect-credit-setup.md#activate-funding-credit)手順に従って新しい申し込みを提出する場合、今後同じ連結アカウントに対してもう一度 `card_issuing_charge_card` ケイパビリティをリクエストできます。 連結アカウントの `card_issuing` ケイパビリティが有効なままであれば、連結アカウントに対して引き続きカードを発行できます。ただし、カードが機能するようにするには、連結アカウントの [Issuing 残高](https://docs.stripe.com/issuing/connect/funding.md)に資金を追加する必要があります。 ## Webhook のサマリー 次の 2 つの Webhook を監視できます。 - `issuing_credit_policy.created`: `CreditPolicy` が作成されるたびにトリガーされます。これは、連結アカウントのケイパビリティがリクエストされたときに生じます。 - `issuing_credit_policy.updated`: `CreditPolicy` が更新されるたびにトリガーされます。これは、プラットフォームで連結アカウントのポリシーが更新されたときに生じます。