# Overcapture

### Overview

In card payments, Overcapture occurs when a merchant captures (settles) an amount greater than the originally authorized amount. Juspay Hyperswitch enables this capability for supported Payment Service Providers (PSPs).

This is particularly useful in scenarios such as:

* Additional charges (e.g., shipping, handling, gratuities)
* Price adjustments made after initial authorization
* Reducing the risk of under-capturing when final order values differ

#### Supported PSPs

Currently, Hyperswitch supports Overcapture for the following PSPs:

* Stripe
* Adyen

If you need Overcapture support for other PSPs, please contact the Hyperswitch Support Team.

### How to Enable Overcapture

Overcapture can be enabled in two ways:

#### 1. Profile-level Configuration (via Dashboard)

1. Navigate to: Developer → Payment Settings → Always Enable Overcapture
2. Toggle Enable/Disable as required.

#### 2. Per-request Configuration (via API)

Use the boolean field `enable_overcapture` in your payment request.

This flag can be set in the following API calls:

* `/payments/create` with `confirm = false`
* `/payments/update`
* `/payments/create` call with `confirm = true`

> **Note:**
>
> * The request-level `enable_overcapture` will override the profile-level setting.
> * Overcapture is only applicable for manual capture payments (`capture_method = manual`).

#### Example: API Request

```json
{
  "amount": 100,
  "currency": "USD",
  "confirm": true,
  "capture_method": "manual",
  "enable_overcapture": true,
  "payment_method": "card",
  "payment_method_type": "credit",
  "payment_method_data": {
    "card": {
      "card_number": "4111111111111111",
      "card_exp_month": "03",
      "card_exp_year": "30",
      "card_cvc": "7373"
    }
  }
}
```

#### Example: API Response

```json
{
  "payment_id": "pay_GPnTPs4e56yZ8FKAcj0K",
  "status": "requires_capture",
  "amount": 100,
  "amount_capturable": 100,
  "connector": "adyen",
  "enable_overcapture": true,
  "is_overcapture_enabled": true,
  "capture_method": "manual",
  "payment_method": "card",
  "payment_method_type": "debit",
  "network_transaction_id": "112181545921495",
  "created": "2025-09-24T11:29:55.629Z",
  "expires_on": "2025-09-24T11:44:55.629Z"
}
```

* `enable_overcapture`
  * `true` → Overcapture was requested for this payment.
  * `false` → Overcapture was not requested.
* `is_overcapture_enabled`
  * `true` → Connector enabled Overcapture for this payment.
  * `false` → Overcapture is not applicable for this PSP/payment.

### Monitoring & Settlement

* After authorization, merchants can view the `amount_capturable` field (under More Payment Details) to see the maximum amount that can be captured.
* Once the payment is captured (or overcaptured), the final amount will be reflected in the `amount_received` field.

### Merchant Action

* Use Dashboard settings for global enablement
* Use API overrides for payment-specific enablement
* Monitor capturable and received amounts to track final settlements
* Contact Hyperswitch Support for enabling Overcapture with PSPs other than Stripe and Adyen

With Juspay Hyperswitch, merchants gain flexibility in handling post-authorization adjustments—ensuring smooth settlements without losing revenue.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hyperswitch.io/other-features/payment-orchestration/quickstart/overcapture.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.