Investigate a Braintree settlement decline
Key facts
A Braintree settlement decline means the processor declined to settle the sale or refund request. Check the affected operation and settlement response before acting.
This guide is not legal advice and laws/rules may change; consult a qualified professional for personalized assistance. Use at your own risk.
Identify the declined operation
Open the transaction and identify whether the decline concerns a sale or a refund. Capture the original transaction ID, the affected record, merchant account, amount, currency and settlement response. Look up the settlement code in Braintree’s processor reference and compare the event with what the customer sees on their account.
Reconcile against the ledger
For a sale that failed to settle, check whether another successful transaction already covers the invoice. If your system applied the failed sale, route the receipt record to finance for correction. For a failed refund, check refund history and send the exception to the owner of the refund. The original sale and any other successful refund must still be accounted for.
See Braintree’s instructions and Braintree’s settlement response reference.
Decide who contacts the customer
If a $900 sale declines at settlement and no other successful payment covers the invoice, have the payment owner confirm the approved way to collect the remaining $900. If the record is still unclear, send the transaction references and settlement code to your payment operations team and pause automated payment reminders until they can reconcile it.
For help prioritizing the remaining balances, see Debitura’s accounts receivable guide.


.webp)