{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Reefpay Docs","description":"Reefpay is the groundbreaking payment gateway that lets you integrate with the future of payments.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"about-electronic-payments","__idx":0},"children":["About electronic payments"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-are-electronic-payments","__idx":1},"children":["What are electronic payments"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Electronic payments are financial transactions conducted through digital systems rather than physical cash or checks. When a person purchases a product online or taps a card at a terminal, an electronic payment moves funds from their account to the merchant's account through a chain of intermediaries."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These intermediaries — payment gateways, processors, card networks, and banks — each play a specific role in authorizing, clearing, and settling the transaction."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-a-payment-transaction-works","__idx":2},"children":["How a payment transaction works"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A typical card payment follows this sequence."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://files.modern-mermaid.live/images/1776271440287-mermaid-diagram-1776271440136.png","alt":"image"},"children":[]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Initiation"]},": The person submits payment details (card number, expiration, CVV) through the merchant's checkout."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Encryption and routing"]},": The payment gateway encrypts the data and forwards it to a payment processor."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authorization"]},": The processor routes the request through the card network to the issuing bank, which checks the account for available funds and fraud signals."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]},": The issuing bank approves or declines the transaction. The response travels back through the chain to the merchant in milliseconds."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settlement"]},": At the end of the business day, approved transactions are batched and settled. The issuing bank transfers funds through the card network to the merchant's acquiring bank."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"types-of-electronic-payments","__idx":3},"children":["Types of electronic payments"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Payment type"},"children":["Payment type"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Example"},"children":["Example"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Credit and debit cards"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Card credentials authorize a transfer from the cardholder's account"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Visa, Mastercard"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["ACH / bank transfers"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Funds move directly between bank accounts through the Automated Clearing House network"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Payroll direct deposits, bill payments"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Digital wallets"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Card or bank credentials stored in a mobile device for contactless payments"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Apple Pay, Google Pay"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Contactless payments"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Near Field Communication (NFC) or QR codes enable tap-to-pay at terminals"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Tap-to-pay cards, mobile NFC"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"key-entities-in-a-payment-transaction","__idx":4},"children":["Key entities in a payment transaction"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Entity"},"children":["Entity"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Role"},"children":["Role"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Person (cardholder)"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Initiates the purchase"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Merchant"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Sells goods or services and accepts payment"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Payment gateway"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Encrypts payment data and routes it between the merchant and processor"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Payment processor"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Communicates with card networks and banks to authorize transactions"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Card network"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Provides the infrastructure connecting issuing and acquiring banks (Visa, Mastercard, etc.)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Issuing bank"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The person's bank; holds their funds and approves or declines transactions"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Acquiring bank"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The merchant's bank; receives settled funds"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"why-this-matters-for-integration","__idx":5},"children":["Why this matters for integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As a developer integrating with ","Reefpay",", you interact primarily with the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["gateway layer"]},". ","Reefpay"," handles encryption, processor routing, and response normalization so your application does not need direct connections to processors or banks."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Understanding the full transaction flow helps you:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Design correct authorization and capture workflows"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Handle declines and errors with appropriate person-facing messages"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Implement settlement reconciliation against batch reports"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"further-reading","__idx":6},"children":["Further reading"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/payment-industry/evolution"},"children":["About the evolution of payments"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/payment-industry/role-of-gateways"},"children":["About the role of gateways"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/payment-industry/networks-and-interchange"},"children":["About card networks and interchange"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/get-started"},"children":["About ","Reefpay"]}]}]}]},"headings":[{"value":"About electronic payments","id":"about-electronic-payments","depth":1},{"value":"What are electronic payments","id":"what-are-electronic-payments","depth":2},{"value":"How a payment transaction works","id":"how-a-payment-transaction-works","depth":2},{"value":"Types of electronic payments","id":"types-of-electronic-payments","depth":2},{"value":"Key entities in a payment transaction","id":"key-entities-in-a-payment-transaction","depth":2},{"value":"Why this matters for integration","id":"why-this-matters-for-integration","depth":2},{"value":"Further reading","id":"further-reading","depth":2}],"frontmatter":{"title":"About electronic payments","shortTitle":"Intro to payments","intro":"Electronic payments transfer funds between parties without physical currency. Understanding how they work is essential for building payment integrations.","type":"overview","seo":{"title":""}},"lastModified":"2026-06-05T02:46:44.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/concepts/payment-industry/intro","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}