Duplicate transactions can happen if a customer refreshes your checkout page or clicks your buy button multiple times, issuing a new API request with each click. Duplicate transaction checking prevents transaction requests from accidentally processing more than once.
Duplicate transaction checking logic is enabled in your gateway by default, but can be turned off or updated in the Control Panel.
Our duplicate checking logic runs within a specific time frame. If all of the general and relevant payment method-specific conditions are met within the designated timeframe, any suspected duplicate transactions will be Gateway Rejected.
The timeframe for duplicate checking logic is set to 30 seconds by default, but can be updated to meet your needs in the Control Panel.
In order for a transaction to be Gateway Rejected as a duplicate transaction, it must meet all of the following conditions within the designated timeframe:
- Amount is the same as the initial transaction
- Order ID is the same (if collected and if the transaction was not created by Braintree's recurring billing functionality)
- Subscription ID is the same (if the transaction was created by Braintree's recurring billing functionality)
- The initial transaction was successful (status can be Authorized, Submitted for Settlement, Settling, Settled, or Voided)
In addition to the general conditions listed above, there are conditions specific to supported payment methods. For the following payment methods, the listed condition must also be true in order for our duplicate transaction logic to reject the transaction:
- Google Pay or Apple Pay – DPAN is the same
- PayPal – payer email address is the same
- Credit card – number and expiration date are the same
Duplicate transaction checking is enabled by default with a 30 second window in both the sandbox and production environments. These settings can be updated or disabled by users with Account Admin permissions.
- Log into the Control Panel
- Click on the gear icon in the top right corner
- Click Processing from the drop-down menu
- Scroll to the Transactions section
- Next to Duplicate Transaction Checking, you can:
- Click the toggle to enable or disable this feature
- Click the Options link below the toggle to make changes to the timeframe