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.