> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gr4vy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Partial authorization

The system supports partial authorization for card payments. Partial authorization is a
processing feature that allows a transaction to be approved for a portion of the total
purchase amount when a buyer's available funds are insufficient. Instead of a complete decline,
the card issuer approves the transaction for the amount the customer does have available,
allowing the customer to potentially complete the purchase by using another payment method
for the remaining balance. This improves the customer experience by reducing declined
transactions and increasing the likelihood of a completed sale.

## Usage

To enable partial authorization, you can pass the \[]`allow_partial_authorization`]\(/reference/transactions/new-transaction#body-allow-partial-authorization) to the API. This informs the supported
payment services to allow for a partial authorization.

<CodeGroup>
  ```json Request {6} theme={"system"}
  {
      "amount": 1299,
      "country": "US",
      "currency": "USD",
      "intent": "capture",
      "allow_partial_authorization": true
      ...
  }
  ```
</CodeGroup>

When a partial authorization has been made, the `authorized_amount` reflects the actual authorized value of the transaction.

<CodeGroup>
  ```json Response theme={"system"}
  {
      "type": "transaction",
      "id": "8f83187d-a7fb-4e58-aece-b4bdfd622c7c",
      "reconciliation_id": "4MnoRekRSTPBpMclaqBdRk",
      "merchant_account_id": "default",
      "currency": "USD",
      "amount": 10000,
      "status": "authorization_succeeded",
      "authorized_amount": 5000,
      ...
  }
  ```
</CodeGroup>

<Warning>Always check the `authorized_amount` to confirm the actual authorized amount for a transaction.</Warning>

## Availability

Currently, partial authorization is supported on the following connectors.

* [Adyen](https://docs.adyen.com/online-payments/partial-authorizations/)
* [Checkout](https://www.checkout.com/docs/payments/manage-payments/authorize-a-payment#Request_a_partial_authorization)
* [Nuvei](https://docs.nuvei.com/documentation/features/financial-operations/partial-approval/)
* [Stripe](https://docs.stripe.com/issuing/purchases/authorizations?locale=en-GB#handling-other-authorizations)

<Note>
  Please note that support for partial authorization might need to be enabled on your account.
  When using the `partial_authorization` property, any connection without support for partial auth is ignored.
</Note>