Why did my Braintree refund fail with 2054?

The amount is higher than the original, or the bank does not allow partial refunds.

Can I refund in two parts after 2054?

Only if the issuer allows partial refunds.

Braintree · Decline codes

What does Braintree 2054 “Reversal amount does not match authorization amount” mean?

Checked October 31, 2026

Braintree 2054 “Reversal amount does not match authorization amount” means either the refund is larger than the original transaction, or the card-issuing bank does not allow partial refunds. It is a hard decline. Check the amount; Braintree says the customer may need to contact their bank or use a different method.

Type: Hard decline (refund)
Who declined: The shopper's bank or processor
Retry: Not with the same amount
Shopper action: Contact the bank or use another method
Merchant action: Check the refund amount

What PlatformDTC does

PlatformDTC does not connect to Braintree. On its Authorize.Net rail a refund is allowed only once the charge has settled, and an unsettled charge is voided instead, for the full amount only.

Why it happens

Refunding more than was charged, or a partial refund on a card whose bank only accepts full reversals.

What the store can do

Refund an amount no larger than the original. If partial refunds are refused, consider a full refund and a new charge.

For developers

Braintree returns processor_response_code 2054 with processor_response_text “Reversal amount does not match authorization amount” and processor_response_type “hard_declined” on the Transaction object.

Frequently asked questions

Why did my Braintree refund fail with 2054?: The amount is higher than the original, or the bank does not allow partial refunds.
Can I refund in two parts after 2054?: Only if the issuer allows partial refunds.

Sources

Declines: authorization decline codes — Braintree (PayPal)
Transaction response object — Braintree (PayPal)