Grimoire 009 - Payment Processing - Career Culmination + Support Agent Knowledge Base
Merchant Services - Risk - Infrastructure - Field Manual
Grimoire 009 - Merchant Services - June 2026

Payment Processing: The Industry I Didn't Know I Was Learning

The culmination of a payment processing career: support calls, merchant statements, angry funding tickets, risk holds, terminal failures, onboarding mysteries, bank logic, processor language, and the slow realization that moving money is really the business of managing trust. This one starts as a story because that is how the industry teaches you.

15 parts
89 chapters
Support field manual
Technical survival guide
AI agent ready
Begin The Story →Support ManualFollow The Money
My understanding of payment processing once looked like this: customer pays, business gets money. Simple. Then a merchant called. His terminal said approved. His POS said approved. His batch was closed. His bank account showed nothing. And I had absolutely no idea where his money was.
Payment processing is not a product. It is an ecosystem. Most people only see the final two seconds of it.
CAREER
Author's Note: The Career Finally Makes Sense
This is not just an industry explainer

Some Grimoires are built from research. This one is built from repetition: the same merchant panic in different clothes, the same fee confusion on a new statement, the same terminal failure five minutes before closing, the same funding delay that sounds simple until you trace it through batches, banks, reserves, risk notes, and processor language.

At first, payment processing felt like support work. Answer the call. Calm the merchant. Find the ticket. Escalate the issue. Close the case. But over time, the calls formed a map. Every frustrated merchant was pointing at a different part of the same machine.

Early career
I thought the job was answering payment questions.
Middle career
I realized the questions were about systems: risk, funding, hardware, banks, gateways, integrations, and trust.
Now
The career becomes a field guide: what I wish someone had handed me before the first angry merchant asked where the money went.
POINT
This Grimoire should feel like the moment the scattered years become a single operating system. Not nostalgia. Not a textbook. A working map earned from the support floor.
Part I
I Thought I Was Learning Support
Before the industry map, there was a headset and a confused merchant
C1 - C3
C1
The Job Posting
Why payment processing looks simple from the outside

I did not enter payments because I was fascinated by interchange, acquirers, terminals, chargebacks, PCI, or risk underwriting. I entered through support. The posting sounded like normal customer service: answer questions, troubleshoot accounts, help merchants.

From the outside, payments looked like a utility. The customer pays. The business receives the money. Maybe a fee happens somewhere. That was the whole story in my head, and it was wrong in the way most beginner mental models are wrong: not stupid, just too small.

LESSON
Nearly everyone underestimates this industry because the best payment experiences hide the system. Tap. Approved. Receipt. Done. The complexity disappears until something breaks.
C2
The First Merchant Statement
The first time fees stopped looking like one line item

The first statement call is a rite of passage. A merchant asks, "Why am I paying all these fees?" and suddenly the statement looks less like a bill and more like an archaeological dig: interchange, assessments, batch fees, PCI fees, monthly fees, statement fees, gateway fees, authorization fees, non-qualified downgrades.

Merchants understand revenue because they earn it. Many do not understand the machinery that moves that revenue from a customer's card to their bank account. That gap is where support lives.

Interchange
The card-issuing bank's portion, usually the largest component of card cost.
Assessment
Network fees charged by card brands such as Visa and Mastercard.
Processor markup
The amount charged by the provider stack for routing, reporting, support, risk, and profit.
Misc fees
Monthly, PCI, batch, gateway, chargeback, statement, or service fees depending on account setup.
C3
The Day I Realized This Was An Industry
Not software. Not banking. Not sales. All of it.

The click happened slowly. Payment processing was not one company and one transaction. It was banks, processors, networks, sales organizations, underwriting teams, compliance rules, hardware vendors, gateways, point-of-sale systems, risk departments, support teams, and merchants all touching the same flow.

The real industry
Banks
Processors
Card Networks
Sales Organizations
Hardware Vendors
Gateways
Compliance Teams
Risk Departments
Support Teams
Merchants

Once you see that, support changes. You stop asking "why didn't the money show up?" and start asking "where in the chain is the state different from what the merchant thinks it is?"

Part II
Following The Money
What happens in two seconds, and why funding takes longer
C4 - C6
C4
What Happens When Someone Taps A Card
The transaction journey hidden inside "approved"
Authorization path
Customer
  -> Terminal
  -> POS
  -> Gateway
  -> Processor
  -> Card Network
  -> Issuing Bank
  -> Approval / Decline
  -> Back through the chain

The tap is not money moving. It is a request for permission. The terminal collects card data. The POS attaches sale information. The gateway or processor routes the request. The network identifies the issuing bank. The issuing bank checks the card, account, fraud rules, available credit or funds, and returns a decision.

KEY
Authorization answers: "Can this transaction be accepted right now?" It does not mean the merchant has been funded.
C5
Why Money Doesn't Move Instantly
Authorization, capture, settlement, and funding are different states
StateMeaningSupport translation
AuthorizationIssuer approved the transaction request.The cardholder can buy; funds may be held.
CaptureMerchant finalizes the transaction for clearing.The sale is ready to be included in settlement.
SettlementTransactions are submitted through the processing/network/bank chain.The batch is being reconciled between parties.
FundingMerchant receives money in the bank account.The merchant sees the deposit.

Merchants often collapse all four into "paid." Support cannot. A missing money ticket starts by identifying which state the transaction actually reached.

C6
Why Paid Doesn't Mean Paid
Approved is not funded

The customer sees approved. The merchant expects funded. Reality may be authorized, captured, settled, held, reversed, charged back, batched late, funded to a different account, or delayed by risk review.

Customer language
"It went through."
Merchant language
"Where is my money?"
Processor language
"Authorization approved, batch submitted, funding pending."
Support job
Translate between all three without promising what you cannot verify.
Part III
Meeting The Industry
The players behind every authorization, fee, decline, hold, and deposit
C7 - C12
C7
The Agent
The sales side of payments

Merchant services became a sales industry because merchants need acceptance, pricing is confusing, providers are hard to compare, and relationships matter when money is interrupted. Agents and ISOs bring merchants into the ecosystem and often earn residuals from processing volume.

The best agents understand fit, risk, hardware, pricing, and support. The worst sell "free processing" and vanish when underwriting, funding, or chargebacks appear.

C8
The Processor
The transaction engine most customers never see

Processors route authorization messages, support settlement, generate reports, monitor risk, integrate with terminals and gateways, and connect merchants to the broader card ecosystem. Names like Fiserv, TSYS, Worldpay, and Global Payments may be invisible to consumers while processing enormous transaction volume behind the scenes.

Processor work

Route messages

Move transaction data between merchant systems, networks, and banks.

Processor work

Settle batches

Help turn approved transactions into clearing and funding records.

Processor work

Report activity

Statements, deposits, fees, chargebacks, and transaction history.

Processor work

Monitor risk

Spot unusual volume, fraud patterns, and merchant behavior changes.

C9
The Sponsoring Bank
The chapter where risk starts to make sense

Merchant processing is tied to banking because card acceptance creates risk. A merchant could take payment today and disappear tomorrow. A customer could dispute a transaction months later. A processor or acquiring bank may have to deal with chargeback exposure, compliance requirements, and financial loss.

RISK
The bank carries risk. That is why underwriting exists, reserves exist, funding holds exist, and accounts can be terminated.
C10
Visa Isn't A Bank
Card networks are highways, not lenders

Visa and Mastercard are card networks. They establish rules, route transactions, define fee structures, support dispute frameworks, and connect issuers and acquirers. They are not usually the bank that issued the card or the bank funding the merchant.

Think of the network like a highway system with rules, tolls, lanes, and traffic signals. The issuing bank and acquiring side are the vehicles moving value and risk across that highway.

C11
The Issuing Bank
Why "Do Not Honor" ruins everyone's afternoon

The issuing bank gave the card to the customer. It owns the relationship with the cardholder and makes many approval or decline decisions based on funds, credit line, fraud rules, card status, geography, merchant type, and behavior patterns.

In support, "Do Not Honor" is frustrating because it often means the issuer declined without giving the merchant a fixable reason. The correct answer is usually not "try harder." It is "the cardholder should contact their bank or use another payment method."

C12
The Acquiring Side
The merchant's side of the ecosystem

The acquiring side enables the merchant to accept card payments. It includes merchant accounts, acquirers, processors, ISOs, payment facilitators, gateways, and service providers depending on the model.

Issuer
Cardholder side. Approves or declines the customer's transaction.
Acquirer
Merchant side. Enables acceptance and participates in settlement/funding.
Processor
Technical and operational transaction engine.
Part IV
Why This Industry Exists
Cards are not universal; payment culture changes by country
C13 - C15
C13
The United States Built An Economy Around Cards
Credit, rewards, acceptance, and consumer habit

In the United States, cards are not just payment instruments. They are credit products, rewards systems, fraud-protection tools, convenience layers, loyalty devices, and business acceptance infrastructure. Consumers expect cards to work almost everywhere, and merchants often accept the cost because card acceptance can increase conversion and ticket size.

C14
Why The Philippines Is Different
Cash, wallets, bank transfers, and local rails

Payment processing feels different depending on where you live. In the Philippines, cash, bank transfers, QR payments, GCash, Maya, and local wallet behavior shape the market differently from US card culture. A person raised in one system may assume the other is strange until they understand the incentives.

MAP
Payments are local before they are global. Regulation, banking access, credit culture, fraud patterns, consumer trust, and mobile adoption all change the payment stack.
C15
The Economics Of A $100 Transaction
Who gets what when the merchant sees a fee

A $100 card sale does not usually produce a clean $100 deposit. A slice goes to interchange, a slice to network assessments, and a slice to processor/provider markup. The exact amount depends on card type, merchant category, transaction method, pricing model, region, risk, and program rules.

RecipientWhy they get paid
Issuing bankTakes credit/fraud exposure and receives interchange.
Card networkRuns the network rules and rails, receives assessments/network fees.
Processor/providerRoutes, reports, supports, funds, monitors, and maintains infrastructure.
Agent/ISOMay receive residuals for sales and relationship management.
Part V
Merchant Services
The business conversation merchants actually have
C16 - C21
C16
Why Businesses Accept Cards
Convenience is expensive, but friction is expensive too

Businesses accept cards because customers expect it, tickets can increase, checkout is easier, online commerce requires it, and refusing cards can cost sales. The merchant dislikes fees, but also dislikes losing customers who do not carry cash or expect rewards.

C17
Understanding Merchant Statements
A beginner's guide to the bill nobody wants to read
1

Find volume

Total card sales processed for the statement period.

2

Find total fees

All processing and monthly charges combined.

3

Calculate effective rate

Total fees divided by total volume. This is a blunt but useful starting point.

4

Separate pass-through from markup

Interchange and assessments are not the same as provider profit.

C18
Surcharging
How it actually works — mechanics, compliance, and the debit rule everyone forgets

Surcharging adds a fee to credit card transactions, shifting processing cost from the merchant to the customer. Merchants love it because it eliminates their largest operating expense. Customers dislike it because cost becomes visible at the worst moment: checkout. Done right, it is legal in most of the US. Done wrong, it is a compliance incident.

How it works operationally: The POS or gateway is programmed to automatically detect credit card transactions and apply the surcharge. The fee appears as a separate line item. The merchant receives the full item price. Debit and prepaid card transactions cannot be surcharged — federal law prohibits it, even if the debit card runs as credit.

RuleDetail
Maximum surcharge3% in most states. Card brand max: Mastercard 4%, Visa 3% — processors enforce 3% at POS for compliance uniformity.
Debit/prepaidCannot be surcharged. Federal law. No exceptions.
Card brand uniformitySame surcharge rate must apply across all card brands — cannot charge more for Amex than Visa.
Signage requiredSign at entrance AND at checkout/POS. Not optional.
Receipt disclosureSurcharge must appear as a separate line item on the receipt.
RefundsIf you refund the purchase, you refund the surcharge too.
State statusJurisdictions
BannedConnecticut, Massachusetts, Puerto Rico
Capped at 2%Colorado, Oklahoma
Allowed with local rulesCalifornia, Florida, Kansas, Maine, New York, Texas
Generally allowed (3% cap)Most other states
LEGAL
Never tell a merchant "just add 4%" without compliance review. Rate, signage, and disclosure rules vary by state. Violations can trigger card brand fines, higher chargeback rates, and account termination.

Best fit: High-risk merchants offsetting elevated rates, small retail, B2B-heavy businesses with high rewards card volume, enterprise processing large amounts on business credit cards.

C19
Cash Discount Programs
The psychology flip that changes how customers see the fee

A cash discount program posts a regular price that already absorbs the card acceptance cost — then offers a discount to customers who pay with cash. The merchant still recovers their processing cost, but the framing flips: instead of a penalty for using a card, it feels like a reward for using cash.

Why the framing matters: Consumer psychology responds differently to gains vs losses. A $3 surcharge on a $100 sale feels punitive. A $3 discount for cash on a $103 listed price feels like a deal. Same math. Very different reaction at checkout.

Surcharging
Post the cash price ($100). Add a fee for credit ($103). Customer sees: penalty for card.
Cash Discount
Post the card price ($103). Offer a discount for cash ($100). Customer sees: reward for cash.
Net result
Merchant recovers processing cost in both cases. Cash discount can sidestep some state surcharging restrictions since it is structured as a discount, not a fee added at checkout.
NOTE
Cash discount still has compliance requirements. The posted price must be the card price. A merchant who posts the cash price and then adds a fee at checkout is surcharging, not cash discounting — regardless of what they call it. Signage and disclosure still apply.

Best fit: Service businesses, salons, auto shops, markets — any environment where cash-paying customers are common and posting a slightly higher listed price is acceptable.

C20
Dual Pricing
Two prices shown before checkout — no surprise at the register

Dual pricing displays two prices side-by-side on the menu, shelf tag, or POS screen: one for cash, one for card. The customer sees both before deciding how to pay. No surprise at checkout — the card price reflects the merchant's cost of card acceptance, built into the price itself.

Cash price
$9.50
Card price
$9.79
Difference
~3% — the processing cost, absorbed into the card price

Why merchants prefer it over surcharging: No surprise at checkout means less friction and fewer complaints. The customer self-selects before they reach the register. Gas stations have operated this way for decades — "cash price / credit price" on the pump — which is why most consumers already understand the concept even in other environments.

Best fit: Quick-service restaurants, gas stations, high-volume low-margin retail — any business where price is visible before checkout and cash is a realistic option.

ADMIN
For admin setup: the POS must be programmed to display dual prices and apply the correct rate at payment. Ensure the card price covers fees plus any remaining costs — dual pricing only eliminates processing cost, not monthly service fees, PCI fees, or chargebacks.
C21
The Dream Of Zero Cost Processing
Cost recovery, not magic — but the math can actually work

"Zero cost processing" is a marketing term for a real operational decision: shifting credit card processing fees from the merchant to the customer. The cost does not disappear — it moves. But for many merchants, that move is the right call.

The three mechanisms (all are "zero cost" programs):

Surcharging
Add a fee to credit card transactions at checkout. Debit exempt. Capped at 3%. Banned in CT, MA, PR.
Cash Discount
Post card price, offer cash discount. Avoids some surcharging restrictions via framing.
Dual Pricing
Show both prices upfront. Customer selects payment method knowing both prices before checkout.

Costs that remain even with zero-cost processing:

  • Monthly service fees (account maintenance, reporting, support)
  • PCI compliance fees
  • Equipment and terminal costs
  • Chargeback fees (per dispute, regardless of outcome)
  • ACH/eCheck fees if using bank-based payment options
ADMIN
When setting up a zero-cost program, confirm the POS handles it correctly. Common failure: system applies the surcharge to debit cards. This is a federal compliance violation. Always test with both a credit and a debit card before go-live.
A merchant processing $100K/month at 3% pays $3,000/month in fees. Under a compliant surcharging program, that $3,000 moves to the customers who choose to pay by credit card. The math works more often than merchants expect — friction tradeoffs vary by business type, but the net is usually positive for the merchant who sets it up correctly.
Part VI
Merchant Onboarding
Why signing up is not the same as being approved to move money
C22 - C26
C22
The Merchant Who Just Wants To Take Cards
Expectation vs reality
Expectation
Sign Up
  -> Take Payments
Reality
Application
  -> Verification
  -> Underwriting
  -> Approval
  -> Deployment
  -> Processing
  -> Monitoring

Payment acceptance is not just account creation. It is permission to participate in a risk-bearing financial system.

C23
KYB
Know Your Business

KYB verifies that the business is real, the owners are identifiable, the activity matches what was represented, and the provider understands the risk. It can include business documents, beneficial ownership, website review, bank verification, processing history, tax IDs, and prohibited activity checks.

C24
Underwriting
The department every merchant eventually meets

Underwriting asks: should this merchant be allowed to process, at what volume, under what terms, and with what controls? A low-risk coffee shop and a high-ticket coaching program do not carry the same exposure.

Business model
What is being sold and how is it fulfilled?
Ticket size
Higher tickets increase dispute exposure.
Delivery timing
Future delivery creates risk if the merchant fails before fulfilling.
History
Chargebacks, processing volume, refunds, and prior terminations matter.
C25
High Risk Merchants
Rates, triggers, MATCH/TMF, and how to actually get approved

High-risk classification is a risk assessment, not a judgment. Banks and processors see a statistical pattern across certain industries: higher chargebacks, regulatory exposure, delayed fulfillment, or fraud-adjacent behavior. The classification determines what the merchant pays, what controls apply, and whether they get approved at all.

Rate range: 3.25%–3.99% (vs 2.5–2.9% for standard merchants). The spread exists because the acquiring bank absorbs more exposure and charges accordingly.

What triggers high-risk classification:

  • Chargeback ratio above 1% of monthly transactions — the threshold where banks get nervous
  • Industry is regulated, controversial, or has unpredictable sales patterns
  • High percentage of card-not-present (CNP) transactions
  • Subscription or trial-offer billing models
  • Large average ticket sizes with delayed fulfillment
  • International sales exposure
  • Prior terminations or credit issues
  • MATCH/TMF listing (see C88)
IndustryWhy flagged
CBD, Cannabis, Vape, TobaccoRegulatory ambiguity, age verification requirements, bank reputational risk
Adult businessesReputational risk, chargeback exposure
Nutraceuticals / supplementsTrial-offer chargeback history across the industry
Credit repair / MLMFTC regulation, refund and dispute rates
Drop shippingFulfillment liability when supplier fails
Medical billingInsurance complexity, delayed payment cycles, high ticket
Jet / Charter / TravelHigh-ticket, advance deposits, future delivery risk
Firearms dealers (FFL)Card network pressure, processor list shrinking
Bail bonds, pawn shopsRegulatory, reputational, transaction variety
Peptides (research products)Grey area regulatory; MATCH/TMF merchants now being served (April 2026)

Rate negotiation levers: Chargeback ratio history (lower = better), industry type, international sales volume, subscription vs one-time model, average ticket size, and documented financial stability. Transparency with the underwriter helps — providing detailed business information proactively usually gets better terms than forcing underwriters to dig.

MATCH/TMF
MATCH (Mastercard Alert to Control High-Risk Merchants) and TMF (Terminated Merchant File, Visa's equivalent) are industry blacklists. Being listed means most standard processors will reject the application. Specialized high-risk processors with the right bank relationships can still place MATCH/TMF merchants — but rates will be higher and documentation requirements more intensive. See C88 for full detail.
C26
Holds And Reserves
Why processors sometimes say "not yet"

Funding holds and reserves are risk controls. A rolling reserve withholds a percentage of processing volume for a period. A hold pauses funding while risk reviews activity. Merchants experience this emotionally as "they took my money." Providers see it as exposure management.

SUPPORT
When discussing holds, do not speculate. Confirm the reason code or risk note, explain the required documents or timeline, and avoid promising release dates unless risk has confirmed them.
Part VII
Hardware And Infrastructure
The counter, the cloud, and the bridge between them
C27 - C31
C27
The Terminal On The Counter
EMV, NFC, tap-to-pay, and the hardware categories behind "swipe your card"

The terminal is the visible edge of the payment system. It reads cards, encrypts data, prompts for PIN or signature, communicates with the processor or POS, and returns the result. When anything fails, the terminal gets blamed because it is the only thing the merchant can see. Most of the time, the terminal did its job — the problem is upstream.

How it reads cards:

Magstripe (swipe)
The old stripe on the back. Least secure. Still exists as fallback for chip failures.
EMV (chip)
Europay-Mastercard-Visa chip standard. Generates a unique transaction code per use — cannot be cloned like magstripe. Required since 2015 liability shift.
NFC (tap/contactless)
Near-field communication. Apple Pay, Google Pay, tap-enabled cards. Fastest at checkout. EMV-level security.

Hardware categories:

Countertop terminal

Fixed desk unit

Ingenico Desk 1500, Verifone, PAX. Wired connection, sits at register. Most common in traditional retail.

Wireless terminal

Mobile terminal

Clover Flex, Ingenico AXIUM. Battery-powered, Wi-Fi or cellular. Used tableside, in warehouses, at pop-ups.

Mobile reader

Phone/tablet attachment

Clover Go, SwipeSimple. Bluetooth or audio jack. Works with a smartphone app. Field reps, service businesses.

PIN pad

Customer-facing input

Separate from the merchant display. Customer enters PIN or signs directly. Used in retail where merchant and customer displays are split.

SUPPORT
The 2015 EMV liability shift matters for support tickets: before EMV, card networks covered counterfeit fraud losses. After the shift, if a merchant accepts a chip card via magstripe (because they did not upgrade), the merchant is liable for counterfeit fraud. A swipe-only terminal is not just outdated — it is a live liability exposure.
C28
POS Systems
The software layer that became its own industry — and why the choice matters

A POS system is the full operational layer of a physical payment environment: inventory, staff, orders, tips, reporting, loyalty, menus, tables, customer profiles, and payment acceptance — all in one platform. The payment is one event inside a larger business management system. Choosing a POS means choosing an ecosystem.

The Clover ecosystem is the most commonly deployed through traditional merchant services. Different hardware for different environments:

Clover Station Solo
Full countertop POS; large tiltable touchscreen, integrated printer. Standard retail and restaurant.
Clover Station Duo 2
Dual screen: merchant-facing and customer-facing. Speeds checkout in high-volume environments.
Clover Mini
Compact countertop unit. Same functionality, smaller footprint. Tight counter space.
Clover Flex
Handheld wireless. Built-in printer, camera, scanner. Tableside ordering, mobile retail, field use.
Clover Kiosk
Self-service ordering and payment. Customer-facing. QSR, food halls, high-volume quick service.
Clover Go
Bluetooth mobile reader. Phone/tablet. Lowest cost. Field reps, markets, pop-ups.

Other POS systems by use case:

Retail (multi-SKU)

LightSpeed, coreSTORE

Inventory management for high-SKU retail. coreSTORE built for independent retailers and FFL dealers (firearms licensing).

Restaurant

Toast, Union POS, MYR

Table management, ticket routing, tip handling. Toast is cloud-native. Clover also serves restaurants with the right app configuration.

High-SKU independent

Bodega AI

AI-native POS preloaded with 200,000+ SKUs. Built for convenience stores and high-volume independent retail where manual SKU entry is impractical.

Omnichannel

ConnectPOS

Bridges online stores (Shopify, Magento) with physical locations. One inventory, one order history, across both channels.

ADMIN
POS choice is not just hardware — it is a software lock-in decision. Clover apps live in the Clover ecosystem. Migrating away from a POS means migrating inventory data, staff records, customer profiles, and historical sales data. Always clarify the POS before setting up any integration or adding software to the account.
C29
Gateways
The digital bridge — and why the choice of gateway is actually a use-case decision

A payment gateway connects digital transaction requests to processing rails. In ecommerce, it handles checkout communication, tokenization, authorization requests, captures, refunds, recurring billing, fraud filtering, and integrations with carts, CRMs, and apps. Not all gateways are equivalent — the right choice depends on the merchant type, risk profile, and existing platform stack.

The three you encounter most in merchant services:

Authorize.net
The standard choice. Most widely deployed gateway in traditional merchant services. Works with virtually every ecommerce platform. Strong fraud detection (Advanced Fraud Detection Suite). Recurring billing built in. Not high-risk-native — standard merchants, broad compatibility.
NMI (Network Merchants Inc)
The ISO/agent channel pick. Built for the reseller world. ISOs and agents use NMI because it supports white-labeling, sub-merchant management, and complex routing. Recurring billing, fraud tools, virtual terminal. If a processor works with agents, NMI is often in the stack.
FluidPay
The high-risk / CNP-capable choice. Designed for card-not-present environments where standard gateways decline. Better tolerance for high-risk industries. Used when Authorize.net or NMI can't support the merchant category or triggers too many declines.

Other notable gateways: accept.blue (recurring-focused), BlueSnap (global, subscription-capable), PayTrace (B2B / Level 2–3 data), Heartland, Cybersource (enterprise/Visa-owned), USAePay (high-risk friendly).

ADMIN
Gateway and processor are often bundled but are technically separate layers. A merchant might use Authorize.net as the gateway while their processor is a different company entirely. When troubleshooting, always confirm which layer the error is coming from — gateway decline vs processor decline vs issuer decline have different resolution paths.
C30
Why Stripe Changed Everything
APIs, developer-first infrastructure, and embedded payments

Stripe made payments feel programmable. Instead of only thinking in terminals and merchant statements, developers could create customers, payment intents, subscriptions, invoices, webhooks, connected accounts, and platform payments through APIs. This helped shift the industry from merchant services as a sales conversation to payments as infrastructure.

C31
Gateway vs Processor
The confusion chapter
Gateway
The digital front door that accepts transaction requests and connects software to payment processing.
Processor
The engine that routes, clears, reports, and supports transaction processing.
Why confusing
Some companies provide both, and modern platforms blur the layers for convenience.
Part VIII
Support Field Manual
How to think when the merchant is angry and the answer is hidden in a system state
C32 - C36
C32
The Missing Money Ticket
Investigation framework
1

Identify the transaction or batch

Date, amount, last four, authorization code, batch number, location, terminal/POS, and merchant ID.

2

Check state

Authorized, captured, voided, refunded, settled, rejected, held, charged back, or funded.

3

Check batch timing

Was the batch closed? Was it after cutoff? Was there a weekend or holiday?

4

Check bank account

Was funding sent to the expected bank account? Any recent bank changes?

5

Check risk notes

Any hold, reserve, review, rejected batch, negative balance, or documentation request?

DON'T
Do not say "the money will arrive tomorrow" because the merchant wants relief. Say what state you can verify and what must happen next.
C33
The Declined Transaction
Who actually owns the problem?

A decline can come from the issuer, the processor, the gateway, fraud rules, terminal configuration, card type restrictions, AVS/CVV mismatch, insufficient funds, card status, or network issues. The support move is to identify who made the decision.

Decline typeLikely ownerSupport answer
Insufficient fundsIssuer/cardholderUse another payment method or contact bank.
Do Not HonorIssuerCardholder must contact bank; reason may not be disclosed.
AVS/CVV mismatchGateway/fraud rulesVerify billing info or adjust fraud settings if appropriate.
Card type not acceptedMerchant account setupCheck acceptance settings and card brand permissions.
Terminal communication failureDevice/networkTroubleshoot connectivity before blaming the card.
C34
The Terminal Isn't Working
Real troubleshooting without panic
1

Power

Is the device on, charged, plugged in, and booted correctly?

2

Network

Wi-Fi, Ethernet, cellular, IP settings, signal strength, router changes.

3

Scope

One terminal, all terminals, one location, all locations, one card type, all cards?

4

Error

Exact message, screenshot, receipt, time, transaction amount, firmware/app version.

5

Fallback

Can merchant use another terminal, virtual terminal, invoice link, or offline process if allowed?

C35
Escalation Paths
Agent vs processor vs bank
IssueFirst teamEscalate to
Statement confusionSupport/agentPricing or account manager
Missing depositSupportProcessor/funding/risk
Risk holdSupport documentsRisk/underwriting
Issuer declineSupport explainsCardholder's bank, not merchant processor
Terminal hardware failureSupport troubleshootingDevice vendor/deployment team
ChargebackSupport intakeDisputes team
C36
The Questions Every Support Agent Should Ask First
A practical framework
First questions
1. What merchant account / location is affected?
2. What exactly happened, and what did you expect to happen?
3. Is this about authorization, settlement, funding, fees, hardware, or reporting?
4. What date, amount, card last four, batch, or deposit are we investigating?
5. Is the issue one transaction, one batch, one device, one customer, or everything?
6. What changed recently? Bank account, terminal, POS, pricing, ownership, volume?
7. Is there a risk hold, dispute, refund, rejected batch, or documentation request?
8. What can I verify before I promise anything?
Part IX
Payments As Systems
The Aaron chapter: every payment is an event in a larger business machine
C37 - C40
C37
Every Payment Is An Event
Not money first. State first.

A payment is an event before it is money in an account. It has states, timestamps, identifiers, actors, rules, retries, failures, notifications, and downstream consequences. Approved, captured, settled, refunded, disputed, failed, held, and funded are all states in a system.

Once you see payments as events, payment processing starts to look less like a cash register and more like distributed infrastructure.

C38
Webhooks Move Modern Commerce
Stripe events, payment notifications, CRM updates

Modern commerce runs on payment events. A successful payment can unlock a course, create a CRM opportunity, send a receipt, update inventory, schedule fulfillment, start a subscription, notify accounting, or trigger a support workflow.

Payment event chain
payment_intent.succeeded
  -> mark invoice paid
  -> update CRM deal
  -> send receipt
  -> grant product access
  -> notify fulfillment
  -> update revenue dashboard
C39
Most Payment Problems Are Not Payment Problems
They are CRM, automation, and integration problems wearing a payment costume

The charge went through, but the course was not unlocked. The invoice was paid, but the CRM still says open. The refund was issued, but the customer received another renewal email. The subscription failed, but nobody created a recovery task. In each case, the payment processor may have done its job. The business system failed to respond correctly.

SYSTEM
A support agent who understands payments and automation becomes dangerous in the best way. They can see where money, data, and process fell out of sync.
C40
Following The Money
The final map

At the beginning, the model looked like this:

Customer
  -> Pays
  -> Business Gets Money

After the industry teaches you a few lessons, the model becomes this:

Customer
  -> Terminal
  -> POS
  -> Gateway
  -> Processor
  -> Network
  -> Issuing Bank
  -> Acquiring Bank
  -> Settlement
  -> Funding
  -> CRM
  -> Reporting
  -> Business
The industry I thought was about processing payments was actually about managing trust, risk, technology, compliance, and the movement of money at scale.

That is why payment processing deserves a Grimoire. It is a history, an onboarding guide, a support manual, and an industry map all at once.

And for me, it is also a career artifact. Every strange ticket taught a layer. Every merchant statement taught economics. Every decline taught ownership. Every hold taught risk. Every terminal failure taught infrastructure. Every integration issue taught that payments do not end when the card is approved; they continue into CRM records, automations, reports, receipts, subscriptions, and the emotional reality of a business owner waiting for money.

Support was never just support. It was the front-row seat to how commerce actually works when the clean diagrams fail. This Grimoire is the map I had to build one call, one ticket, one merchant, one batch, one decline, one funding delay at a time.
Part X
Career Case Files
The support scars that turn concepts into instincts
C41 - C47
C41
The First Week On The Floor
When every acronym sounds like a locked door

The first week in payments is a wall of terms: MID, TID, batch, auth, settlement, interchange, PCI, gateway, chargeback, descriptor, reserve, ACH, AVS, CVV, EMV, NFC. You do not learn them from a glossary first. You learn them because a merchant is waiting and the ticket will not move until you understand which word matters.

TRAIN
A new support agent should not memorize everything at once. They should learn the five core maps first: transaction state, money movement, account identity, hardware path, and escalation ownership.
C42
The First Angry Merchant Call
The moment empathy becomes operational

Anger in payments is rarely just anger. It is payroll pressure, rent pressure, customer embarrassment, fear of fraud, or the feeling that a financial system is speaking a language the merchant never agreed to learn.

The support lesson is simple: acknowledge the pressure, then narrow the investigation. "I understand why this is urgent. I am going to verify the transaction state, the batch, and the funding record before I give you an answer." Calm is not softness. Calm is how you keep the case from becoming theater.

C43
The Statement Explanation I Got Wrong
Why merchants feel lied to when nobody explains pricing

The first bad statement explanation usually sounds like hiding: "Those are just processing fees." That answer is technically adjacent to truth and emotionally useless. Merchants need categories: pass-through costs, provider markup, monthly/service fees, compliance fees, and behavior-based costs such as keyed transactions, downgrades, chargebacks, or batch fees.

Merchant asksWeak answerBetter answer
Why is this so expensive?That's just your rate.Let's separate card network/bank costs from provider markup and monthly fees.
Why did it change?Rates vary.Your card mix, entry type, volume, refunds, chargebacks, or assessment changes may have changed.
Can you remove this?No.Some fees are pass-through; some are provider-controlled. I'll identify which is which.
C44
The Business That Grew Too Fast
Why success can trigger risk review

One of the strangest lessons in payments: a merchant making more money can look like risk. A sudden volume spike, higher average ticket, new product, different fulfillment promise, or unusual refund pattern can trigger review because the processor underwrote one risk profile and is now seeing another.

Merchant view
"Business is finally working. Why are you holding funds?"
Risk view
"The account is processing outside expected behavior. Exposure increased."
Support bridge
Collect invoices, fulfillment proof, bank statements, marketing pages, and processing explanation.
C45
The First Chargeback Case
The sale that came back as a fight

A chargeback teaches that "approved" does not mean final forever. The cardholder can dispute. The issuer can reverse funds provisionally. The merchant must respond with evidence. If chargeback ratios rise, the entire merchant account can become a risk problem.

1

Dispute arrives

Reason code, transaction, deadline, amount, cardholder claim.

2

Merchant gathers evidence

Receipt, invoice, signed agreement, delivery proof, refund policy, communication logs.

3

Representment

Merchant or provider submits evidence to fight the dispute.

4

Decision

Issuer/network process determines whether funds stay reversed or return.

C46
The Refund That Broke The Batch
Negative days, rejected funding, and merchant confusion

Refunds feel like undo buttons to customers. In settlement, they are transactions with consequences. A day with more refunds than sales can produce a negative batch. A merchant with insufficient reserve or bank issues may see funding adjustments, rejects, or delayed deposits.

CHECK
When funding is short, check refunds, chargebacks, fees, reserves, negative batches, ACH rejects, and previous-day adjustments before assuming a deposit is missing.
C47
The Terminal That Wasn't Broken
When the visible device gets blamed for an invisible configuration

Sometimes the terminal is fine. The problem is the Wi-Fi, the POS integration, the merchant account setup, the terminal ID, the batch configuration, the unsupported card type, the gateway credentials, or a processor outage. Good support agents resist the first obvious answer.

Device problem
Power, reader, printer, screen, firmware, damage.
Network problem
Wi-Fi, Ethernet, cellular, DNS, router, firewall.
Setup problem
TID, MID, processor config, card type, batch settings, gateway credentials.
Part XI
Payment Mechanics Support Agents Must Know
Receipt literacy, auth codes, rekeys, entry types, descriptors, pricing, disputes, and processor models
C48 - C56
C48
Parts Of A Receipt
The tiny paper trail support agents should be able to read

A receipt is not just proof for the customer. It is an investigation artifact. It can reveal transaction state, card entry method, authorization code, merchant identity, terminal identity, batch context, masked PAN, card brand, timestamp, and whether the merchant is looking at the right sale.

Receipt fieldWhat it meansSupport use
Merchant name/locationBusiness identity printed on receiptConfirms merchant/location, may differ from descriptor.
Date/timeTransaction timestampCompare with batch cutoff and funding date.
AmountSale, tip, tax, totalMatch transaction records and deposits.
Card brandVisa, Mastercard, Amex, Discover, etc.Useful for card-type restrictions and fee questions.
Masked card numberUsually last four digitsHelps locate transaction without exposing full PAN.
Entry methodChip, tap, swipe, keyed, ecommerceImpacts risk, liability, and fees.
Auth codeIssuer approval referenceProof that authorization happened, not proof of funding.
Reference / trace / transaction IDProcessor or terminal identifierKey for searching processor records.
Batch numberBatch grouping identifierUseful for settlement/funding investigation.
AID / TVR / TSIEMV technical fieldsDevice/card diagnostics for advanced cases.
PCI
Never ask a merchant to email full card numbers, CVV, or sensitive authentication data. Use last four, date, amount, auth code, and transaction/reference IDs.
C49
What Is An Auth Code?
The approval fingerprint merchants often misunderstand

An authorization code is a code returned after the issuer approves an authorization request. It is useful evidence that the transaction was approved at that moment. It is not a deposit confirmation, not a settlement confirmation, and not a promise that a dispute cannot happen later.

Means
Issuer approved the authorization request.
Does not mean
Funds are in the merchant bank account.
Use it for
Finding transactions, proving approval, matching receipts to processor records.
Support phrase
"The auth code confirms approval. Now we need to verify capture, settlement, and funding."
C50
Rekey Same Auth
When an approved authorization has to be manually corrected or re-entered

In some support environments, "rekey same auth" refers to re-entering or correcting a transaction using the same original authorization approval rather than obtaining a brand-new authorization. The exact process depends on processor, gateway, POS, and internal policy.

CAUTION
Treat rekey/same-auth handling as policy-sensitive. A support agent should confirm processor rules, transaction state, amount, auth code, and whether the original transaction was captured, voided, duplicated, or missing before advising action.
1

Verify original approval

Receipt, auth code, date, amount, last four, processor record.

2

Check current state

Authorized only, captured, settled, voided, failed, duplicate, or missing.

3

Prevent duplicate billing

Never rekey blindly. Confirm whether the cardholder was already charged or held.

4

Document

Record who approved, why it was rekeyed, original auth, and final transaction ID.

C51
Entry Types
How the card entered the transaction changes risk and cost
Entry typeMeaningSupport significance
Chip / EMVCard inserted into chip readerLower counterfeit risk, card-present evidence.
Tap / NFCContactless card or walletCard-present, tokenized wallet may show device account number.
SwipeMagstripe readHigher counterfeit risk than EMV; fallback matters.
KeyedCard manually enteredHigher risk and usually higher cost; AVS/CVV important.
EcommerceOnline checkoutCard-not-present; fraud tools and descriptor clarity matter.
MOTOMail order / telephone orderCard-not-present; documentation and authorization practices matter.
RecurringStored credential/subscriptionRequires consent, proper indicators, retry and cancellation handling.
C52
Billing Descriptors
The line on the cardholder statement that can prevent or cause disputes

A billing descriptor is the merchant name or label a customer sees on their card statement. If the descriptor is confusing, customers may dispute a legitimate transaction because they do not recognize it.

Static descriptor
Same descriptor appears for transactions.
Dynamic descriptor
Descriptor can include product, location, or platform-specific detail where supported.
Support symptom
"My customer says they don't recognize the charge."
Fix path
Verify descriptor setup, receipt branding, confirmation emails, and customer-facing business name.
C53
Pricing Models: Flat, Interchange-Plus, Tiered
Why the same $100 can cost different merchants different amounts
ModelHow it feelsSupport explanation
Flat rateSimple percentageEasy to understand, may be more expensive for some card mixes.
Interchange-plusPass-through plus markupMore transparent, but statements look more complex.
TieredQualified/mid/non-qualified bucketsOften confusing; downgrades can frustrate merchants.
Subscription/membershipMonthly fee plus lower markupCan work for volume, but math must be checked.

The support agent should avoid arguing about "best." The right model depends on volume, card mix, ticket size, entry method, risk, business type, and the merchant's tolerance for complexity.

C54
Chargebacks, Retrievals, Representment, Ratios
The dispute lifecycle in support language
Retrieval request
A request for transaction information or documentation before or around dispute handling.
Chargeback
A cardholder dispute that can reverse funds from the merchant.
Representment
Merchant's attempt to fight the dispute with evidence.
Friendly fraud
Customer disputes a legitimate transaction, intentionally or through confusion.
Chargeback ratio
Chargebacks relative to transaction count/volume. High ratios can trigger monitoring or termination.
C55
Risk Flags Support Agents Should Recognize
When a ticket is not just a ticket
FlagWhy it mattersAsk for
Sudden volume spikeExposure exceeds expected processingInvoices, fulfillment proof, campaign explanation.
High ticket increaseLarger chargeback exposureContracts, delivery terms, customer communication.
Many refundsPossible dissatisfaction or operational issueRefund reasons and product/service changes.
New business modelUnderwriting mismatchUpdated website, offer, terms, and processing forecast.
Chargeback clusterAccount stability riskEvidence packets, customer communication, prevention plan.
Bank account changeFraud and funding riskVerified ownership and authorization.
C56
Processor Models
Traditional merchant accounts, PayFacs, ISOs, and embedded payments
ModelWhat it isSupport implication
Traditional merchant accountMerchant has a direct-ish acquiring relationship through provider stack.More underwriting, more control, more statement complexity.
Payment facilitatorPlatform onboards sub-merchants under its master processing setup.Fast onboarding, centralized risk, platform-controlled experience.
ISO/MSPSales/service organization resells or manages merchant services.Relationship layer may own merchant communication.
Stripe/Square-styleDeveloper/platform-first or aggregated processing experience.Fast start, policy-driven holds, API/event support.
Embedded paymentsPayments built into software platforms.Merchant may think the software company is the processor.
Part XII
Support Scripts And Ticket Templates
Language that calms, narrows, verifies, and escalates
C57 - C62
C57
Missing Deposit Call Script
The call no one wants, handled cleanly
I understand why this is urgent. I am going to trace this in order:
1. The batch date and close time
2. The settlement status
3. The funding record
4. Any holds, reserves, fees, refunds, chargebacks, or ACH rejects

Can you confirm the processing date, expected deposit amount, and last deposit you received?

Never start with blame. Start with the chain.

C58
"Why Are My Fees So High?" Script
Explaining without hiding
Let's break the statement into categories instead of treating it as one mystery fee:
- Card brand and issuing bank costs
- Processor/provider markup
- Monthly or service fees
- Behavior-based costs like keyed transactions, chargebacks, or batch fees

I'll calculate your effective rate first, then we can identify which fees are controllable.
C59
Declined Card Explanation Script
When the merchant wants you to override the issuer
The decline response came from the card side, not from your terminal approving or rejecting the customer personally.
In many cases, the issuing bank does not provide us a detailed reason.
The customer should contact their bank or use another payment method.

I can still check whether this is affecting all cards, one card type, one terminal, or only this customer's card.
C60
Hold Or Reserve Conversation Script
When the answer is "not yet"
I know a funding hold creates real pressure. My job is to help identify what risk needs in order to review it.
I do not want to guess or promise a release date before the review team confirms it.

Right now we need:
- Reason for hold
- Documents requested
- Affected batches/amounts
- Review timeline if available
- Any reserve terms or release conditions
C61
Terminal Troubleshooting Script
A calm path through a noisy moment
Let's isolate whether this is device, network, account setup, or processor-side.
1. Is this one terminal or all terminals?
2. Is it all cards or one card/customer?
3. What exact error appears?
4. Is the terminal connected to Wi-Fi, Ethernet, or cellular?
5. Did anything change today: router, POS, location, account, or update?
6. Can you send a photo of the error screen and last receipt if safe?
C62
Escalation Note Template
How to make the next team love you
Merchant:
MID / Location:
Contact:
Issue type:
Urgency / business impact:

Timeline:
- 

Evidence collected:
- Date/time:
- Amount:
- Last four:
- Auth code:
- Batch number:
- Transaction/reference ID:
- Error message:
- Screenshots/receipts:

What was checked:
- Authorization:
- Capture:
- Settlement:
- Funding:
- Risk notes:
- Device/network:

What merchant expects:
What we need from escalation:
What was communicated to merchant:
Part XIII
Future AI Support Agent Knowledge Base
Structured support logic for email triage, draft replies, and escalation
C63 - C70
C63
Support Intent Map
How an AI email agent should classify incoming messages
IntentSignalsRoute
Missing depositWhere is my money, deposit missing, batch funded, bank accountFunding investigation
Fee questionStatement, rates, fees, expensive, PCI, monthly chargeStatement review
DeclineDo Not Honor, declined, won't go through, card rejectedDecline troubleshooting
HardwareTerminal down, reader not working, error screen, printerDevice support
Risk/holdFunds held, reserve, account frozen, documents requestedRisk escalation
ChargebackDispute, retrieval, representment, evidence, chargebackDisputes queue
DescriptorCustomer doesn't recognize charge, statement nameDescriptor review
C64
Required Data Fields For Email Support
What the agent must collect before pretending to know
Common fields:
- Merchant legal name / DBA
- MID or account ID
- Location
- Contact name and callback/email
- Issue category
- Business impact / urgency

Transaction fields:
- Date and time
- Amount
- Last four only
- Card brand
- Auth code
- Transaction/reference ID
- Batch number
- Entry type
- Receipt image if safe

Funding fields:
- Batch date
- Expected amount
- Actual deposit amount
- Bank account last four
- Funding date
- Holds/reserves/fees/refunds/chargebacks checked
C65
Things A Support Agent Should Never Say
Especially an AI support agent
Never saySay instead
Your money will arrive tomorrow.I can verify the current funding status and any release timeline available.
The bank declined for fraud.The issuer declined the transaction; they may not disclose the detailed reason to us.
Just rekey it.We need to verify the original authorization and current transaction state first.
This is free processing.This program may shift or recover processing cost; compliance and customer disclosure matter.
Send the full card number.Please provide only the last four digits, date, amount, and auth/reference code.
Risk will release it.Risk will review once the required information is received.
C66
Email Reply Templates
Drafts an AI agent can adapt but should not overpromise
Missing deposit reply
Hi [Name],

I understand you're looking for the deposit from [date/batch].
To trace it accurately, please send:
- Expected deposit amount
- Batch date
- Merchant/location
- Any batch report or deposit screenshot available

We'll check settlement, funding, fees/refunds/chargebacks, bank rejects, and any risk notes before confirming the next step.
Decline reply
Hi [Name],

The decline message usually means the card issuer did not approve the transaction.
Please send the transaction date/time, amount, card brand, last four digits only, and exact decline message.

We'll verify whether this is isolated to one card/customer or affecting the terminal/account more broadly.
C67
30-Day Training Plan For A New Payments Support Agent
How to turn confusion into competence
1

Week 1: Vocabulary and maps

Transaction lifecycle, account IDs, receipt fields, common decline codes, batch/funding basics.

2

Week 2: Ticket patterns

Missing deposits, statement questions, terminal issues, refunds, chargebacks, descriptor confusion.

3

Week 3: Risk and escalation

Underwriting, holds, reserves, high-risk categories, documents, red flags, escalation notes.

4

Week 4: Systems thinking

Webhooks, CRM sync, accounting sync, subscription events, reconciliation, support QA.

C68
Support Glossary
Short definitions for fast triage
TermMeaning
Auth codeIssuer approval reference for an authorization.
BatchGroup of transactions submitted for settlement.
CaptureFinalizing an authorization for settlement.
DescriptorName/label on cardholder statement.
Entry typeHow card data entered the transaction: chip, tap, swipe, keyed, ecommerce.
MIDMerchant identifier.
TIDTerminal identifier.
ReserveFunds held to offset risk exposure.
RepresentmentMerchant response to fight a chargeback.
SettlementSubmitting captured transactions through clearing/funding process.
TokenizationReplacing sensitive card data with a reusable token.
AVSAddress Verification Service for card-not-present checks.
C69
AI Support Decision Tree
A safe first-pass flow for email support
if message contains missing deposit / funding:
  collect funding fields
  do not promise release date
  route to funding investigation

elif message contains declined / do not honor:
  collect transaction fields
  explain issuer ownership carefully
  check scope: one card vs many cards

elif message contains terminal not working:
  collect device/network/error fields
  ask scope questions
  route to hardware/device support

elif message contains fees / statement:
  request statement period
  classify fee categories
  route to statement review

elif message contains hold / reserve / frozen:
  acknowledge urgency
  collect documents requested
  route to risk escalation

elif message contains chargeback / dispute:
  collect deadline and evidence
  route to disputes

else:
  ask clarifying questions and classify after reply
C70
The Final Operating System
What this career becomes when turned into support intelligence

If this Grimoire becomes a future AI email support agent, the agent should not be trained to sound clever. It should be trained to do what good payment support does: classify the issue, collect safe identifiers, understand transaction state, avoid overpromising, protect sensitive data, explain ownership, route correctly, and leave the next human with a clean ticket.

The highest form of payment support is not having every answer. It is knowing which system owns the answer, what evidence proves it, and what not to promise before the money is traced.

That is the culmination: the career becomes a map, the map becomes a manual, and the manual becomes an operating system for helping merchants without making the system less safe.

Part XIV
Technical Survival Guide
POS, terminals, website payments, integrations, varsheets, webhooks, test mode, and go-live basics
C71 - C84
C71
Base Payment Architecture
The map before processor-specific instructions

Every processor has its own vocabulary, dashboard, credential format, SDK, and help article. Underneath that, most payment setups share the same base architecture: a customer-facing surface, a payment acceptance layer, a processor/gateway, an account identity, a notification layer, and a back-office reconciliation layer.

Universal payment architecture
Customer
  -> Payment surface
     (terminal, POS, website checkout, invoice link, mobile app)
  -> Payment acceptance layer
     (gateway, processor API, terminal SDK, hosted checkout)
  -> Processor / acquiring stack
  -> Card network / bank rails
  -> Authorization result
  -> Capture / settlement / funding
  -> Webhooks / reports / CRM / accounting
SURVIVE
When lost, ask: Where did the customer enter payment? Who created the transaction? Who processed it? Who received the event? Who records the order? Who reconciles the deposit?
C72
POS + Terminal Architecture
Countertop payments without pretending the terminal is the whole system

A POS + terminal setup has at least four layers: the POS software, the physical reader, the merchant account/processor configuration, and the network connecting the device to the payment rails. A failure in any layer can look like "the terminal is broken."

LayerWhat to verifyCommon failure
POSStore/location, register, user, product/tax/tip settingsSale created in POS but not sent correctly to terminal.
TerminalSerial number, TID, firmware, reader status, paired POSWrong terminal assigned to location or register.
NetworkWi-Fi/Ethernet/cellular, firewall, signal, router changesDevice cannot reach processor host.
Processor configMID, card types, batch close, debit/EBT/tips, surcharge/cash discountTransactions approve but batch or funding behaves unexpectedly.
Receipt/reportingReceipt fields, batch report, POS report, processor reportPOS total and processor total do not match.
Terminal setup vars
Merchant DBA:
Location:
MID:
Terminal ID:
Device serial number:
Processor:
Gateway, if any:
POS provider:
Connection type: Wi-Fi / Ethernet / Cellular
Batch close time:
Tip enabled? yes/no
Debit enabled? yes/no
Card brands enabled:
Receipt descriptor:
Support contact:
Escalation contact:
C73
Website + Payment Integration Architecture
Online checkout as a system of client, server, processor, and events

Online payment setup is not just "paste a payment button." A real website integration has a frontend, backend, payment provider, webhook receiver, order database, customer notifications, and reconciliation reports.

Basic website checkout flow
Customer clicks Pay
  -> Website frontend collects cart/order info
  -> Backend creates payment session / payment intent
  -> Provider returns client token / checkout URL
  -> Customer enters payment details securely
  -> Provider confirms authorization/payment state
  -> Webhook notifies backend of final event
  -> Backend marks order paid
  -> CRM / fulfillment / email / accounting update
RULE
The frontend should not be trusted as the final source of payment truth. Use provider-side status and webhooks to mark orders paid.
C74
Hosted Checkout vs Embedded Forms
The tradeoff noobs should understand before choosing
ApproachBest forTradeoff
Hosted checkoutFast, safer setup with provider-hosted payment pageLess control over UX, but lower implementation burden.
Embedded componentsCustom checkout experience using provider elements/SDKMore control, more frontend/backend responsibility.
Direct API collectionRare, advanced, tightly controlled environmentsHigh PCI/security burden. Avoid unless you know exactly why.
Invoice/payment linkManual or low-code collectionFastest path, less integrated order automation.

For beginners, hosted checkout or payment links are often the right first version. Custom embedded payment forms make sense when the business needs a controlled checkout flow and has technical support.

C75
The Payment Integration Varsheet
The sheet that prevents half of setup chaos

A varsheet is the implementation truth table. It lists the credentials, URLs, account IDs, environments, webhooks, contacts, and business rules needed to understand a payment setup. Without it, support becomes archaeology.

Varsheet template
Business / client:
Processor:
Gateway:
Platform / CMS:
Checkout type: hosted / embedded / invoice / terminal / POS

Environments:
- Test dashboard URL:
- Live dashboard URL:
- Test publishable key:
- Live publishable key:
- Secret key owner:
- Key storage location:

Account identity:
- Merchant ID:
- Location ID:
- Connected account ID:
- Terminal IDs:
- Descriptor:
- Bank account last four:

Webhook endpoints:
- Test webhook URL:
- Live webhook URL:
- Events subscribed:
- Signing secret storage:
- Retry policy:

Order system:
- Order database/table:
- Paid status field:
- Refund status field:
- CRM destination:
- Accounting destination:

Business rules:
- Capture timing:
- Refund policy:
- Subscription retry rules:
- Tax/shipping rules:
- Surcharge/cash discount rules:

Contacts:
- Merchant owner:
- Developer:
- Processor support:
- Risk/underwriting:
- Emergency escalation:
C76
API Keys, Environments, And Secret Hygiene
Test vs live is not a suggestion

Payment integrations usually have test and live environments. Mixing them causes classic noob failures: test cards in live mode, live keys on staging, webhooks pointed to the wrong server, or real customers paying into the wrong account.

ItemRule
Secret keysNever expose in frontend code, screenshots, emails, or docs.
Publishable/client keysCan be used client-side but still must match the correct environment.
Webhook signing secretsStore securely and verify signatures server-side.
Test modeUse provider test cards and test events before live payments.
Live modeRequires approved account, correct bank, correct descriptor, correct webhook URLs.
DO NOT
Do not paste secret keys into ChatGPT, Slack, ticket comments, screenshots, frontend JavaScript, or shared spreadsheets. Reference where they are stored, not the value.
C77
Webhooks: The Event Layer
Why checkout success pages are not enough

Webhooks are server-to-server notifications sent when payment events happen. They are how your system learns that a payment succeeded, failed, was refunded, disputed, or updated. A customer returning to the success page is helpful, but it is not reliable enough to be the only source of truth.

Event typeUse
payment succeededMark order paid, send receipt, fulfill product.
payment failedNotify customer, retry, create recovery task.
refund createdUpdate order and accounting records.
chargeback/dispute openedCreate support/disputes task and collect evidence.
subscription updated/canceledUpdate access, billing status, CRM lifecycle.
Webhook handling rule
1. Verify signature
2. Check event id for idempotency
3. Fetch/verify object if needed
4. Update internal state
5. Log outcome
6. Return success only after safe handling
C78
Test Mode And Sandbox Survival
How to break things before customers do
1

Test successful payment

Order becomes paid, receipt sends, CRM updates, fulfillment triggers.

2

Test failed payment

Order does not become paid, customer sees useful error, recovery path exists.

3

Test webhook retry

Duplicate events do not duplicate orders, emails, shipments, or CRM deals.

4

Test refund

Refund updates order, CRM, customer email, and accounting path.

5

Test abandoned checkout

No false paid status; optional recovery flow starts.

C79
Reconciliation Basics
The difference between sales, payouts, deposits, and accounting

Reconciliation is matching what the business thinks happened against what the processor funded and what the bank received. A website may show $10,000 in sales, the processor may show $9,650 after refunds/fees/reserves, and the bank may show deposits split across days.

Gross sales
Total transaction volume before fees, refunds, disputes, and adjustments.
Net sales
Sales after refunds or adjustments, depending on report.
Payout
Processor funding transfer to merchant bank.
Deposit
What appears in the bank account.
Variance
Difference that must be explained by fees, refunds, reserves, chargebacks, timing, or errors.
C80
CRM, Accounting, And Automation Integrations
Most payment problems happen after the payment succeeds

The payment event is only the start of the business workflow. The real setup must answer: who gets access, who gets notified, what deal updates, what invoice closes, what subscription changes, and what happens if the payment event arrives twice or late?

DestinationPayment event should doCommon bug
CRMCreate/update contact, deal, lifecycle stage, taskDuplicate contacts or deal not marked won.
Email/SMSReceipt, onboarding, failed payment, renewal reminderCustomer gets email before payment is confirmed.
AccountingInvoice paid, fee entry, refund entry, payout matchGross sales booked without fees/refunds.
FulfillmentShip order or unlock digital accessFulfillment triggers from success page instead of webhook.
SupportCreate task for failures, disputes, high-risk eventsNo one sees failed payments or disputes until customer complains.
C81
Go-Live Checklist
Before real customer money touches the system
[ ] Merchant account approved
[ ] Correct legal entity / DBA
[ ] Correct bank account last four verified
[ ] Descriptor reviewed
[ ] Live API keys installed server-side
[ ] Test keys removed from production
[ ] Webhook endpoint live and signature verified
[ ] Required webhook events subscribed
[ ] Successful payment tested live with small amount
[ ] Failed payment behavior tested
[ ] Refund path tested
[ ] Receipt email tested
[ ] Order status updates from webhook, not only frontend redirect
[ ] CRM/accounting/fulfillment sync tested
[ ] Duplicate webhook/idempotency behavior tested
[ ] Tax/shipping/tip/surcharge rules verified
[ ] Support team has varsheet and escalation contacts
[ ] Rollback plan exists
C82
Noob Mistakes That Break Payment Setups
The pain list
MistakeConsequenceFix
Using frontend success page as payment truthOrders marked paid when payment is incompleteUse webhooks/provider status.
Mixing test and live keysPayments fail or go to wrong environmentMaintain varsheet and environment labels.
No idempotencyDuplicate orders, emails, shipments, CRM dealsStore event IDs and transaction IDs.
No descriptor reviewCustomers dispute unfamiliar chargesSet clear descriptor and receipt branding.
No refund workflowAccounting/CRM/customer records driftHandle refund events downstream.
No reconciliation planMerchant cannot explain depositsMatch sales, payouts, fees, refunds, bank deposits.
Secrets in shared docsSecurity incident riskUse secure secret storage.
C83
Payment Integration Support Ticket Template
For website/POS/gateway setup issues
Integration issue:
Merchant / client:
Environment: test / live
Processor / gateway:
Platform / CMS / POS:
Checkout type:

Observed behavior:
Expected behavior:
First affected date/time:
Customer-facing error:
Dashboard error:

Transaction details, if any:
- Date/time:
- Amount:
- Transaction ID:
- Auth code:
- Last four only:

Technical details:
- API key environment confirmed? yes/no
- Webhook endpoint:
- Webhook event ID:
- Webhook delivery status:
- Order ID:
- CRM/accounting record ID:
- Terminal ID, if card-present:

What changed recently:
Screenshots/logs attached:
Escalation needed from:
C84
What The Future AI Agent Should Know About Integrations
The safe boundary between helpful and dangerous

An AI support agent can triage integration tickets, ask for missing identifiers, classify likely failure layers, draft replies, and assemble escalation notes. It should not request secrets, modify live keys, disable webhooks, change bank accounts, alter descriptors, or tell a merchant to reprocess payments without human approval.

Agent can do
Classify issue, collect safe fields, explain architecture, draft troubleshooting steps, create escalation summary.
Agent must not do
Handle raw card data, store secrets, promise funding, approve risk releases, change payment settings without authorization.
Agent should ask
Which environment, which processor, which transaction ID, which webhook event, which order ID, what changed recently?
Processor docs teach the buttons. The base architecture teaches survival.
Part XV
Extended Payment Types & Admin Know-How
ACH, 3DS, international rails, MATCH/TMF, and the integration stack — the knowledge that separates admin from operator
C85 - C89
C85
ACH & eCheck
Bank-to-bank payments — lower cost, slower clock, different risk profile

ACH (Automated Clearing House) and eCheck are both bank-to-bank payment methods. They bypass card networks entirely, which is why their fees are significantly lower. The tradeoff: settlement is slower (1–3 business days vs same/next day for cards) and disputes — called returns in ACH language — work differently.

ACH
Electronic bank-to-bank transfer through the ACH network. Used for recurring billing, payroll, invoices, B2B payments. Customer provides routing and account number. Funds move in batches, not real-time.
eCheck
Electronic version of a paper check. Converts check information into an electronic transaction. Faster than mailing a check, more secure than paper, same underlying ACH rails.
Key difference
ACH is initiated electronically from the start. eCheck starts as a check (physical or digital) and converts to electronic. Both clear through ACH rails. The distinction is mostly in how the payment was initiated.
Credit/Debit CardACH / eCheck
Fees2–4% per transactionFlat fee, typically $0.25–$1.50
SettlementSame day or next day1–3 business days
DisputesChargebacks (60–120 day window)Returns (shorter window, different rules)
Best forRetail, ecommerce, in-personB2B, high-ticket, recurring, invoicing

When to use ACH/eCheck over cards:

  • High-ticket B2B transactions (a $50,000 invoice on a card costs $1,500+ in fees; on ACH, a few dollars)
  • Recurring monthly charges where card-on-file has expiration risk
  • Customers or clients who prefer not to use credit cards
  • Industries where card acceptance is restricted or high-risk
RISK
ACH returns carry similar financial consequences to chargebacks. R01 (insufficient funds), R02 (account closed), R10 (unauthorized) are the most common return codes. High return rates get accounts flagged or terminated the same way high chargeback rates do.
C86
3D Secure (3DS)
The authentication layer that shifts chargeback liability from merchant to issuing bank

3D Secure is a payment authentication protocol that adds an identity verification step to online transactions. The "3D" refers to the three parties involved: the merchant's acquiring bank, the customer's issuing bank, and the card network. When authentication completes successfully, a critical legal shift occurs: liability for fraudulent chargebacks moves from the merchant to the cardholder's issuing bank.

This is not just a security feature. It is a financial protection mechanism.

1

Customer enters payment details

Standard checkout: card number, expiry, CVV. Hosted payment page, invoice, shopping cart.

2

Risk check runs in the background

3DS evaluates the transaction: device, IP, behavior, purchase history. Most legitimate transactions pass silently — no friction for the customer.

3

Challenge triggered if needed

High-risk transactions prompt the customer to verify: SMS code, biometric, temporary PIN. Most customers only see this for flagged transactions.

4

Issuing bank authenticates

The customer's bank confirms identity and sends authentication data back through the network.

5

Transaction approved — liability shifted

Once authenticated: any subsequent fraud chargeback is the issuing bank's problem, not the merchant's. Merchant is protected.

KEY INSIGHT
The liability shift is the whole point. Without 3DS, a fraudulent online transaction results in the merchant losing both the goods and the payment (plus a chargeback fee). With 3DS authentication completed, the merchant wins the chargeback automatically because the issuing bank authenticated the transaction. Fewer chargebacks = lower chargeback ratio = better processing terms.

Where 3DS is legally required: Europe under PSD2 / Strong Customer Authentication (SCA). Merchants selling to European customers without 3DS are out of compliance.

Who benefits most: eCommerce merchants with high CNP fraud exposure, subscription businesses, online gaming, hospitality, charter/airline, digital services, any merchant with a chargeback problem.

ADMIN
3DS requires integration between the gateway and a 3DS provider. This is not automatic — it must be enabled and tested. Confirm with the processor which provider is in the stack before promising merchants liability protection.
C87
International Payment Processing
Why domestic-only routing fails global merchants — and what regional acquiring actually means

A merchant selling to international customers through a domestic-only payment setup will see higher decline rates than they should. The reason: when a card issued in Germany is processed through a US-only acquiring bank, the transaction looks suspicious to the German issuing bank. Regional routing — processing through a local acquiring entity — fixes this.

What it is
Routing transactions through acquiring banks in the same region as the customer's card issuer. A UK customer's card processed through a UK acquiring entity gets better approval rates than through a Florida bank.
Countries
Specialized providers cover 60–70+ countries. Key regions: US, UK, EU (Netherlands, Lithuania entities), Australia, Canada, Hong Kong, Singapore, Japan, New Zealand, Malaysia, Brazil, Israel.
Currencies
130+ currencies typically supported. Settlement in USD or local currency depending on the bank relationship and merchant preference.
Volume requirements
Some international acquiring solutions require minimum monthly processing volume. Varies by bank, industry, and risk level.
Non-US businesses
A foreign business can sometimes qualify for a US merchant account depending on country of registration, business model, and processing history.

When a merchant needs international processing:

  • Selling products or services to customers in other countries
  • Experiencing abnormally high decline rates from international cards
  • Running a global subscription with customers across time zones
  • Digital services, travel, charter, cross-border B2B
ADMIN
Multi-currency processing and settlement are different features. A merchant can accept payments in EUR while settling in USD — the conversion happens at the acquiring bank level. Clarify settlement currency upfront. FX conversion fees apply and vary by processor and bank.
C88
MATCH / TMF
The industry blacklist — what it is, how merchants end up there, and what getting off actually looks like

MATCH (Mastercard Alert to Control High-Risk Merchants) and TMF (Terminated Merchant File — Visa's equivalent) are shared industry databases maintained by card networks. When a processor terminates a merchant for cause, they are required to report them. Any acquiring bank that checks MATCH/TMF before approving a new merchant account will see the listing and typically decline.

Being on MATCH/TMF is effectively an industry blacklist for standard processing. Options narrow significantly — but they do not disappear entirely.

Common reasons for MATCH/TMF listing:

  • Excessive chargebacks (above network thresholds — typically 1% for Mastercard, 0.9% for Visa's standard program)
  • Fraud or processing fraudulent transactions
  • Violation of card network rules (surcharge violations, prohibited transaction types)
  • PCI non-compliance resulting in a data breach
  • Money laundering or illegal transactions
  • Merchant identity misrepresentation
How long listed
5 years from the termination date. After 5 years, the listing expires. Early removal requires the reporting processor to submit a removal request — which they rarely do willingly.
Standard processors
Will decline a MATCH/TMF merchant on application review. Non-negotiable for most tier-1 processors and banks.
Specialized processors
High-risk specialists with specific bank relationships can place MATCH/TMF merchants. Rates will be higher, underwriting more intensive, volume limits may apply.
Dispute a listing
Merchants can dispute inaccurate MATCH listings with Mastercard directly. Requires documentation that the listing was incorrect or the reason code was misapplied.
A merchant who doesn't disclose their MATCH/TMF status on a new application is committing misrepresentation — which is itself a MATCH-able offense. The ones who come in honestly, explain what happened, and show what changed get placed eventually. The ones who try to hide it get terminated again when underwriting catches it.
APRIL 2026
The peptide research product industry saw expanded MATCH/TMF merchant placement availability in April 2026 as specialized processors expanded their bank relationships to serve this category. This is an example of how niche high-risk markets open as bank relationships develop.
C89
The Integration Stack
How accounting, CRM, ecommerce, POS, and gateways connect — and why it matters for an admin

A payment by itself is a transaction. A payment inside an integrated stack is a business event that updates multiple systems simultaneously. The difference between a merchant who fights with their data every month and one who runs clean is almost always integration depth — how well their payment layer talks to everything else.

The four integration layers:

Accounting

QuickBooks, Xero, Wave, FreshBooks

Payment data flows to the accounting system. Invoices auto-mark paid. Revenue categorized. Reconciliation is automatic, not manual. Real impact: a QuickBooks-integrated merchant saves 20+ hours/month of manual data entry and around $15K/year in labor.

CRM

Salesforce, HubSpot, HighLevel, Zoho

Payment events update deal stages, customer records, renewal dates, and support history. A paid invoice closes a CRM opportunity. A failed payment creates a follow-up task. Without this, CRM data drifts from payment reality.

eCommerce

Shopify, WooCommerce, BigCommerce, Magento

Gateway connects to the storefront checkout. Payment status triggers order fulfillment, access grants, email confirmations, inventory adjustments. The gateway is the connector — wrong gateway means broken checkout.

EMR / ERP / Vertical

Medical, dental, vet, auto, construction

Healthcare: Dentrix, Chirotouch, DrChrono, WebPT. Auto: Shopmonkey, Tekmetric. Construction: Viewpoint Vista. Payments inside vertical systems serve compliance and workflow — the payment data needs to match the patient record or work order.

The admin's job in the integration stack:

  • Know which gateway is in use before touching any integration setting
  • Never change API keys or webhook endpoints without checking what depends on them
  • Understand that a failed integration is often reported as a payment problem — the actual issue is downstream
  • Document the full stack: gateway + processor + POS + accounting + CRM + ecommerce platform for every merchant
  • Test payment events through the full chain: payment success should trigger all downstream updates, not just confirm on the gateway dashboard
OPERATOR LENS
The difference between "I process payments" and "I run a payment operation" is integration depth. An operator knows that the Authorize.net key change at 11am broke the QuickBooks sync, which is why the deposit from last Thursday still shows as open in accounting. Following money through the stack — not just confirming it cleared the gateway — is the skill that makes an ops person indispensable.
A payment that cleared but didn't update the CRM, the inventory, and the accounting system is not a successful transaction. It is a problem that hasn't been discovered yet.
Reference
Cited References And Recommended Reading
SRC
Sources
Primary references for payment fundamentals and infrastructure
01
Stripe documentation - PaymentIntents and the modern API model for tracking payment lifecycle state.
open
02
Stripe documentation - Webhooks and event-driven payment integrations.
open
03
PCI Security Standards Council - PCI DSS overview and payment data security standards.
open
04
Visa merchant and small business resources - card acceptance concepts and network role.
open
05
Mastercard merchant resources - payment acceptance, safety, and business resources.
open
06
Stripe Terminal documentation - reader connection, in-person payments, and terminal integration concepts.
open
07
Stripe testing documentation - test cards, sandbox behavior, and integration validation before go-live.
open
Related Grimoires
010
The Orchestration Layer
Delegation, memory, governance — AI revolution is a coordination problem.
011
Organizational Physics
28 case files, 143 laws — why organizations keep failing the same way.
001
ASMC Full Stack CRM Engine
Full GHL CRM buildout for construction — 76 custom fields, 24 Zaps, QA-verified.