# 債務の支払い

FundingObligation の返済を行います。

`FundingObligation` では、クレジット期間末時点における連結アカウントの債務が示されますが、連結アカウントから返済を回収する責任はお客様にあります。Stripe の [Payment Intents API](https://docs.stripe.com/payments/payment-intents.md) を使用して、連結アカウントの外部銀行口座からの引き落としを設定します (または Stripe Checkout または Stripe Invoicing を使用したカード決済を受け付けます)。

必ず、アカウントの `FundingObligation` で連結アカウントから受け付けた決済をすべて記録して、利用可能なクレジットを正確に反映してください。Stripe では、アカウントの利用可能なクレジットに基づいて、オーソリを承認するかどうかを決定します。Stripe は期日を過ぎたチャージオフの `FundingObligations` を銀行パートナーに報告する場合があります。

## 返済を回収する

連結アカウントから返済を回収するのに最適なメカニズムを選択できます。ただし、Stripe の[支払い API](https://docs.stripe.com/payments/payment-intents.md) を使用して、Stripe 内にすべてのレコードを保管し、各ユーザーのカード支出と返済の照合を改善することをお勧めします。返済を回収できた場合は、必ず `FundingObligation` を更新してそれを反映してください。Stripe の[支払い API](https://docs.stripe.com/payments/payment-intents.md) を使用する場合、このステップは自動的に実行されません。Stripe は、`CreditPolicy` に設定されている `days_until_due` パラメーターに基づいて `past_due` を決定します。Stripe は、`past_due` の支払い義務が `charged_off` になってからの日数を定義する、お客様の書面によるクレジットまたは回収ポリシーに基づいて `charged_off` を決定します。

## FundingObligation で返済を記録する

連結アカウントから返済を回収した後に、`FundingObligation` を更新してその返済を反映させます。`unpaid`、`past_due`、または `charged_off` の状態の `FundingObligations` があると、連結アカウントでの支出で利用可能な資金の額に影響が出ます。たとえば、Barbell のクレジット限度額が 1,000 USD で、900 USD のランニングマシンを購入したとします。Barbell の `FundingObligation` の債務の `amount_total` は 900 USD で、債務の返済を開始するまで、支出で利用可能なクレジットは残り 100 USD になります。

クレジット期間末時点で、Barbell が 500 USD を Gymbox に返済したとします。Gymbox は Barbell の `FundingObligation` を更新してこの返済を反映させる必要があります。この更新により、`FundingObligation` の `amount_outstanding` が 400 USD に減るため、Barbell の利用可能なクレジットが 100 から 600 USD に増加します。

Barbell のクレジット規約で、`FundingObligation` の `amount_outstanding` が `due_at` 後 90 日で貸倒処理されると仮定します。90 日を超えた `past_due` 状態で、Barbell の `amount_outstanding` 400 USD が貸倒処理されます。`FundingObligation` の `amount_outstanding` を貸倒処理してから 30 日後、Gymbox は Barbell から 100USD の決済を受け取ります。Gymbox は、`/pay` エンドポイントを使用してこの返済を記録し、`FundingObligation` の貸倒処理された `amount_outstanding` の相殺を減らすために、この返済を減額する必要があります。これにより利用可能クレジットが 600 から 700 USD に増加します。Gymbox が完全回収前に Barbell のクレジットラインを閉鎖し、その理由を報告した場合、貸倒処理された `amount_outstanding` は存続し、その後回収された金額は `amount_outstanding` の減額に適用できなくなります。

```curl
curl https://api.stripe.com/v1/issuing/funding_obligations/ifo_123/pay \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-03-25.preview; issuing_credit_beta=v1" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d amount=50000
```

### レスポンスの例

```json
{
  "id": "ifo_123",
  "status": "unpaid",
  "amount_total": 90000,"amount_outstanding": 40000,
  "amount_paid": 50000,
  "owed_to": "acct_123",
  // other fields
}
```

この API コールにより、`FundingObligation` で `amount_paid` が増え、`amount_outstanding` が減ります。`FundingObligation` で `amount_paid=amount_total` になると、Stripe は以前の状態が `unpaid`、`past_due`、または `charged_off` であったかどうかに関係なく、債務のステータスを `paid` に更新します。この更新により、`issuing_funding_obligation.updated` イベントがトリガーされます。

返済を回収するプロセスと `FundingObligation` を更新するプロセスの両方を自動化し、両プロセスを一連のコールに組み込むことをお勧めします。そのようにすることで、返済の回収直後に連結アカウントの `FundingObligation` を更新して Stripe に通知し、利用可能なクレジットを増やすことができます。

## FundingObligation で返済済みの金額を更新する

誤って返済したなどの理由で連結アカウントの `amount_paid` を更新する場合は、`amount_paid` フィールドを指定して `/pay` エンドポイントを使用します。

```curl
curl https://api.stripe.com/v1/issuing/funding_obligations/ifo_123/pay \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-03-25.preview; issuing_credit_beta=v1" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d amount_paid=45000
```

### レスポンスの例

```json
{
  "id": "ifo_789",
  "status": "unpaid",
  "amount_total": 90000,"amount_outstanding": 45000,
  "amount_paid": 45000,
  "owed_to": "acct_123",
  // other fields
}
```

これにより、`issuing_funding_obligation.updated` イベントが送信されます。

## FundingObligation のメタデータを更新する

`FundingObligation` の[メタデータ](https://docs.stripe.com/api/metadata.md)を更新し、追加データを `FundingObligation` に関連付けることができます。例えば、返済に対応する `OutboundPayment` ID を記録したいような場合が該当します。

```curl
curl https://api.stripe.com/v1/issuing/funding_obligations/ifo_123/ \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-03-25.preview; issuing_credit_beta=v1" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d "metadata[repayment_id]=obp_1NUy3y2eZvKYlo2C15gktUET"
```

### レスポンスの例

```json
{
  "id": "ifo_789",
  "status": "unpaid",
  "amount_total": 90000,"metadata": {
    "repayment_id": "obp_1NUy3y2eZvKYlo2C15gktUET"
  },
  "owed_to": "acct_123",
  // other fields
}
```

これにより、`issuing_funding_obligation.updated` イベントが送信されます。