Recurring Payment Resources
Reference Material for Money That Repeats.
The vocabulary, the design decisions and the failure modes that exist only because a payment happens more than once — written for the people who have to settle them before anything gets configured. Everything is on this page. There is nothing to download and nothing to request.
Reference on this page — no download, no form
Four layers a recurring payment touches
Agreement layer
What the customer agreed to
The arrangement, its term, the authority to take payment on a schedule.
Rating layer
Billing and subscription systems
What to charge, for which entitlement, at which price, for which period.
Payment management layer
Bonza Payments
What was expected, collected, outstanding, due, overdue, refunded, credited, expected next and worth a person’s attention.
Processing layer
The configured payment gateway
Authorisation, capture, declines and the stored instrument itself.
Most recurring-payment disagreements inside a business turn out to be two people standing in different layers using the same word.
What this is
Reference You Can Use Today, Whether or Not You Ever Talk to Us.
Including a plain account of what this page is not.
What this page is
- A precise definition of eighteen recurring-payment terms, and which of four layers actually owns each one
- Eight design decisions that are specific to repeating money, each with two defensible answers and the cost of both
- Nine failure modes grouped by when they become visible, because that decides whether anything can still be done
- A set of questions a working recurring payment setup should be able to answer
- An honest statement of where Bonza Payments sits in all of it, and where it does not
What this page is not
- Not a guide library. No resource has been published, and this page offers no download, title, author, date, page count or file size
- Not a product tour. The capability pages carry that, and they are linked where they are relevant rather than restated here
- Not subscription-billing advice. Rating, proration and dunning belong to billing systems, and Bonza is not one
- Not a scorecard. Nothing here grades your setup or asks you to answer anything
- Not vendor-specific. The decisions below apply whichever system you end up using
A payment that happens once is an event. A payment that repeats is a relationship, and almost every recurring-payment problem comes from managing the second with tools designed for the first.
Vocabulary
Eighteen Terms, and the Layer That Actually Owns Each One.
Filter by layer. The words are not interchangeable, and treating them as if they were is where most of the expensive confusion starts.
Two of those four layers are explicitly not Bonza. Bonza Payments is a Salesforce-native payment management suite: it records what was expected and what was collected and keeps the resulting position visible. It does not rate charges, it does not process transactions, and it holds no money.
See what the payment management layer coversWhat changes
Nine Assumptions That Are Safe Once and Unsafe Forever After.
None of these is wrong for a one-time payment. Each one quietly stops being true the moment the same payment is expected again.
The assumption
True for a one-time payment
What recurrence does to it
“It either succeeded or it didn’t.”
One attempt, one outcome, and the outcome is the whole story.
An arrangement can be healthy with a failed attempt behind it, and in trouble with every attempt succeeding. Attempt and position stop being the same question.
“The payment method is valid.”
Valid at the moment of payment is the only moment that matters.
Valid today says nothing about the cycle after next. Expiry becomes a scheduled event sitting in the future, and it is knowable in advance.
“We know the amount.”
The amount is a fact of the transaction.
The amount is a fact of this cycle only. Change it and you have to decide what the previous cycles now claim they were for.
“Overdue means follow up.”
Past its date and unpaid, so someone should look.
A missed cycle inside a long healthy arrangement and a missed final instalment are both overdue and mean entirely different things.
“The record shows what is owed.”
What is owed is what has been billed and not paid.
Part of what is owed has not happened yet. A view that only looks backwards is describing less than half the relationship.
“A refund reverses the payment.”
Money out cancels money in, and the matter is closed.
The arrangement is still running. A refund changes the position of something that continues, so it has to stay attached to the arrangement and not just to the payment.
“Payment closes the obligation.”
Paid means finished.
An instalment closes a cycle, not the obligation. Systems that conflate the two report an arrangement as settled every month.
“One record per payment is enough.”
The record holds everything anyone needs.
The relationship between the records carries the meaning. Twelve rows that do not know they belong together answer almost nothing.
“Setting it up is the hard part.”
Configure it, take the payment, move on.
Setup happens once and the cycle happens forever. Effort spent on the first is cheap; effort the cycle demands is paid again every period.
This is an illustrative comparison of how payment assumptions behave, not a description of any particular business. The point is the direction of the change, not a measurement of it.
Decisions
Eight Decisions That Only Exist Because the Payment Repeats.
Each has two answers a competent team could defend. The page gives the cost of both and what to weigh, and stops there, because the right answer depends on facts about your business that a web page does not have.
The eight, in order
1 of 8
Three of these — whether history keeps what was expected, what “ended” means, and whether a partial payment advances the cycle — are the ones that are cheap to decide now and expensive to revisit, because reversing them needs information that the original choice threw away.
See the equivalent decisions for a Salesforce payment designFailure modes
Nine Things That Go Wrong, Sorted by When You Can Still Catch Them.
Grouping by cause is interesting. Grouping by when the problem becomes visible is useful, because that is what decides whether anyone can act.
The ones found after the payment date are rarely found by a system. They are found by a customer asking a question nobody can answer.
How to tell
Ten Questions a Working Recurring Payment Setup Can Answer Quickly.
Not a maturity score and not a form. If any of these takes a spreadsheet and an afternoon, that is the gap, and it tells you which decision above was made by accident.
- For this customer, what has been collected across the whole arrangement, not just last month?
- Which arrangements have a payment method that will expire before their next payment date?
- Which cycles were paid in part, and how much is still outstanding on each?
- Which arrangements ended with an unpaid balance still attached to them?
- What is expected from recurring arrangements over the next period, separately from what is already overdue?
- When the amount changed in March, what did the January cycles say they were for?
- Which failed attempts failed for a reason that will fail again?
- Where a refund was issued mid-arrangement, does the arrangement’s total reflect it?
- Can a service agent see the whole payment relationship from the customer record, without opening another system?
- Can the customer see the same thing you see, without emailing to ask?
These are questions to take into any evaluation, including an evaluation of Bonza Payments. They are written to be answerable about a system you already have.
Where Bonza fits
One of the Four Layers, Stated Plainly.
The reference above is deliberately vendor-neutral. This section is not, and it is marked so you can weigh it differently.
What Bonza Payments does here
- Keeps a recurring arrangement as a relationship with history behind it and the next expected payment ahead of it, attached to the Salesforce customer record
- Records what was expected against what was collected, so partial payment is visible rather than inferred
- Separates outstanding, due and overdue as distinct states of an amount
- Surfaces a payment method expiring before the payment that depends on it
- Keeps refunds and recorded customer credit attached to the arrangement they came from
- Flags what is worth a person’s attention, and leaves the action to the person
What Bonza Payments does not do here
- No rating, pricing, proration or entitlement management — that is subscription billing, and Bonza is not a subscription billing platform
- No transaction processing — a configured payment gateway performs that
- No dunning, chasing, fee application or automatic retries
- No storage of funds. Bonza is not a bank and not a wallet, and recorded customer credit is not stored cash
- No accounting or general ledger. Bonza is not an accounting platform or an ERP
- No decision made on your behalf. Attention is surfaced; judgement stays with the team
Stated as one position: Bonza Payments manages the payment-management layer of a recurring arrangement inside Salesforce, and makes no claim on the agreement, rating or processing layers.
About downloads
What This Page Would Show You If There Were Anything to Download.
A resources page usually opens with a shelf of files. This one does not, because the shelf is empty, and saying so is better than implying otherwise.
If downloadable recurring payment resources are published later, this section will list them with their actual titles and dates. Until then it states the count, which is currently zero.
Answered
Recurring Payment Questions, Answered Here.
Questions about the reference itself, and about the distinctions it rests on.
What is the difference between a recurring payment and a subscription?
A subscription is a commercial arrangement: a customer has access to something for a period, and a billing system decides what to charge for it. A recurring payment is the money obligation that results: an amount expected on a date, which may or may not be collected. One business can have subscriptions without recurring payments, if the customer pays a year up front, and recurring payments without subscriptions, such as an instalment plan on an existing balance. Bonza Payments manages the recurring payment, not the subscription.
Is a payment plan the same as a recurring payment arrangement?
They share a shape and differ in a way that matters. A payment plan splits an amount that is already owed into instalments, so it has a known total and a known end from the first day. An ongoing arrangement has neither. The practical consequence is that “how much is left?” is a real question for a plan and a meaningless one for an open-ended arrangement, which is why decision six on this page asks whether they should be modelled the same way.
Why does partial payment keep appearing in this reference?
Because it is the state that most payment setups cannot describe. A gateway reports that a transaction succeeded, which is true, and the customer is still not settled, which is also true. If the system records only the transaction result, those two facts cannot both be held, and the shortfall stops being visible. Recurrence makes this worse rather than better, because the next cycle arrives before anyone has noticed.
Does Bonza Payments handle retries and dunning?
No. Retrying a declined payment is performed at the processing layer by the configured gateway, and dunning — the escalating sequence of reminders and actions against unpaid charges — belongs to billing systems. Bonza surfaces what is overdue and what needs a person’s attention. It does not chase customers, apply fees, record promises to pay, or take action on its own.
Where should the payment schedule live?
That is decision one, and it has two defensible answers. Holding it on the agreement gives you one place to change a date or an amount. Holding the expectation on each payment record means every cycle remembers what was expected of it, so history survives a change. The question to ask is what you want to be true a year after someone edits the amount: if past cycles must still show what they were originally for, the expectation has to live with the payment.
How do recurring payments relate to payment method expiry?
Expiry is the only recurring failure that is fully knowable in advance. The expiry date is known and the next payment date is known, so the collision between them can be seen before it happens. It usually is not seen, because the two facts live in different systems. Putting them in the same view is what turns expiry from an after-the-fact decline into something a person can act on early.
What happens to a refund issued in the middle of a running arrangement?
The arrangement continues, so the refund changes the position of something still in motion rather than closing a matter. For the arrangement’s totals to stay true, the refund has to remain attached to the payment and the arrangement it came from. Where value is retained rather than returned, it can be recorded as customer credit for supported future payment use — which is a record, not stored cash.
Is this reference specific to Salesforce?
The vocabulary, decisions and failure modes apply wherever recurring payments are managed. The context is Salesforce, because that is where Bonza Payments operates, and because keeping the payment relationship on the customer record is what makes several of these questions answerable at all. The Salesforce-specific design decisions — where payment records belong, which states are distinct — are on the Salesforce Payment Guides page instead.
Can one customer have both one-time and recurring payments?
Yes, and it is common. The reason it matters is that the two obey different rules: a one-time payment is finished when it is paid, and a recurring one is not. A view that treats every payment the same way will report an arrangement as settled every time an instalment lands. Keeping both kinds against the same customer record, with their differences intact, is the point of managing payments rather than transactions.
Is there a downloadable version of this reference?
No. No recurring payment guide, template, spreadsheet or PDF has been published, so there is no title, author, date, page count or file to offer, and this page does not imply otherwise. The reference is delivered in full on the page, which means it can be read, linked to and quoted without requesting anything or providing an email address.
Do I need to settle these decisions before choosing a system?
You need to know which answers a system forces on you. Most of the eight decisions are made implicitly by whatever tool is adopted, and the first time anyone notices is the first time someone asks what a past cycle was for. Reading the eight and deciding which ones you have a strong view about is a useful hour before any evaluation, including an evaluation of Bonza.
What should I bring to a conversation about recurring payments?
The answers you already have, and the ones you do not. Which of the ten questions above your current setup answers quickly, which take an afternoon, and which of the eight decisions were made deliberately rather than by default. That makes a conversation about your actual arrangement rather than a demonstration of features.
Where to take this
Bring Your Arrangement, Not a Feature List.
If the ten questions above produced a few uncomfortable answers, those are the useful ones. A conversation that starts from how your recurring arrangements actually behave is more productive than one that starts from a demo.
Useful things to have to hand
- Whether your arrangements are open-ended, finite plans, or both
- What happens today when a cycle is paid in part
- How you currently find a payment method expiring before its next payment
- What an ended arrangement does to a balance still attached to it
- Which of the eight decisions you already have a strong view about