{"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."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"how-card-payments-work","__idx":0},"children":["How card payments work"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Background, not instructions. You can integrate successfully without reading it,"," ","but the vocabulary here turns up in responses and support conversations."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"the-parties","__idx":1},"children":["The parties"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"---\nconfig:\n theme: 'neutral'\n---\nflowchart LR\n A[Cardholder] --> B[Your application]\n B --> C[Gateway]\n C --> D[Processor]\n D --> E[Card network]\n E --> F[Issuing bank]\n F --> E --> D --> C --> B\n","diagramHtml":"

Cardholder

Your application

Gateway

Processor

Card network

Issuing bank

","diagramHtmlDark":"

Cardholder

Your application

Gateway

Processor

Card network

Issuing bank

"},"children":["---\nconfig:\n theme: 'neutral'\n---\nflowchart LR\n A[Cardholder] --> B[Your application]\n B --> C[Gateway]\n C --> D[Processor]\n D --> E[Card network]\n E --> F[Issuing bank]\n F --> E --> D --> C --> B\n"]},{"$$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":{"data-label":"Party"},"children":["Party"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Does"},"children":["Does"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cardholder"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Presents a card"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Merchant"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sells the thing. Your customer, or you"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Gateway"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Takes an API request and turns it into a processor message. This is us"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Processor"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Connects to the card networks. TSYS, for cards"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card network"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Visa, Mastercard, Amex, Discover. Routes to the issuer"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Issuing bank"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Holds the cardholder's account and decides approve or decline"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Acquiring bank"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Holds the merchant's account and receives the funds"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["You talk to the gateway and nothing else."]}," No direct connection to a"," ","processor, a network, or a bank is needed."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authorization-then-settlement","__idx":2},"children":["Authorization, then settlement"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A card payment is two events, usually hours apart."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authorization"]}," asks the issuer to reserve funds. It is synchronous — the"," ","answer comes back in the API response, and it is where an approval or a decline"," ","happens."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settlement"]}," actually moves the money. Transactions gather in a batch, the batch"," ","closes on a schedule, and the acquirer funds the merchant a day or two later."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["That gap is why ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_settled"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}," on a transaction you just approved, and"," ","why a void and a refund are different operations. See"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/after-the-payment/transaction-lifecycle"},"children":["Transaction lifecycle"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-the-gateway-does-for-you","__idx":3},"children":["What the gateway does for you"]},{"$$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":{"data-label":""},"children":[]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["One integration"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card and ACH through one API, rather than one per processor"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tokenization"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/payments/save-and-reuse-a-payment-method"},"children":["payment token"]}," instead of storing card numbers"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Normalized responses"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The same transaction object whichever processor handled it"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Settlement"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Batching and close, with ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/after-the-payment/batch-reports"},"children":["reporting"]}," to reconcile against"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":4},"children":["Next steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/card-networks-and-interchange"},"children":["Card networks and interchange"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/after-the-payment/transaction-lifecycle"},"children":["Transaction lifecycle"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/payments/accept-a-card-payment"},"children":["Accept a card payment"]}]}]}]},"headings":[{"value":"How card payments work","id":"how-card-payments-work","depth":1},{"value":"The parties","id":"the-parties","depth":2},{"value":"Authorization, then settlement","id":"authorization-then-settlement","depth":2},{"value":"What the gateway does for you","id":"what-the-gateway-does-for-you","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"title":"How card payments work","shortTitle":"How card payments work","intro":"The parties involved in a card payment, what each one does, and where the gateway sits among them.","type":"overview","seo":{"title":""}},"lastModified":"2026-09-17T12:59:03.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/concepts/how-card-payments-work","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}