Failed payment recovery for Braintree
By Jay Stevens · Principal EngineerReviewed by Jordan MederichUpdated 3 min readSummarize with AI
Quick answer
Braintree (a PayPal service) supports recurring billing with a configurable Number of Days retry schedule and a hosted card-update page, but its native failed-payment communication is email-only and stops after the retry window closes. Revatto re-attempts the failed charge programmatically through Braintree's API on AI-timed schedules, then layers email + SMS + human outreach on top — fully done for you. You pay 20% of the first recovered payment, $0 setup, $0 monthly, cancel anytime.
The gap Braintree leaves open
What Braintree recovers on its own
- Braintree's recurring billing retries a failed subscription charge on a configurable schedule set by the Number of Days fields on the plan and merchant retry settings.
- A hosted update-payment-method flow lets a customer replace the card on the stored vaulted payment method.
- Braintree's Account Updater can refresh expired or reissued card details on file when the network supports it.
- Failed-payment notifications are delivered by email; there is no native SMS or phone follow-up.
stops at
adds- Braintree stops at: Braintree's recovery comms are email-only — a failed-payment notice, but no SMS and no phone outreach.Revatto adds: Email + SMS + a human recovery specialist, all sending under your brand.
- Braintree stops at: Braintree's retry schedule is a fixed Number of Days cadence — it can't time each attempt to the specific decline.Revatto adds: AI-timed retries through Braintree's API, plus cross-client learning from millions of recovered payments.
- Braintree stops at: After the retry window closes, Braintree makes no further attempts — the subscription just cancels or past-dues, with no win-back.Revatto adds: Recovery continues past Braintree's last attempt, with human follow-up that actually reconnects the card.
- Braintree stops at: Braintree returns a numeric processor response code (the 2000-series) but does nothing with it beyond the retry.Revatto adds: Revatto reads the response code to tell a soft retry-now from a hard needs-the-customer, and acts on each accordingly.
How Revatto recovers failed Braintree payments
- 1Detect the failure instantlyRevatto ingests Braintree's subscription / transaction webhook the moment a recurring charge fails — no polling, no delay.
- 2Diagnose the declineRevatto reads Braintree's processor response code (the 2000-series) to tell a soft retry-now from a hard needs-the-customer.
- 3Re-attempt intelligentlyWhere a retry can clear it, Revatto triggers an AI-timed re-charge through Braintree's API against the vaulted payment method, rather than waiting on the fixed Number of Days schedule.
- 4Reach the customerWhere a retry won't clear it, email + SMS + a human recovery specialist reach the cardholder under your brand to update the card on file.
- 5Stop on successWhen Braintree reports the charge succeeded, Revatto ends the sequence automatically — no double-charge, no stray outreach.
How a Braintree decline maps across stacks
A do-not-honor decline on Braintree — its 2000 processor response code. Recovery looks the same across every stack Revatto runs on — here is how the same issuer decision is named on each.
ProcessorCodeWhat it’s called
ISO 8583
Code05
CalledDo Not Honor
Codedo_not_honor
CalledDo not honor
Code2000
CalledDo Not Honorgeneric issuer decline
Code5
CalledDo not honorresponseReasonCode 5
Code201
CalledDo not honor
Codedo_not_honor
CalledDo not honor
Codecall_issuer
CalledCall issuer
Code05
CalledDo not honorISO 8583 adapterCode 05 (refer to issuer)
CodeDO_NOT_HONOR
CalledDo not honor
Codedo_not_honor
CalledDo not honornormalized — no processor-specific code (free-text categorized)
Codedo_not_honor
CalledDo not honornormalized — matched by substring rule, no processor-specific code
See what Revatto would recover from Braintree
Failed payments recovered automatically — no engineering, no manual chasing. We do the work; you keep the revenue.
Frequently asked questions
Yes. Braintree exposes a full transaction and vaulted-payment-method API, so Revatto can trigger a re-charge against the stored card on a recovery-optimized schedule, not just send a reminder email.
No — it works on top of them. Braintree's recurring billing handles the fixed-schedule re-attempts; Revatto adds the channels Braintree doesn't (SMS and human outreach), times the re-charge to the specific decline, and continues recovery past Braintree's final attempt.
No. Braintree's failed-payment notifications are email-only. SMS and phone follow-up — done by a real recovery specialist under your brand — are exactly what Revatto adds.
Braintree makes no further attempts and cancels or past-dues the subscription. Revatto keeps recovering past that point with human follow-up to reconnect the card.