Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Developer tools
Get started
Payments
Finance automation
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Overview
Versioning
Changelog
Upgrade your API version
Upgrade your SDK version
Developer tools
SDKs
API
Testing
Workbench
Event Destinations
Workflows
Stripe CLI
Stripe Shell
Developers Dashboard
Agent toolkit
Stripe health alertsBuilding with LLMsStripe for Visual Studio CodeFile uploads
Security
Security
Extend Stripe
Stripe Apps
Stripe Connectors
    Overview
    Integrate a connector
    Commercetools
    Adobe Commerce
      Payments and tax connector for Adobe Commerce
      Standalone tax connector for Adobe Commerce
      Cookbooks
        Add additional metadata to payments
        Hide the terms displayed in the PaymentElement form
        Place an order before a 3D Secure payment is collected
        Style the payment form at the checkout
        Test why a specific payment method doesn't appear
        Integrate a custom fee to the tax calculation
        Enable manual capture
        Enable multicapture
        Enable overcapture
        Add external payment methods to the payment form
        Disable shipping methods in the Express Checkout modals
        Add custom events to Stripe webhooks
    Mirakl
    NetSuite
    Oracle Opera
    Cegid
    PrestaShop
    Salesforce
    SAP
    Shopware 6
    Stripe Tax for WooCommerce
    Stripe Tax for BigCommerce
    Partner connectors
    Build your own connector
Partners
Partner ecosystem
Partner certification
HomeDeveloper toolsStripe ConnectorsAdobe CommerceCookbooks

Enable overcapture

Capture more than the authorized amount.

Copy page

Overcapture allows you to capture more than the amount authorized during order placement. The amount you can capture depends on the card network and your country and merchant category.

IC+ feature

Overcapture is an IC+ feature. If you’re on blended Stripe pricing and want access to this feature, contact Stripe Support.

The Stripe module supports overcapture by default. This guide describes how to enable it through a customization.

Create a new module

Create a new module with the following directory structure. Replace Vendor with your vendor name.

app/code/Vendor/StripeCustomizations/ ├── etc/ │ ├── module.xml │ └── config.xml ├── registration.php

Inside registration.php, register your module with Magento.

<?php \Magento\Framework\Component\ComponentRegistrar::register( \Magento\Framework\Component\ComponentRegistrar::MODULE, 'Vendor_StripeCustomizations', __DIR__ );

Inside etc/module.xml, define the module and set up dependencies to make sure it loads after the Stripe module.

<?xml version="1.0"?> <config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd"> <module name="Vendor_StripeCustomizations" setup_version="1.0.0"> <sequence> <module name="StripeIntegration_Payments"/> </sequence> </module> </config>

Inside etc/config.xml, override the following settings from the Stripe module:

<?xml version="1.0"?> <config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Store:etc/config.xsd"> <default> <stripe_settings> <overcapture_enabled>1</overcapture_enabled> </stripe_settings> </default> </config>

Enable the module:

php bin/magento module:enable Vendor_StripeCustomizations php bin/magento setup:upgrade php bin/magento cache:clean php bin/magento cache:flush

How overcapture works

When you invoice an order from the Magento admin, a new Custom Capture Amount input appears above Submit Invoice. The store’s base currency symbol also appears in the input box, signaling that you must provide the overcapture amount in the base currency.

Leave the input box empty to capture the full amount of the invoice. Enter a custom amount to capture an alternate amount upon invoice submission, if the card network supports it.

Other considerations

Using overcapture to update an authorized payment can affect the accuracy of your reconciliation:

  • The invoice or order document doesn’t reflect a custom capture amount.
  • Stripe Tax relies on the taxes visible on the invoice to record and reverse taxes, so it also doesn’t reflect the custom capture amount.

To make sure dependent products and documents match the final payment, consider using the Payment Action = Order configuration setting instead. This saves the customer’s payment method, but doesn’t attempt an authorization. You can then edit the order before issuing the invoice, and the totals match the captured amount.

Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access program.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc