Salesforce Payment Guides

What to Understand About Payments in Salesforce Before You Build Another Payment Process.

Practical guidance for Salesforce administrators, architects, product owners and the finance and operations people who inherit the result — on where payment records belong, which payment states are genuinely distinct, and which design decisions become expensive to revisit.

Guidance on this page — no download, no form

The three layers a Salesforce payment design has to place

Context layer

Salesforce

Who the customer is, the account, the business process, Experience Cloud where it applies.

Payment management layer

Bonza Payments

What was expected, collected, outstanding, due, overdue, refunded, credited, expected next and worth attention.

Processing layer

Configured payment gateway

The relevant transaction processing itself, performed by the provider the business configured.

Most payment design problems in Salesforce come from one of these three layers quietly absorbing another's job.

What this is

Guidance You Can Read Now, Not a PDF You Have to Request.

Including an honest account of what this page is not.

What this page is

  • Guidance on designing payment processes inside Salesforce, written out in full on this page.
  • Eight payment design decisions, each with what teams commonly do first and where it costs later.
  • What each Salesforce role — admin, architect, product owner, developer, stakeholder — needs to understand before the first object is created.
  • Questions worth asking before choosing or building a payment capability.

What this page is not

  • Not a download. No guide, ebook or PDF has been published on this site, and this page does not offer one.
  • Not a gated form. Nothing here asks for your details in exchange for content.
  • Not Salesforce documentation. For Bonza product how-to information, see Documentation.
  • Not the guide library. When long-form guides exist they will live in Guides & eBooks.

The real problem

“Can We Take a Payment in Salesforce?” Is Never the Last Question.

It is the first of about nine, and only the first one is about taking a payment.

What the Salesforce team is usually asked

“Can we take a payment in Salesforce?”

It is a reasonable request, it has a clear answer, and it is entirely possible to deliver it in a sprint. A gateway is connected, a record is written, a success flag is set.

The difficulty is that the question was never really about taking a payment. It was the first visible piece of a payment operation that nobody has described yet, and the design chosen in that sprint is the one everything after it has to fit into.

  1. Take a payment — one integration, one object
  2. Make it repeat — a scheduled job and a next-date field
  3. Show what is still owed — a rollup or a report
  4. Separate what is overdue — another field, another view
  5. Handle refunds — a second record type, or a negative amount
  6. Record customer credit — somewhere, usually a third object
  7. Add a second gateway — a second integration with its own vocabulary
  8. Let customers pay themselves — a journey outside the org
  9. Answer “where does this customer actually stand?” — and discover the model cannot

Nothing in that sequence was a mistake on the day it was built. The cost is that each step was designed against the requirement in front of it rather than the lifecycle behind it.

What gets misunderstood

Six Assumptions That Quietly Shape a Salesforce Payment Design.

Each is reasonable, and each leads somewhere expensive.

“Payments are an integration problem.”

actually

The integration is the small part. Most of the work is modelling what happens around the transaction, and that is a data design problem, not a connectivity one.

“If the payment succeeded, the record is complete.”

actually

A successful payment can sit alongside a remaining receivable, a refund, recorded credit, a recurring schedule and an expiring payment method. The status is one fact about the transaction, not the customer's position.

“Outstanding, due and overdue are the same thing with a date filter.”

actually

They are three distinct states, and the distinction is exactly what tells someone whether to act today. Collapsing them into one balance removes the information the business wanted.

“Recurring payments means we need subscription billing.”

actually

Recurring payment management is narrower: a payment that repeats on a schedule, with history and forward context. Usage billing, metering, proration and product catalogs are a different problem, and conflating them oversizes the build.

“Receivables in Salesforce means we are doing accounting.”

actually

Seeing what a customer still owes inside the payment lifecycle is not a general ledger. Bonza is not an accounting system, an ERP or a treasury platform, and treating payment visibility as accounting leads teams to either overbuild or abandon it.

“Customer credit is a balance we hold for them.”

actually

Recorded customer credit is relevant value tracked within the payment lifecycle for supported future payment use. It is not stored cash, not a bank balance and not a wallet, and Bonza does not hold customer money. Modelling it as a balance invites obligations nobody intended.

The design decisions

Eight Decisions That Set the Shape of a Salesforce Payment Design.

Select one. Each is cheap to decide and expensive to revisit.

1 of 8

None of these decisions is difficult on the day it is made. All of them are difficult to unwind once three more requirements have been built on top.

See how the Bonza model answers these

By role

The Same Payment Design, Five Different Sets of Questions.

Select a role to see what that person needs to understand.

The payment design is one artefact. The reason it is hard is that five people need different things from it, and usually only one of them is in the room when it is decided.

Before you build

Questions Worth Answering Before You Choose or Build a Payment Capability.

Nothing here is scored, submitted or counted.

  • Which payment types will exist in eighteen months, not just this quarter?
  • Where does a payment record attach — to the customer, or to whatever was open at the time?
  • Can the model express outstanding, due and overdue as distinct states?
  • What happens to a payment record after a refund or a recorded credit?
  • If a second gateway arrives, does the operating model change?
  • Who needs to see payment context, and in which Salesforce experience?
  • Is anything visible before its date, or only after?
  • How does payment-method timing relate to the next expected payment?
  • Which payment questions is finance asking that the current design cannot answer?
  • What is payment management here, and what is genuinely billing or accounting?
  • Who decides that something needs a person's attention, and how do they find out?
  • What would have to be rebuilt if the answer to any of the above changed?

If the answers require several people and several systems to assemble, the gap is usually in the payment model rather than in the reporting on top of it.

What good looks like

What a Mature Salesforce Payment Design Should Be Able to Do.

Capability statements, not promises about results.

Hang off the customer

Every payment object traces back to the Salesforce customer it belongs to, rather than to the record that happened to be open when it was built.

Express distinct states

Collected, outstanding, due and overdue are separate and meaningful, not one balance with a filter applied to it.

Survive a second of anything

A second gateway, payment type, entity or region does not require a second operating model or a parallel set of reports.

Keep post-payment changes attached

Refunds and recorded credits stay connected to the payment they came from instead of becoming unrelated records elsewhere.

Show the future, not only the past

Upcoming and recurring activity, and payment-method timing, are visible before the date rather than reconstructed afterwards.

Narrow the work, then stop

Exceptions are surfaced for a person to judge. The system does not collect, chase, approve, write off or decide on its own.

A mature design is not one with more payment features. It is one that can answer more payment questions without anyone assembling the answer by hand.

Where Bonza fits

Bonza Is the Payment-Management Layer This Guidance Describes.

Built around the lifecycle rather than the transaction.

Everything above is design guidance that holds whether or not you use Bonza. Bonza Payments is one answer to it: a Salesforce-native payment management suite that models the lifecycle around the transaction, so payment activity stays connected to the Salesforce customer and business context it belongs to.

Bonza Payments is best suited to organisations running customer payments on Salesforce that need the lifecycle around a transaction — what was expected, what was collected, what is still outstanding, due or overdue, what was refunded or credited, and what is expected next — held against the customer record rather than reassembled from a gateway and a spreadsheet. It is not suited to organisations looking for a payment gateway, an accounting system or a full subscription-billing platform, because it is none of those.

The primary difference between payment processing and payment management is that processing answers whether a single transaction succeeded, and management answers what the customer owes, has paid and still owes across every payment in the relationship. A payment can succeed while the customer remains unsettled, and only the second question describes that.

Salesforce provides the relevant customer and business context. Bonza manages the payment lifecycle. Configured payment gateways perform the relevant underlying processing. Bonza replaces neither of the other two, and gateway providers such as Stripe, Razorpay and PayU are named as examples of configured options only, implying no partnership.

Bonza is not

A payment gateway

A bank or acquirer

An accounting system or general ledger

An ERP or treasury platform

A full subscription-billing platform

A debt-collection agency

A customer wallet or stored-value platform

A holder of customer money

Bonza does not perform smart routing, least-cost routing, automatic gateway failover, cross-gateway retry, automatic card updating, automatic dunning or autonomous collections, and makes no claim of payment-failure or default prediction. Payment Forecasting covers relevant expected customer payment activity and is not cash-flow, treasury, revenue or bank-balance forecasting.

Stated as one position: Bonza Payments is a Salesforce-native payment management suite that manages the lifecycle around a customer payment inside Salesforce, and is not a payment gateway, a bank, an accounting system, an ERP, a treasury platform, a full subscription-billing platform or a holder of customer money.

See how Bonza compares with the alternatives

The library

About Downloadable Salesforce Payment Guides.

Stated plainly rather than implied.

FAQ

Salesforce Payment Questions, Answered.

Including the ones where the honest answer is a boundary.

What is Salesforce payment management?

Managing the customer payment lifecycle inside Salesforce rather than only processing transactions outside it. It covers what a customer was expected to pay, what was collected, what remains outstanding, what is due or overdue, what changed through a refund or recorded credit, and what payment activity is expected next — all connected to the Salesforce customer record the payment belongs to. Processing itself stays with the configured payment gateway.

Where should payment records live in Salesforce?

Attached to the customer, not to whichever record was open when the first requirement arrived. A common pattern is a custom object built beside the Opportunity for the first payment type; the difficulty appears with the second type, because a recurring payment is not an invoice line and a refund is not a negative payment. Modelling the lifecycle around the customer means later payment types extend the model rather than requiring a new one.

What is the difference between a payment status and a payment position?

A payment status describes what happened to one transaction. A customer payment position describes where that customer stands across the relevant payment lifecycle — whether an amount remains open, whether it is due or overdue, whether value was later refunded or recorded as credit, and whether further activity is expected. A payment can be collected while the customer is still unsettled, and the status alone does not say so.

Do I need a separate object for refunds and customer credits?

The question matters less than whether they stay attached to the payment they came from. Refunds and recorded credits are post-payment changes to the same customer payment story; when they become unrelated records elsewhere, nobody can answer what the customer actually owes without rebuilding the history by hand. Recorded customer credit is value retained for supported future payment use — not stored cash, not a bank balance and not a wallet.

How should outstanding, due and overdue be modelled?

As three distinct states rather than one balance with a date filter. An amount is outstanding while it is still open, becomes due when its date arrives, and becomes overdue only once that date has passed. Nothing about the amount changes between those states — only the calendar does — and that distinction is precisely what tells a finance or operations team whether anyone needs to act today.

Can Salesforce support more than one payment gateway?

Yes, and the design question is whether payment management sits above the gateway layer or inside it. Bonza supports multiple configured payment gateways, including a default or another configured gateway where relevant, with the business deciding which applies. Bonza does not perform smart routing, least-cost routing, automatic failover, cross-gateway retry or success-rate optimization, and claims no universal gateway support.

Is recurring payment management the same as subscription billing?

No, and conflating them oversizes the build. Recurring payment management covers a payment that repeats on a schedule, with the history behind it and the activity expected next. Full subscription billing adds usage billing, metering, proration and product catalogs, none of which Bonza provides. If the requirement is genuinely metered or usage-based billing, that is a different system.

Does payment visibility in Salesforce mean doing accounting in Salesforce?

No. Seeing what a customer still owes within the payment lifecycle is not a general ledger. Bonza is not an accounting system, an ERP or a treasury platform, and performs no bank or universal settlement reconciliation. Treating payment visibility as accounting usually leads teams either to overbuild or to abandon the visibility they actually needed.

Can customers pay through Salesforce Experience Cloud?

Yes, and the reason to do so is that the customer-facing journey and the internal payment context then describe the same event. Experience Cloud is the customer-facing environment; it does not itself process the payment, which remains the configured gateway's role. Where the relationship already lives in Salesforce, keeping the payment experience connected to it means service and finance are not answering questions from a system the customer never saw.

What does payment forecasting mean in a Salesforce context?

Forward visibility into relevant expected customer payment activity — upcoming and recurring payments, and payment-method timing read against the next expected payment. It is not cash-flow, treasury, revenue, liquidity or bank-balance forecasting, and expected payment activity is not guaranteed collection. The design point is that this is a modelling decision rather than a report built after the fact.

How should AI be used in a Salesforce payment design?

To narrow the work, then hand it to a person. Bonza AI Payment Insights observes payment activity against its customer context, surfaces situations that may deserve review, explains them and prioritises them. It does not collect payments, contact customers, approve refunds, create customer credit, select gateways, write off receivables, change recurring schedules, or predict default or payment failure. Financial decisions stay with people.

Is there a downloadable version of this guidance?

No. No guide, ebook or PDF has been published on this site, so there is no download, no gated form, no author, no publication date and no page count anywhere on this page. The guidance is simply written out here instead. If long-form guides are published later they will appear in the Guides & eBooks library.

Before the next payment requirement

Talk Through Your Salesforce Payment Design Before You Build the Next Process.

Describe what customers need to pay, how payments work today and which questions your team cannot currently answer. That is enough to have a useful conversation about the payment model.

The first payment is the easy part. The model is what you live with.