All authorizations expire, though the timeframes differ by payment method. This is a common challenge for businesses that wait to collect funds until they are ready to ship their products, provide their services, or need to adjust a transaction's amount post-authorization. Below are some options and limitations to be aware of when managing your authorization workflow.
Merchants in some industries may want an authorization to stay active on a customer's account for longer than the timeframe established by the customer’s bank. There are two ways to do this in the Braintree gateway:
Eligible merchants that need to adjust the amount of a transaction after it has already been authorized (e.g. adding a tip post-authorization) can use the authorization adjustment option.
To use the verify and store method, follow these steps:
- If the customer's payment method is a credit or debit card, use card verification to ensure that the card is valid; otherwise, continue on to the next step
- Store the payment method in the Vault
- Store the customer ID and/or payment method token in your business’s database
- When you’re ready to collect funds, create a transaction using the vaulted payment method
- Little development work needed
- May save you money in processing fees, compared to the multiple authorizations method
- No guarantee that the customer will have sufficient funds at the time the transaction is created
- No guarantee that the customer’s account will be active at the time of the transaction
If you decide that the multiple authorizations method is the best fit for your business, you will need to create logic on your end that identifies the payment method type from the details returned in a results object and then implement rules based on the payment method type’s expiration timeframe. Here’s a suggestion of what this logic could look like:
- Create a transaction to authorize the amount you plan to charge; do not submit for settlement yet
- Void the transaction within the appropriate expiration timeframe
- Create a new transaction to authorize the amount again; do not submit for settlement yet
- Repeat steps 2 and 3 if you need to continue to extend the authorization
- When you’re ready to collect funds, submit the latest transaction for settlement
- Can guarantee that the customer has sufficient funds
- Considerable development work needed
- May cost more in processing fees
- The voids may result in duplicate pending transactions on a customer’s account, causing confusion and preventing the customer from using those funds
For some business models, there is a need to submit a transaction for settlement for either more or less than the amount it was originally authorized for (e.g. tip adjustments). This action is commonly referred to as an authorization (or auth) adjustment.
If you submit for less than the original authorized amount, we attempt a partial reversal, in order to reverse the difference back to the cardholder. If you submit for more than the original authorized amount, we attempt an incremental authorization to increase the authorized amount. In either case, if the cardholder’s issuing bank declines the adjustment, we return a validation error. When an adjustment is declined in this way, the original transaction will remain in an Authorized status.
If you qualify for and utilize auth adjustments, you will need to update your logic to listen for validation errors when submitting for higher or lower than the original authorized amount.
Authorization adjustments can only be made on Visa and Mastercard transactions, and are available for select processors in the following regions:
- US - Visa and Mastercard
- APAC - Mastercard
- EU - Mastercard
All merchant categories are eligible to utilize Mastercard’s adjustment functionality; however, Visa limits adjustment usage to the following merchant categories:
- Vehicle rentals
- Cruise lines
- Restaurants and bars
- Amusement parks
- Taxicabs and rideshares
- General rental categories
- Real time decline responses for tip adjustments and partial captures
- Auth adjustment details allow merchants to track adjustment success rates
Still have questions?
If you can’t find an answer, contact our Support team