# 決済の適用

未決済の請求書に決済を適用する方法をご覧ください。

決済の適用を使用して、未払いの請求書に決済を適用したり、消し込みミスを修正したりできます。Stripe Invoicing または Stripe Billing を使用していて銀行振込、小切手、または Stripe 外で決済を受け取る場合、請求書に対して決済を手動で適用または適用解除しなければならないことがあります。請求書を使用せずに決済を回収し、その決済を請求書に適用することもできます。

請求書への決済の適用または請求書からの決済の適用解除を行う前に、以下の点を考慮します。

- [collection_method](https://docs.stripe.com/api/invoices/object.md#invoice_object-collection_method) = `send_invoice` の請求書からのみ決済の適用を解除できます。
- 決済の一部を請求書に適用することはできません。決済全体を請求書にのみ適用できます。つまり、1 回の決済を複数の請求書に適用することはできません。
- Stripe との連携の一部で請求書を再開できないと想定している場合は、支払い済みの請求書を再開する前に、連携を更新する必要があるかどうかを評価します。たとえば、Stripe イベントを使用して下流の会計システムを更新している場合は、連携が再開された請求書を処理できる状態かどうかを確認してください。
- Stripe Connector for NetSuite は請求書への決済の適用をサポートしていません。コネクターを使用して請求書を再度開いても、コネクターは NetSuite で請求書は再度開かれません。

## 請求書に決済を適用する

決済金額が請求書の未払い残高以下で請求書が決済と同じ顧客に対するものである場合は、請求書に任意の決済を適用できます。請求書に全額を支払う決済を適用すると、ステータスは `paid` に移行します。

#### ダッシュボード

1. **取引** > **決済** に移動します。
1. 請求書に適用する決済の決済 ID をコピーします。
1. 決済を適用する請求書に移動します。
1. オーバーフローメニュー (⋯) をクリックし、 **決済の適用** を選択します。
1. 決済 ID を入力し、 **次へ** をクリックします。

#### API

```curl
curl https://api.stripe.com/v1/invoices/in_xxxxxxx/attach_payment \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "payment_intent={{PAYMENTINTENT_ID}}"
```

決済の一部を 1 つの請求書に適用することはできません。たとえば、1 回の決済を使用して複数の請求書に支払うことはできません。ただし、決済が銀行振込から作成されている場合は、[決済を現金残高に返金](https://docs.stripe.com/payments/customer-balance/refunding.md#refund-customer-balance-payment-customer-balance)してから、その資金をさまざまな請求書金額に適用できます。

[自動消し込みを無効にして](https://docs.stripe.com/payments/customer-balance/reconciliation.md#cash-override-reconciliation-behavior)から決済を現金残高に返金し、請求書に対する残高の消し込みを防ぎます。

## 請求書から決済の適用を解除する

請求書の詳細ビューの **決済** セクションでは、決済の適用を管理できます。このビューでは、決済の適用を解除して未適用のままにすることも、別の請求書に再適用することもできます。

Stripe ダッシュボードでのみ決済の適用を解除できます。

1. 決済の適用を解除する請求書の **決済** セクションに移動します。
1. 決済のオーバーフローメニュー (⋯) をクリックし、 **アプリケーションの管理** をクリックします。
1. 請求書から決済の適用を解除するか、決済の適用を解除してから別の未払いの請求書に適用するかを選択します。

請求書から決済の適用を解除すると、ステータスは `Open` に戻ります。ダッシュボードでは請求書は `Open`、`Past Due`、`Partially Paid`、または `Failed` と表示されます。

### 自動回収

請求書を再度開くと、[自動回収](https://docs.stripe.com/invoicing/automatic-collection.md)はデフォルトで無効になります。請求書を再度開いた場合、次のような動作が予想されます。

| シナリオ                    | auto-advance がオフの場合の結果              |
| ----------------------- | ----------------------------------- |
| 決済のために送信された 1 回限りの請求書   | リマインダーは送信されません                      |
| 決済のために送信されたサブスクリプション請求書 | - 再試行なし
  - サブスクリプションのステータスは変わりません。 |

[自動回収を有効にする](https://docs.stripe.com/invoicing/automatic-collection.md)と、設定に基づいてリマインダーの送信、失敗した決済の再試行、請求書とサブスクリプションのステータスの変更を再開できます。

### 自動回収の例

以下の例は、再開された請求書の自動回収を有効にするさまざまなシナリオを示しています。

#### 例 1

- 1 月 1 日に期限が到来する決済の 1 回限りの請求書を送信し、顧客が 1 月 1 日に支払います。
- 顧客のメール設定で期日の 3 日後、期日の 5 日後、期日の 14 日後にリマインダーを送信するように構成します。
- 請求書は 1 月 10 日に再開され、自動回収が有効になります (`auto_advance = true`)。
- 顧客が請求書をまだ支払っていない場合は、14 日目にリマインダーが送信されます。

#### 例 2

- 1 月 1 日に期限が到来する決済のサブスクリプション請求書を送信し、顧客が 1 月 1 日に支払います。
- 顧客のメール設定で期日の 3 日後、期日の 5 日後、期日の 14 日後にリマインダーを送信するように構成します。
- 請求書が 30 日を超えて期限超過の場合、サブスクリプションをキャンセルし、請求書を `uncollectible` としてマークするようにサブスクリプション設定を構成します。
- 請求書は 1 月 7 日に再開され、自動回収が有効になります (`auto_advance = true`)。
- 顧客が請求書をまだ支払っていない場合は、14 日目にリマインダーが送信されます。
- 顧客が請求書をまだ支払っていない場合、30 日目にサブスクリプションはキャンセルされ、請求書は`回収不能`とマークされます。

### サブスクリプションステータス

サブスクリプション請求書の場合、決済の適用を解除してもサブスクリプションのステータスは影響を受けません。ただし、[自動回収を有効にする](https://docs.stripe.com/invoicing/automatic-collection.md) (`auto_advance=true`) と、請求書の期日超過日を基準にしてリカバリ設定内の最終督促アクションが有効になります。

### 通知

請求書を再度開いても、顧客に直接通知は送信されません。ただし、[オンライン請求書ページ](https://docs.stripe.com/invoicing/hosted-invoice-page.md)と[カスタマーポータル](https://docs.stripe.com/customer-management.md)の両方に請求書の更新ステータスが反映されます。

[収益認識の影響](https://docs.stripe.com/revenue-recognition/methodology/subscriptions-and-invoicing.md#cash-application)についてご覧ください。

### 適用されていない決済を見つける

請求書に適用されていない決済はすべて未適用と見なされます。以前に決済を切り離していて、すべての決済が請求書に正しく適用されていることを確認する場合は、API を使用して未適用の決済を検索できます。

請求書から決済が切り離されると、`invoice_payment.detached` イベントがトリガーされます。これらのイベントの直近 30 日間を一覧表示できます。

```curl
curl -G https://api.stripe.com/v1/events \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "type=invoice_payment.detached"
```

Sigma または Stripe Data Pipeline を使用している場合は、請求書に適用されていない決済を Invoice Payments テーブルまたは Payments テーブルで確認できます。

### 未適用の決済を追跡する

Stripe ダッシュボードを使用せずにすべての未適用の決済を追跡するには、detach イベントをリッスンし、メタデータを使用して未適用の決済にスタンプを押す連携を構築します。

#### Webhook イベントを設定する

未適用の請求書決済を追跡するには、請求書決済に関連する特定の Webhook イベントをリッスンし、決済にフラグを立てます。

#### Ruby

```ruby
# Handler for webhook events
def webhook_handler(event)
  # Payment was detached
  if event.type == "invoice_payment.detached"
    invoice_payment = event.data.object
    payment_intent = invoice_payment.payment.payment_intent

    # Update metadata to track this
    Stripe::PaymentIntents.update(payment_intent, {
      metadata: {
        unapplied: true,
        unapplied_from: invoice_payment.invoice,
      }
    })
  else
    # Handle other event types if necessary
  end
end
```

#### 請求書決済の適用または再適用

請求書の決済を適用または再適用するときは、PaymentIntent から未適用のステータスをクリアしてください。

#### PaymentIntent を請求書に関連付ける

```curl
curl https://api.stripe.com/v1/invoices/in_1MtHbELkdIwHu7ixl4OzzPMv/attach_payment \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d payment_intent=pi_3MvUdLLkdIwHu7ix1nItxHNQ
```

#### 未適用メタデータフィールドをクリアする

```curl
curl https://api.stripe.com/v1/payment_intents/pi_3MvUdLLkdIwHu7ix1nItxHNQ \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "metadata[unapplied]=false" \
  -d "metadata[unapplied_from]="
```

#### 未適用の請求書決済をレンダリングする

Search API を使用して適用されていない請求書の決済を一覧表示し、必要に応じて UI に表示します。

```curl
curl -G https://api.stripe.com/v1/payment_intents/search \
  -u "<<YOUR_SECRET_KEY>>:" \
  --data-urlencode "query=metadata['unapplied']:'true'"
```