Skip to main content

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.

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. 
{
    "amount": 1299,
    "country": "US",
    "currency": "USD",
    "intent": "capture",
    "allow_partial_authorization": true
    ...
}
When a partial authorization has been made, the authorized_amount reflects the actual authorized value of the transaction. 
{
    "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,
    ...
}
Always check the authorized_amount to confirm the actual authorized amount for a transaction.

​
Availability

Currently, partial authorization is supported on the following connectors.
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.