Skip to content
syntaqx

Books44 chapters12 h 13 min read

Payments

The playbook's Money section is about handling money correctly anywhere: amounts, state machines and ledgers. This book is about the industry those systems plug into. Card networks, banks, processors and regulators each set rules, and almost every hard problem in a payments platform is one of them doing exactly what it's supposed to.

It reads in seven parts, ending with a glossary: how money moves, the rules, taking payments, paying out, issuing cards, and running a provider.

How Money Moves

  1. 01How Card Payments WorkThe parties behind a card payment, why authorization, capture, clearing, settlement and funding are separate events, and the ISO 8583 underneath it all.17 min
  2. 02The Payments LandscapeWho's who in payments: networks, acquirers, processors, PSPs, embedded payments, bank rails, orchestration, vaults, fraud, wallets, recent moves, build vs buy.19 min
  3. 03Card-Present PaymentsHow in-person card payments work: EMV chip cryptograms, cardholder verification, contactless, Tap to Pay, terminals, P2PE, and the risk of going offline.11 min
  4. 04Interchange & PricingWhat a card payment costs and why: interchange, regulated debit, network fees, downgrades, Level 3 data, pricing models, and how platforms earn on payments.12 min
  5. 05ACH & Bank TransfersHow ACH really moves money: SEC codes and files, why settled isn't final, returns, reversals and fees, validating accounts, the Nacha rules, RTP and FedNow.20 min
  6. 06Accepting ChecksTaking checks as payment: image clearing under Check 21, remote deposit capture, Reg CC holds, returns and late claims, conversion to ACH, lockbox and fraud.15 min
  7. 07Cash PaymentsLetting customers pay in cash: retail bill-pay networks, real-time validation and posting, money orders, money transmitter rules, BSA reporting and vouchers.8 min
  8. 08Wallets & Local Payment MethodsApple Pay and Google Pay as network tokens, PayPal, BNPL, and the bank rails other countries pay with: SEPA, iDEAL and Wero, Pix, UPI and UK pay-by-bank.8 min
  9. 09Stablecoins & Crypto RailsPayment stablecoins for a provider: issuers and reserves, the GENIUS Act and MiCA, network settlement, pay-ins, payouts, screening, finality and the ledger.25 min
  10. 10Cross-Border Payments & FXPresentment, settlement and funding currencies, cross-border card fees, local acquiring, DCC rules, FX quotes, wires and correspondents, and FX on refunds.18 min
  11. 11Comparing the RailsEvery way money moves, side by side: who starts it, when you know it worked, when it settles, when it's final, how it comes back, and which accounts it crosses.5 min

The Rules

  1. 12The Payments RulebookHow payments rules fit together: network contracts like PCI DSS and Nacha, the laws behind them, who enforces each, and which apply from merchant to provider.11 min
  2. 13Surcharging & FeesPassing card costs to the payer: surcharges, convenience and service fees, cash discounts, the network caps and state laws behind them, and safe fee math.10 min
  3. 14Payments in CanadaExtending a US payments platform to Canada: ACSS and Standard 005 files, pre-authorized debits under Rule H1, Interac, card rules, RPAA and FINTRAC.12 min
  4. 15Payments in the EU & UKEurope for a US platform: interchange caps, SEPA and SEPA Instant, direct debits, Faster Payments, Bacs, CHAPS, payee checks, APP fraud and licensing.15 min

Taking Payments

  1. 16Merchant OnboardingKnowing who processes payments on a platform: KYC and KYB, a verification state machine, progressive onboarding, underwriting, and an API that says what's due.16 min
  2. 17Designing the Payments APIThe surface merchants integrate with: payment objects and intents, modifications, keys and the client, test mode, versioning, errors, events and platforms.12 min
  3. 18Checkout, Invoices & Payment LinksHosted pages, payment links, invoices, payer portals and virtual terminals: PCI scope, the invoice lifecycle, applying payments, and B2B receivables.24 min
  4. 19Strong Customer Authentication & 3-D SecureWhen a card payment needs the cardholder to authenticate, the exemptions that skip it, 3RI and delegation, the liability shift, and mandates beyond the EU.11 min
  5. 20Stored Cards & Recurring BillingSaving a card and charging it later: the stored credential framework, network transaction IDs, network tokens, account updater, retry rules and dunning.12 min
  6. 21Phone PaymentsTaking payments by phone and by link: MOTO and TEL rules, telephony in PCI scope, DTMF masking, text-to-pay, recordings, IVR design, remote agents.13 min
  7. 22Fraud & RiskDeciding which payments to allow, review, challenge or block: both costs, network and consortium signals, card testing, merchant and bank-rail fraud.13 min
  8. 23Disputes & ChargebacksHow a dispute moves from inquiry to arbitration, what it does to the ledger, the monitoring thresholds that end merchant accounts, and who pays on a platform.11 min

Paying Out

  1. 24Payouts & SettlementHow a card payment becomes money in a merchant's bank: settlement timing, fees as ledger entries, payout schedules and reserves, failures, and reconciliation.14 min
  2. 25Treasury & Bank OperationsThe bank accounts behind a payments ledger: FBO accounts, pass-through insurance, funding, bank files, the banking calendar and reconciliation.14 min
  3. 26Ledger & Reconciliation at Provider ScaleA provider's chart of accounts, the three-way match of ledger, settlement files and bank statements, matching engines, breaks, suspense and the close.19 min
  4. 27Vendor PayoutsPaying vendors and suppliers: ACH, virtual cards, push to card, checks and instant rails, enablement, stopping redirect fraud, funding, 1099s.24 min

Issuing Cards

  1. 28Card IssuingLaunching a card program: sponsor banks, program managers and issuer processors, prepaid, debit and credit law, the economics, card lifecycle and wallet tokens.35 min
  2. 29Issuer ProcessingThe issuer's side of a card payment: the authorization decision and its webhook, spend controls, holds and clearing, fraud, and disputes under Reg E and Z.24 min

Running a Provider

  1. 30Payments for Software PlatformsEmbedded payments for vertical software: payfac models, the tenant tree, fee overrides at scale, wrong fees and their fixes, fund splits, 1099-K and support.30 min
  2. 31Partners, ISOs & ResidualsSelling through ISOs, agents, software platforms and banks: network registration, buy rates and splits, clawbacks, and a residual engine partners can audit.26 min
  3. 32Payments by VerticalWhat changes by industry: healthcare, government, schools, nonprofits, utilities, B2B, gyms and restaurants, with their codes, programs, laws and features.30 min
  4. 33Processor RoutingRunning payments over several processors: orchestration, routing by card and cost, US debit, safe failover, cascading within retry rules, and tokens.13 min
  5. 34Switching ProcessorsMoving to a new processor: contracts, card and bank mandate migration, network tokens, recurring and dunning state, cohort cutover, declines and an exit plan.19 min
  6. 35Running a Card VaultBuilding the one service that holds card numbers: token design, envelope encryption, who may detokenize, capture iframes, BIN data and the CDE around it.15 min
  7. 36HSMs & Key ManagementPayments cryptography as its own discipline: HSMs, key hierarchies, key blocks, DUKPT and PIN blocks, the move off TDES, key ceremonies and cryptoperiods.11 min
  8. 37Inside a ProcessorWhat an acquiring processor runs: the authorization switch, network connections, stand-in, clearing files, settlement, exceptions, merchant setup and billing.10 min
  9. 38Network CertificationGoing live and staying live on card networks: processor and host certification, EMV levels, 3DS approval, and the twice-yearly network release calendar.8 min
  10. 39Payments Architecture at ScaleRunning payments at millions a day: service boundaries, idempotency end to end, outbox and sagas, hot ledger accounts, multi-region, peaks and safe change.25 min
  11. 40Operating the PlatformRunning a payments platform day to day: the internal console, monitoring, statements, compliance, outages, card-data incidents and retention.15 min
  12. 41AI in PaymentsModels in payments: fraud scoring, authorization optimization, disputes, onboarding and support, agentic commerce mandates, model risk and adverse action.19 min
  13. 42Payments MetricsThe numbers a payments platform runs on, one definition each: approval and success rates, declines, fraud, disputes, take rate, payouts, reconciliation, SLOs.16 min
  14. 43Becoming a Payment ProviderWhat it takes to be a Stripe or a payfac rather than integrate one: sponsor banks, card networks, PCI as a service provider, licensing and the money.13 min

Reference

  1. 44Payments GlossaryEvery term the payments volume uses, defined in a line and linked to its chapter: rails, rules, taking payments, paying out, issuing and running a provider.35 min