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
About Stripe payments
Upgrade your integration
Payments analytics
Online payments
OverviewFind your use caseManaged Payments
Use Payment Links
Build a checkout page
Build an advanced integration
Build an in-app integration
Payment methods
Add payment methods
Manage payment methods
Faster checkout with Link
Payment interfaces
Payment Links
Checkout
Web Elements
In-app Elements
Payment scenarios
Custom payment flows
Flexible acquiring
    Overview
    Capture a payment multiple times
    Capture more than the authorized amount on a payment
    Place an extended hold on an online card payment
    Increment an authorization
    Partially authorize a payment
    Migrate from beta
Orchestration
In-person payments
Terminal
Other Stripe products
Financial Connections
Crypto
Climate
HomePaymentsFlexible acquiring

Partial authorization

Learn how to allow partial payments for card transactions.

Copy page

Use partial authorizations to request approval for a portion of the originally requested amount for a card transaction when the available balance is insufficient to cover the full amount. This allows your customers to use the available balance on their card (such as a debit card), then use an alternative payment method to pay the remaining balance.

Before you begin

First, decide how you want to handle the portion of the originally requested amount that isn’t covered by the partial authorization. You can create a separate PaymentIntent for another form of payment, cancel the entire PaymentIntent, or capture only up to the partially authorized amount. Make sure to clearly communicate with your customer about how you’re proceeding with the transaction and any potential impact on them.

Compliance

You’re responsible for your compliance with all applicable laws, regulations, and network rules when using partial authorization. Consult the rules for the card networks that you want to use this feature with to make sure your sales comply with all applicable rules, which vary by network. For example, as of May 2024, American Express restricts usage of the feature to only debit and prepaid and doesn’t permit its use with recurring or cross-border transactions, while Visa requires you to use the feature across card types. The information provided on this page relating to your compliance with these requirements is for your general guidance, and isn’t legal, tax, accounting, or other professional advice. Consult with a professional if you’re unsure about your obligations.

Availability

IC+ feature

You can access partial authorizations on IC+ pricing. Contact your sales representative or support to enable this feature.

Partial authorizations have the following restrictions:

  • You can only use partial authorizations for online card payments.
  • Only Visa, Mastercard, Discover, and Amex support partial authorizations.
  • The issuer and card type determine whether they’re supported.
  • Due to network restrictions, you can’t capture more than the authorized amount using overcapture if a transaction amount has been partially authorized.
  • If you process charges on behalf of your Connect account using a transfer_amount, Stripe limits it to the partially authorized amount when the transfer_amount is greater than the partially authorized amount.
  • Stripe enforces a minimum charge amount on partially authorized charges, declining any PaymentIntent that falls short.

Use manual capture to create and confirm PaymentIntents

To enable partial authorization for specific PaymentIntents, set if_available to the request_partial_authorization parameter.

Command Line
cURL
curl https://api.stripe.com/v1/payment_intents \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d amount=10000 \ -d currency=usd \ -d payment_method=pm_card_debit_partialAuthorization \ -d "payment_method_types[]"=card \ -d "payment_method_options[card][request_partial_authorization]"=if_available \ -d capture_method=manual \ -d confirm=true \ -d "expand[]"=latest_charge

Verify partial authorization status

Review the payment_method_details field on the latest_charge in the PaymentIntent confirmation response to determine whether the networks applied partial authorization for the payment:

  • partial_authorization.status: Displays one of the following authorization statuses: partially_authorized, fully_authorized, declined, or not_requested.
  • amount_requested: Confirms your originally specified request amount.
  • amount_authorized: Determines the authorized amount.

The example response below shows that the transaction is partially authorized for 70 USD, which is less than the originally requested 100 USD.

Example PaymentIntent confirmation response
{ "id": "pi_foo", "amount": 7000, "amount_capturable": 7000, "amount_received": 0, "capture_method": "manual", ... // if latest_charge is expanded "latest_charge": { "id": "ch_foo", "object": "charge", "amount": 7000, "captured": false, "payment_method_details": { "card": { "amount_authorized": 7000, "amount_requested": 10000, "partial_authorization": { "status": "partially_authorized", } } } }, ... "status": "requires_capture" }

If the card issuer declines the authorization, this response returns a card_declined error.

Capture the partially authorized PaymentIntent

You can capture an authorized PaymentIntent up to the amount (or amount_capturable) that’s returned in the confirmation response.

Command Line
cURL
curl -X POST https://api.stripe.com/v1/payment_intents/pi_foo/capture \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

A successful capture returns the PaymentIntent object with updated fields:

Successful capture response
{ "id": "pi_foo", "amount": 7000, "amount_capturable": 0, "amount_received": 7000, "capture_method": "manual", "latest_charge": "ch_foo", ... "status": "succeeded", }

OptionalUse auto-capture to confirm and capture a PaymentIntent

OptionalIncrement with partial authorization

Test your integration

To trigger a partial authorization while testing, use the partial authorization Stripe test card with any CVC, postal code, and future expiration date. Make sure to set request_partial_authorization to if_available to trigger partial authorization with the test card.

Test card numberPayment methodDescription
pm_card_debit_partialAuthorizationThis card authorizes 70% of the amount specified in the confirmation request rounded down to the nearest unit (for example, cents) with partial authorization requested. Otherwise, it declines it with an insufficient funds error code.
pm_card_debit_partialIncrementThis card fully authorizes the initial authorization. For subsequent increments, this card authorizes 70% of the amount specified in the increment request rounded down to the nearest unit (for example, cents) with partial authorization requested. Otherwise, it returns insufficient funds.
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