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.
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.
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.
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.
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.
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?"
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.
| State | Meaning | Support translation |
|---|---|---|
| Authorization | Issuer approved the transaction request. | The cardholder can buy; funds may be held. |
| Capture | Merchant finalizes the transaction for clearing. | The sale is ready to be included in settlement. |
| Settlement | Transactions are submitted through the processing/network/bank chain. | The batch is being reconciled between parties. |
| Funding | Merchant 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.
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.
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.
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.
Route messages
Move transaction data between merchant systems, networks, and banks.
Settle batches
Help turn approved transactions into clearing and funding records.
Report activity
Statements, deposits, fees, chargebacks, and transaction history.
Monitor risk
Spot unusual volume, fraud patterns, and merchant behavior changes.
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.
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.
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."
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.
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.
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.
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.
| Recipient | Why they get paid |
|---|---|
| Issuing bank | Takes credit/fraud exposure and receives interchange. |
| Card network | Runs the network rules and rails, receives assessments/network fees. |
| Processor/provider | Routes, reports, supports, funds, monitors, and maintains infrastructure. |
| Agent/ISO | May receive residuals for sales and relationship management. |
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.
Find volume
Total card sales processed for the statement period.
Find total fees
All processing and monthly charges combined.
Calculate effective rate
Total fees divided by total volume. This is a blunt but useful starting point.
Separate pass-through from markup
Interchange and assessments are not the same as provider profit.
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.
| Rule | Detail |
|---|---|
| Maximum surcharge | 3% in most states. Card brand max: Mastercard 4%, Visa 3% — processors enforce 3% at POS for compliance uniformity. |
| Debit/prepaid | Cannot be surcharged. Federal law. No exceptions. |
| Card brand uniformity | Same surcharge rate must apply across all card brands — cannot charge more for Amex than Visa. |
| Signage required | Sign at entrance AND at checkout/POS. Not optional. |
| Receipt disclosure | Surcharge must appear as a separate line item on the receipt. |
| Refunds | If you refund the purchase, you refund the surcharge too. |
| State status | Jurisdictions |
|---|---|
| Banned | Connecticut, Massachusetts, Puerto Rico |
| Capped at 2% | Colorado, Oklahoma |
| Allowed with local rules | California, Florida, Kansas, Maine, New York, Texas |
| Generally allowed (3% cap) | Most other states |
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.
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.
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.
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.
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.
"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):
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
Sign Up -> Take Payments
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.
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.
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.
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)
| Industry | Why flagged |
|---|---|
| CBD, Cannabis, Vape, Tobacco | Regulatory ambiguity, age verification requirements, bank reputational risk |
| Adult businesses | Reputational risk, chargeback exposure |
| Nutraceuticals / supplements | Trial-offer chargeback history across the industry |
| Credit repair / MLM | FTC regulation, refund and dispute rates |
| Drop shipping | Fulfillment liability when supplier fails |
| Medical billing | Insurance complexity, delayed payment cycles, high ticket |
| Jet / Charter / Travel | High-ticket, advance deposits, future delivery risk |
| Firearms dealers (FFL) | Card network pressure, processor list shrinking |
| Bail bonds, pawn shops | Regulatory, 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.
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.
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:
Hardware categories:
Fixed desk unit
Ingenico Desk 1500, Verifone, PAX. Wired connection, sits at register. Most common in traditional retail.
Mobile terminal
Clover Flex, Ingenico AXIUM. Battery-powered, Wi-Fi or cellular. Used tableside, in warehouses, at pop-ups.
Phone/tablet attachment
Clover Go, SwipeSimple. Bluetooth or audio jack. Works with a smartphone app. Field reps, service businesses.
Customer-facing input
Separate from the merchant display. Customer enters PIN or signs directly. Used in retail where merchant and customer displays are split.
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:
Other POS systems by use case:
LightSpeed, coreSTORE
Inventory management for high-SKU retail. coreSTORE built for independent retailers and FFL dealers (firearms licensing).
Toast, Union POS, MYR
Table management, ticket routing, tip handling. Toast is cloud-native. Clover also serves restaurants with the right app configuration.
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.
ConnectPOS
Bridges online stores (Shopify, Magento) with physical locations. One inventory, one order history, across both channels.
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:
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).
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.
Identify the transaction or batch
Date, amount, last four, authorization code, batch number, location, terminal/POS, and merchant ID.
Check state
Authorized, captured, voided, refunded, settled, rejected, held, charged back, or funded.
Check batch timing
Was the batch closed? Was it after cutoff? Was there a weekend or holiday?
Check bank account
Was funding sent to the expected bank account? Any recent bank changes?
Check risk notes
Any hold, reserve, review, rejected batch, negative balance, or documentation request?
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 type | Likely owner | Support answer |
|---|---|---|
| Insufficient funds | Issuer/cardholder | Use another payment method or contact bank. |
| Do Not Honor | Issuer | Cardholder must contact bank; reason may not be disclosed. |
| AVS/CVV mismatch | Gateway/fraud rules | Verify billing info or adjust fraud settings if appropriate. |
| Card type not accepted | Merchant account setup | Check acceptance settings and card brand permissions. |
| Terminal communication failure | Device/network | Troubleshoot connectivity before blaming the card. |
Power
Is the device on, charged, plugged in, and booted correctly?
Network
Wi-Fi, Ethernet, cellular, IP settings, signal strength, router changes.
Scope
One terminal, all terminals, one location, all locations, one card type, all cards?
Error
Exact message, screenshot, receipt, time, transaction amount, firmware/app version.
Fallback
Can merchant use another terminal, virtual terminal, invoice link, or offline process if allowed?
| Issue | First team | Escalate to |
|---|---|---|
| Statement confusion | Support/agent | Pricing or account manager |
| Missing deposit | Support | Processor/funding/risk |
| Risk hold | Support documents | Risk/underwriting |
| Issuer decline | Support explains | Cardholder's bank, not merchant processor |
| Terminal hardware failure | Support troubleshooting | Device vendor/deployment team |
| Chargeback | Support intake | Disputes team |
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?
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.
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_intent.succeeded -> mark invoice paid -> update CRM deal -> send receipt -> grant product access -> notify fulfillment -> update revenue dashboard
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.
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
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.
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.
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.
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 asks | Weak answer | Better 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. |
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.
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.
Dispute arrives
Reason code, transaction, deadline, amount, cardholder claim.
Merchant gathers evidence
Receipt, invoice, signed agreement, delivery proof, refund policy, communication logs.
Representment
Merchant or provider submits evidence to fight the dispute.
Decision
Issuer/network process determines whether funds stay reversed or return.
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.
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.
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 field | What it means | Support use |
|---|---|---|
| Merchant name/location | Business identity printed on receipt | Confirms merchant/location, may differ from descriptor. |
| Date/time | Transaction timestamp | Compare with batch cutoff and funding date. |
| Amount | Sale, tip, tax, total | Match transaction records and deposits. |
| Card brand | Visa, Mastercard, Amex, Discover, etc. | Useful for card-type restrictions and fee questions. |
| Masked card number | Usually last four digits | Helps locate transaction without exposing full PAN. |
| Entry method | Chip, tap, swipe, keyed, ecommerce | Impacts risk, liability, and fees. |
| Auth code | Issuer approval reference | Proof that authorization happened, not proof of funding. |
| Reference / trace / transaction ID | Processor or terminal identifier | Key for searching processor records. |
| Batch number | Batch grouping identifier | Useful for settlement/funding investigation. |
| AID / TVR / TSI | EMV technical fields | Device/card diagnostics for advanced cases. |
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.
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.
Verify original approval
Receipt, auth code, date, amount, last four, processor record.
Check current state
Authorized only, captured, settled, voided, failed, duplicate, or missing.
Prevent duplicate billing
Never rekey blindly. Confirm whether the cardholder was already charged or held.
Document
Record who approved, why it was rekeyed, original auth, and final transaction ID.
| Entry type | Meaning | Support significance |
|---|---|---|
| Chip / EMV | Card inserted into chip reader | Lower counterfeit risk, card-present evidence. |
| Tap / NFC | Contactless card or wallet | Card-present, tokenized wallet may show device account number. |
| Swipe | Magstripe read | Higher counterfeit risk than EMV; fallback matters. |
| Keyed | Card manually entered | Higher risk and usually higher cost; AVS/CVV important. |
| Ecommerce | Online checkout | Card-not-present; fraud tools and descriptor clarity matter. |
| MOTO | Mail order / telephone order | Card-not-present; documentation and authorization practices matter. |
| Recurring | Stored credential/subscription | Requires consent, proper indicators, retry and cancellation handling. |
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.
| Model | How it feels | Support explanation |
|---|---|---|
| Flat rate | Simple percentage | Easy to understand, may be more expensive for some card mixes. |
| Interchange-plus | Pass-through plus markup | More transparent, but statements look more complex. |
| Tiered | Qualified/mid/non-qualified buckets | Often confusing; downgrades can frustrate merchants. |
| Subscription/membership | Monthly fee plus lower markup | Can 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.
| Flag | Why it matters | Ask for |
|---|---|---|
| Sudden volume spike | Exposure exceeds expected processing | Invoices, fulfillment proof, campaign explanation. |
| High ticket increase | Larger chargeback exposure | Contracts, delivery terms, customer communication. |
| Many refunds | Possible dissatisfaction or operational issue | Refund reasons and product/service changes. |
| New business model | Underwriting mismatch | Updated website, offer, terms, and processing forecast. |
| Chargeback cluster | Account stability risk | Evidence packets, customer communication, prevention plan. |
| Bank account change | Fraud and funding risk | Verified ownership and authorization. |
| Model | What it is | Support implication |
|---|---|---|
| Traditional merchant account | Merchant has a direct-ish acquiring relationship through provider stack. | More underwriting, more control, more statement complexity. |
| Payment facilitator | Platform onboards sub-merchants under its master processing setup. | Fast onboarding, centralized risk, platform-controlled experience. |
| ISO/MSP | Sales/service organization resells or manages merchant services. | Relationship layer may own merchant communication. |
| Stripe/Square-style | Developer/platform-first or aggregated processing experience. | Fast start, policy-driven holds, API/event support. |
| Embedded payments | Payments built into software platforms. | Merchant may think the software company is the processor. |
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.
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.
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.
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
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?
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:
| Intent | Signals | Route |
|---|---|---|
| Missing deposit | Where is my money, deposit missing, batch funded, bank account | Funding investigation |
| Fee question | Statement, rates, fees, expensive, PCI, monthly charge | Statement review |
| Decline | Do Not Honor, declined, won't go through, card rejected | Decline troubleshooting |
| Hardware | Terminal down, reader not working, error screen, printer | Device support |
| Risk/hold | Funds held, reserve, account frozen, documents requested | Risk escalation |
| Chargeback | Dispute, retrieval, representment, evidence, chargeback | Disputes queue |
| Descriptor | Customer doesn't recognize charge, statement name | Descriptor review |
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
| Never say | Say 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. |
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.
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.
Week 1: Vocabulary and maps
Transaction lifecycle, account IDs, receipt fields, common decline codes, batch/funding basics.
Week 2: Ticket patterns
Missing deposits, statement questions, terminal issues, refunds, chargebacks, descriptor confusion.
Week 3: Risk and escalation
Underwriting, holds, reserves, high-risk categories, documents, red flags, escalation notes.
Week 4: Systems thinking
Webhooks, CRM sync, accounting sync, subscription events, reconciliation, support QA.
| Term | Meaning |
|---|---|
| Auth code | Issuer approval reference for an authorization. |
| Batch | Group of transactions submitted for settlement. |
| Capture | Finalizing an authorization for settlement. |
| Descriptor | Name/label on cardholder statement. |
| Entry type | How card data entered the transaction: chip, tap, swipe, keyed, ecommerce. |
| MID | Merchant identifier. |
| TID | Terminal identifier. |
| Reserve | Funds held to offset risk exposure. |
| Representment | Merchant response to fight a chargeback. |
| Settlement | Submitting captured transactions through clearing/funding process. |
| Tokenization | Replacing sensitive card data with a reusable token. |
| AVS | Address Verification Service for card-not-present checks. |
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
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.
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.
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.
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 / accountingA 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."
| Layer | What to verify | Common failure |
|---|---|---|
| POS | Store/location, register, user, product/tax/tip settings | Sale created in POS but not sent correctly to terminal. |
| Terminal | Serial number, TID, firmware, reader status, paired POS | Wrong terminal assigned to location or register. |
| Network | Wi-Fi/Ethernet/cellular, firewall, signal, router changes | Device cannot reach processor host. |
| Processor config | MID, card types, batch close, debit/EBT/tips, surcharge/cash discount | Transactions approve but batch or funding behaves unexpectedly. |
| Receipt/reporting | Receipt fields, batch report, POS report, processor report | POS total and processor total do not match. |
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:
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.
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
| Approach | Best for | Tradeoff |
|---|---|---|
| Hosted checkout | Fast, safer setup with provider-hosted payment page | Less control over UX, but lower implementation burden. |
| Embedded components | Custom checkout experience using provider elements/SDK | More control, more frontend/backend responsibility. |
| Direct API collection | Rare, advanced, tightly controlled environments | High PCI/security burden. Avoid unless you know exactly why. |
| Invoice/payment link | Manual or low-code collection | Fastest 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.
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.
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:
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.
| Item | Rule |
|---|---|
| Secret keys | Never expose in frontend code, screenshots, emails, or docs. |
| Publishable/client keys | Can be used client-side but still must match the correct environment. |
| Webhook signing secrets | Store securely and verify signatures server-side. |
| Test mode | Use provider test cards and test events before live payments. |
| Live mode | Requires approved account, correct bank, correct descriptor, correct webhook URLs. |
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 type | Use |
|---|---|
| payment succeeded | Mark order paid, send receipt, fulfill product. |
| payment failed | Notify customer, retry, create recovery task. |
| refund created | Update order and accounting records. |
| chargeback/dispute opened | Create support/disputes task and collect evidence. |
| subscription updated/canceled | Update access, billing status, CRM lifecycle. |
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
Test successful payment
Order becomes paid, receipt sends, CRM updates, fulfillment triggers.
Test failed payment
Order does not become paid, customer sees useful error, recovery path exists.
Test webhook retry
Duplicate events do not duplicate orders, emails, shipments, or CRM deals.
Test refund
Refund updates order, CRM, customer email, and accounting path.
Test abandoned checkout
No false paid status; optional recovery flow starts.
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.
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?
| Destination | Payment event should do | Common bug |
|---|---|---|
| CRM | Create/update contact, deal, lifecycle stage, task | Duplicate contacts or deal not marked won. |
| Email/SMS | Receipt, onboarding, failed payment, renewal reminder | Customer gets email before payment is confirmed. |
| Accounting | Invoice paid, fee entry, refund entry, payout match | Gross sales booked without fees/refunds. |
| Fulfillment | Ship order or unlock digital access | Fulfillment triggers from success page instead of webhook. |
| Support | Create task for failures, disputes, high-risk events | No one sees failed payments or disputes until customer complains. |
[ ] 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
| Mistake | Consequence | Fix |
|---|---|---|
| Using frontend success page as payment truth | Orders marked paid when payment is incomplete | Use webhooks/provider status. |
| Mixing test and live keys | Payments fail or go to wrong environment | Maintain varsheet and environment labels. |
| No idempotency | Duplicate orders, emails, shipments, CRM deals | Store event IDs and transaction IDs. |
| No descriptor review | Customers dispute unfamiliar charges | Set clear descriptor and receipt branding. |
| No refund workflow | Accounting/CRM/customer records drift | Handle refund events downstream. |
| No reconciliation plan | Merchant cannot explain deposits | Match sales, payouts, fees, refunds, bank deposits. |
| Secrets in shared docs | Security incident risk | Use secure secret storage. |
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:
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.
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.
| Credit/Debit Card | ACH / eCheck | |
|---|---|---|
| Fees | 2–4% per transaction | Flat fee, typically $0.25–$1.50 |
| Settlement | Same day or next day | 1–3 business days |
| Disputes | Chargebacks (60–120 day window) | Returns (shorter window, different rules) |
| Best for | Retail, ecommerce, in-person | B2B, 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
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.
Customer enters payment details
Standard checkout: card number, expiry, CVV. Hosted payment page, invoice, shopping cart.
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.
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.
Issuing bank authenticates
The customer's bank confirms identity and sends authentication data back through the network.
Transaction approved — liability shifted
Once authenticated: any subsequent fraud chargeback is the issuing bank's problem, not the merchant's. Merchant is protected.
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.
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.
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
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
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:
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.
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.
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.
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