Braintree: Processor Declined

What This Means

The customer's bank is unwilling to accept the transaction.

Note: This type of generic error can be returned in many cases where Braintree declines the payment. Check within your Braintree Control Panel (Control Panel > Transactions >> Transaction Search) for specific declined transactions. Learn more about Running A Decline Search on Braintree's support site.

Common Causes For This Error

Braintree suggests that the customer will need to contact their bank for more details regarding this generic decline.

The reasons for this response can vary, here are some examples:

  • Possible Lost Card
  • Possible Stolen Card
  • Fraud suspected

Suggested Next Steps

  1. Check the customer's information in your Braintree payment gateway to determine if the payment simply needs to be updated or retired. Note: if they want to update a current payment method they can do so by creating a new one.

  2. If a new payment method is needed, contact the customer to have them add a new payment method and add it to their Scheduled Order.

  3. You may also choose to add a new payment method for your customer, see "Adding a New Payment Method for Your Customer" below.

  4. Once a new payment method is added to the Scheduled Order, the Scheduled Order should be processed with the new payment method.

Adding A New Payment Method for Your Customer?

If you are adding a new payment method for your customer directly to your payment gateway (manually), ensure that you edit the failed Scheduled Order, add a new payment method, and copy the required billing information directly to their Scheduled Order including:

  • Gateway CustomerId
  • Gateway PaymentId
  • Billing Address
  • Payment Method Description (optional, but strongly suggested because it is used to display the payment method to your customer)

After Resolving The Issue

Once this issue is resolved, you should use the action to Restart Processing the Failed Scheduled Order.