{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img"]},"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-batch-settlement","__idx":0},"children":["About batch settlement"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-is-batch-settlement","__idx":1},"children":["What is batch settlement"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Batch settlement is the process of transferring funds from authorized transactions to the merchant's bank account. Rather than settling each transaction individually,","Reefpay"," groups transactions into ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["batches"]}," that are submitted to the processor as a single unit."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"https://files.modern-mermaid.live/images/1776270433518-mermaid-diagram-1776270433430.png","alt":"Batch settlement","framed":false,"withLightbox":true,"className":"batch-settlement","width":"auto","height":"auto"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-batches-work","__idx":2},"children":["How batches work"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"accumulation","__idx":3},"children":["Accumulation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As transactions are authorized throughout the business day, they are added to the current open batch. Each authorized transaction receives a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["batch_id"]}," in the response."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"TRANSACTION-01JMRSPCK7XVNP3KS8F2W4T6Y\",\n  \"type\": \"sale\",\n  \"transaction_state\": \"authorized\",\n  \"batch_id\": \"BATCH-01JMRSPCK7XVNP3KS8F2W4T6Y\",\n  \"amount\": 1999\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"closure","__idx":4},"children":["Closure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the batch closes, all transactions in the batch are submitted to the processor for clearing. Batch closure can happen in two ways:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Automatic"]},": The batch closes on a schedule (typically at the end of each business day)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manual"]},": A merchant or reseller closes the batch explicitly through the API."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"clearing-and-settlement","__idx":5},"children":["Clearing and settlement"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After the batch closes:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The processor submits the batch to the card network (for card transactions) or ACH network (for bank account transactions)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The card network coordinates fund transfers between the issuing bank and the acquiring bank."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The acquiring bank deposits the net settlement amount (transaction total minus fees) into the merchant's account."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Settlement typically completes within 1–2 business days for card transactions and 2–3 business days for ACH transactions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"batch-api-endpoints","__idx":6},"children":["Batch API endpoints"]},{"$$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":"Endpoint"},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Method"},"children":["Method"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/batches"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["GET"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["List batches with transaction counts and totals"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/batches/status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["PUT"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Update batch status (close an open batch)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"listing-batches","__idx":7},"children":["Listing batches"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retrieve batch history with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/batches"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"shell","header":{"controls":{"copy":{}}},"source":"curl -X GET \\\n  https://api.dev.paradisegateway.net/v1/batches \\\n  -H \"APIKEY: YOUR-API-KEY\"\n","lang":"shell"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"closing-a-batch-manually","__idx":8},"children":["Closing a batch manually"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Close the current open batch by updating its status with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT /v1/batches/status"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"shell","header":{"controls":{"copy":{}}},"source":"curl -X PUT \\\n  https://api.dev.paradisegateway.net/v1/batches/status \\\n  -H \"Content-Type: application/json\" \\\n  -H \"APIKEY: YOUR-API-KEY\" \\\n  -d '{\n    \"status\": \"closed\"\n  }'\n","lang":"shell"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-goes-into-a-batch","__idx":9},"children":["What goes into a batch"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A batch includes all transactions that are in a capturable state when the batch closes."]},{"$$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":"Transaction type"},"children":["Transaction type"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Included in batch"},"children":["Included in batch"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sale"]}," (authorized)"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["auth"]}," (captured)"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cancel"]}," (voided before close)"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Removed from batch"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refund"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Included as a credit"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment"]}," (authorized)"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payout"]}," (authorized)"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Canceled (voided) transactions are removed from the batch before submission. Refunds are included as negative amounts, reducing the net settlement total."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"settlement-timeline","__idx":10},"children":["Settlement timeline"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["| Event | Transactions |"," ","| :--------| :---------| :-----------|"," ","| Transaction authorized | Immediate | Immediate |"," ","| Batch closes | End of business day (or manual) | End of business day (or manual) |"," ","| Processor submits to network | Same day or next business day | Next business day |"," ","| Funds deposited to merchant | 1–2 business days after closure | 2–3 business days after closure |"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"reconciliation","__idx":11},"children":["Reconciliation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reconcile your records against","Reefpay","'s batch data to verify that all expected transactions are accounted for."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"recommended-approach","__idx":12},"children":["Recommended approach"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["List batches"]}," for the date range using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/batches"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Compare transaction counts"]}," and amounts against your internal records."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["List transactions"]}," within a batch using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/transactions"]}," filtered by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["batch_id"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Check for discrepancies"]},": missing transactions, unexpected cancels, or amount mismatches."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Log ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["correlation_id"]}," values"]}," for any transactions that require investigation."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"net-settlement-calculation","__idx":13},"children":["Net settlement calculation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The amount deposited to the merchant's account is the net of all transactions in the batch, minus processor and interchange fees."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Net settlement = (Sales + Captures) − Refunds − Fees\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fees include interchange fees (paid to the issuing bank), assessment fees (paid to the card network), and processor markup. These are deducted before the funds reach the merchant's account."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more information about fee structures, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/payment-industry/networks-and-interchange"},"children":["About card networks and interchange"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"further-reading","__idx":14},"children":["Further reading"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/transactions/transaction-lifecycle"},"children":["About the transaction lifecycle"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/transactions/cancels-and-refunds"},"children":["About cancels and refunds"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/how-tos/manage-transactions/close-batch-manually"},"children":["Closing a batch manually"]}]},{"$$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"]}]}]}]},"headings":[{"value":"About batch settlement","id":"about-batch-settlement","depth":1},{"value":"What is batch settlement","id":"what-is-batch-settlement","depth":2},{"value":"How batches work","id":"how-batches-work","depth":2},{"value":"Accumulation","id":"accumulation","depth":3},{"value":"Closure","id":"closure","depth":3},{"value":"Clearing and settlement","id":"clearing-and-settlement","depth":3},{"value":"Batch API endpoints","id":"batch-api-endpoints","depth":2},{"value":"Listing batches","id":"listing-batches","depth":3},{"value":"Closing a batch manually","id":"closing-a-batch-manually","depth":3},{"value":"What goes into a batch","id":"what-goes-into-a-batch","depth":2},{"value":"Settlement timeline","id":"settlement-timeline","depth":2},{"value":"Reconciliation","id":"reconciliation","depth":2},{"value":"Recommended approach","id":"recommended-approach","depth":3},{"value":"Net settlement calculation","id":"net-settlement-calculation","depth":2},{"value":"Further reading","id":"further-reading","depth":2}],"frontmatter":{"title":"About batch settlement","shortTitle":"Batch settlement","intro":"Transactions are grouped into batches and settled to the merchant's bank account when the batch closes. Understanding the batch process helps you reconcile payments and manage cash flow.","type":"overview","seo":{"title":""}},"lastModified":"2026-06-05T02:46:44.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/concepts/transactions/batch-settlement","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}