{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["tabs","tab","admonition"]},"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":"generate-batch-settlement-reports","__idx":0},"children":["Generate batch settlement reports"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A valid API key — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/how-tos/setup/obtain-credentials"},"children":["Obtain API credentials"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"batch-reporting-endpoints","__idx":2},"children":["Batch reporting 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 pagination, sorting, and filtering"]}]},{"$$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":["GET"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Check settlement status of batches"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"option-a-list-batches","__idx":3},"children":["Option A: List batches"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/batches"]}," to retrieve a paginated list of batches."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"query-parameters","__idx":4},"children":["Query parameters"]},{"$$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":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Type"},"children":["Type"]},{"$$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":["skip"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Number of records to skip (offset)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["take"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Number of records to return per page"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sort_column"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Column to sort by"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sort_order"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["asc"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["desc"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search_text"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Free-text search"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["term"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Filter term"]}]}]}]}]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"curl","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"shell","header":{"controls":{"copy":{}}},"source":"curl -G \\\n  https://api.dev.paradisegateway.net/v1/batches \\\n  -H \"APIKEY: YOUR-API-KEY\" \\\n  -d skip=0 \\\n  -d take=10 \\\n  -d sort_order=desc\n","lang":"shell"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Python","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","header":{"controls":{"copy":{}}},"source":"import requests\n\nresp = requests.get(\n    \"https://api.dev.paradisegateway.net/v1/batches\",\n    headers={\"APIKEY\": \"YOUR-API-KEY\"},\n    params={\"skip\": \"0\", \"take\": \"10\", \"sort_order\": \"desc\"},\n)\ndata = resp.json()\nprint(f\"Total batches: {data['count']}\")\nfor batch in data[\"results\"]:\n    print(f\"  {batch['batch_id']} — {batch['status']} — net: {batch['batch_net_amount']}\")\n","lang":"python"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"JavaScript","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"const params = new URLSearchParams({ skip: \"0\", take: \"10\", sort_order: \"desc\" });\nconst resp = await fetch(\n  `https://api.dev.paradisegateway.net/v1/batches?${params}`,\n  { headers: { \"APIKEY\": \"YOUR-API-KEY\" } }\n);\nconst data = await resp.json();\nconsole.log(`Total batches: ${data.count}`);\ndata.results.forEach((b) =>\n  console.log(`  ${b.batch_id} — ${b.status} — net: ${b.batch_net_amount}`)\n);\n","lang":"javascript"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"C#","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"csharp","header":{"controls":{"copy":{}}},"source":"using var client = new HttpClient();\nclient.DefaultRequestHeaders.Add(\"APIKEY\", \"YOUR-API-KEY\");\nvar resp = await client.GetAsync(\n    \"https://api.dev.paradisegateway.net/v1/batches?skip=0&take=10&sort_order=desc\");\nConsole.WriteLine(await resp.Content.ReadAsStringAsync());\n","lang":"csharp"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Java","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"java","header":{"controls":{"copy":{}}},"source":"HttpClient client = HttpClient.newHttpClient();\nHttpRequest request = HttpRequest.newBuilder()\n    .uri(URI.create(\n        \"https://api.dev.paradisegateway.net/v1/batches?skip=0&take=10&sort_order=desc\"))\n    .header(\"APIKEY\", \"YOUR-API-KEY\")\n    .GET().build();\nHttpResponse<String> resp = client.send(request,\n    HttpResponse.BodyHandlers.ofString());\nSystem.out.println(resp.body());\n","lang":"java"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Go","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"go","header":{"controls":{"copy":{}}},"source":"req, _ := http.NewRequest(\"GET\",\n    \"https://api.dev.paradisegateway.net/v1/batches?skip=0&take=10&sort_order=desc\", nil)\nreq.Header.Set(\"APIKEY\", \"YOUR-API-KEY\")\nresp, _ := http.DefaultClient.Do(req)\ndefer resp.Body.Close()\nbody, _ := io.ReadAll(resp.Body)\nfmt.Println(string(body))\n","lang":"go"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"PHP","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"php","header":{"controls":{"copy":{}}},"source":"$ch = curl_init(\"https://api.dev.paradisegateway.net/v1/batches?skip=0&take=10&sort_order=desc\");\ncurl_setopt_array($ch, [\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\"APIKEY: YOUR-API-KEY\"],\n]);\necho curl_exec($ch); curl_close($ch);\n","lang":"php"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Ruby","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"ruby","header":{"controls":{"copy":{}}},"source":"require \"net/http\"\nuri = URI(\"https://api.dev.paradisegateway.net/v1/batches?skip=0&take=10&sort_order=desc\")\nreq = Net::HTTP::Get.new(uri, { \"APIKEY\" => \"YOUR-API-KEY\" })\nresp = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }\nputs resp.body\n","lang":"ruby"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response","__idx":5},"children":["Response"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"count\": 47,\n  \"results\": [\n    {\n      \"id\": \"BATCH-01KFDKXMQ637EKEAY410MSQSXB\",\n      \"batch_id\": \"BATCH-01KFDKXMQ637EKEAY410MSQSXB\",\n      \"batch_number\": \"001\",\n      \"batch_type\": \"card\",\n      \"processor\": \"tsys\",\n      \"status\": \"settled\",\n      \"client_id\": \"CLIENT-3MtwBwLkdIwHu7ix28a3tqPa\",\n      \"client_name\": \"Acme Jewelry\",\n      \"approved_amount\": 125000,\n      \"captured_amount\": 125000,\n      \"refund_amount\": 2500,\n      \"void_amount\": 0,\n      \"net_amount\": 122500,\n      \"batch_net_amount\": 122500,\n      \"created_at\": \"2026-03-24T00:00:00Z\",\n      \"closed_at_date_time\": \"2026-03-24T22:00:00Z\",\n      \"settled_at_date_time\": \"2026-03-25T06:00:00Z\"\n    }\n  ],\n  \"correlation_id\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"key-batch-fields","__idx":6},"children":["Key batch fields"]},{"$$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":"Field"},"children":["Field"]},{"$$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":["status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Current batch state (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["open"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["closed"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["settled"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["approved_amount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Total approved amount in the batch (minor units)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["captured_amount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Total captured amount"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refund_amount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Total refunds in the batch"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["void_amount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Total voids in the batch"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["batch_net_amount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Net settlement amount (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["captured - refunds - voids"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["closed_at_date_time"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["When the batch was closed"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["settled_at_date_time"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["When funds were settled"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"option-b-check-batch-settlement-status","__idx":7},"children":["Option B: Check batch settlement status"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/batches/status"]}," to check which batches are in progress and which have completed."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"query-parameters-in-batch-settlement-status","__idx":8},"children":["Query parameters in batch settlement status"]},{"$$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":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Type"},"children":["Type"]},{"$$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":["client_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Filter by client"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["last_checked_at"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["date-time"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Only return batches updated after this timestamp"]}]}]}]}]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"curl","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"shell","header":{"controls":{"copy":{}}},"source":"curl -G \\\n  https://api.dev.paradisegateway.net/v1/batches/status \\\n  -H \"APIKEY: YOUR-API-KEY\" \\\n  -d last_checked_at=2026-03-24T00:00:00Z\n","lang":"shell"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Python","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","header":{"controls":{"copy":{}}},"source":"resp = requests.get(\n    \"https://api.dev.paradisegateway.net/v1/batches/status\",\n    headers={\"APIKEY\": \"YOUR-API-KEY\"},\n    params={\"last_checked_at\": \"2026-03-24T00:00:00Z\"},\n)\ndata = resp.json()\nprint(f\"Has in-progress: {data['has_in_progress']}\")\nprint(f\"In-progress batches: {len(data.get('in_progress_batches', []))}\")\nprint(f\"Completed batches: {len(data.get('completed_batches', []))}\")\n","lang":"python"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"JavaScript","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"const resp = await fetch(\n  \"https://api.dev.paradisegateway.net/v1/batches/status?last_checked_at=2026-03-24T00:00:00Z\",\n  { headers: { \"APIKEY\": \"YOUR-API-KEY\" } }\n);\nconst data = await resp.json();\nconsole.log(\"Has in-progress:\", data.has_in_progress);\n","lang":"javascript"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"C#","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"csharp","header":{"controls":{"copy":{}}},"source":"var resp = await client.GetAsync(\n    \"https://api.dev.paradisegateway.net/v1/batches/status?last_checked_at=2026-03-24T00:00:00Z\");\nConsole.WriteLine(await resp.Content.ReadAsStringAsync());\n","lang":"csharp"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Java","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"java","header":{"controls":{"copy":{}}},"source":"HttpRequest request = HttpRequest.newBuilder()\n    .uri(URI.create(\n        \"https://api.dev.paradisegateway.net/v1/batches/status?last_checked_at=2026-03-24T00:00:00Z\"))\n    .header(\"APIKEY\", \"YOUR-API-KEY\")\n    .GET().build();\nHttpResponse<String> resp = client.send(request,\n    HttpResponse.BodyHandlers.ofString());\nSystem.out.println(resp.body());\n","lang":"java"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Go","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"go","header":{"controls":{"copy":{}}},"source":"req, _ := http.NewRequest(\"GET\",\n    \"https://api.dev.paradisegateway.net/v1/batches/status?last_checked_at=2026-03-24T00:00:00Z\", nil)\nreq.Header.Set(\"APIKEY\", \"YOUR-API-KEY\")\nresp, _ := http.DefaultClient.Do(req)\ndefer resp.Body.Close()\nbody, _ := io.ReadAll(resp.Body)\nfmt.Println(string(body))\n","lang":"go"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"PHP","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"php","header":{"controls":{"copy":{}}},"source":"$ch = curl_init(\"https://api.dev.paradisegateway.net/v1/batches/status?last_checked_at=2026-03-24T00:00:00Z\");\ncurl_setopt_array($ch, [\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\"APIKEY: YOUR-API-KEY\"],\n]);\necho curl_exec($ch); curl_close($ch);\n","lang":"php"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Ruby","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"ruby","header":{"controls":{"copy":{}}},"source":"uri = URI(\"https://api.dev.paradisegateway.net/v1/batches/status?last_checked_at=2026-03-24T00:00:00Z\")\nreq = Net::HTTP::Get.new(uri, { \"APIKEY\" => \"YOUR-API-KEY\" })\nresp = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }\nputs resp.body\n","lang":"ruby"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-in-batch-settlement-status","__idx":9},"children":["Response in batch settlement status"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"has_in_progress\": true,\n  \"in_progress_batches\": [\n    { \"batch_id\": \"BATCH-02LGEHRR1BZSPA6WRY1T3H4CD\", \"status\": \"closing\" }\n  ],\n  \"completed_batches\": [\n    { \"batch_id\": \"BATCH-01KFDKXMQ637EKEAY410MSQSXB\", \"status\": \"settled\" }\n  ],\n  \"max_closed_at\": \"2026-03-24T22:00:00Z\",\n  \"correlation_id\": \"b2c3d4e5-f6a7-8901-bcde-f12345678901\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Polling for settlement"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["last_checked_at"]}," with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["max_closed_at"]}," value from the previous response to poll efficiently for newly completed batches without re-fetching old data."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":10},"children":["Next steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/how-tos/manage-transactions/close-batch-manually"},"children":["Close a batch manually"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/transactions/batch-settlement"},"children":["About batch settlement"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/how-tos/reports/generate-transaction-report"},"children":["Generate a transaction report"]}]}]}]},"headings":[{"value":"Generate batch settlement reports","id":"generate-batch-settlement-reports","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Batch reporting endpoints","id":"batch-reporting-endpoints","depth":2},{"value":"Option A: List batches","id":"option-a-list-batches","depth":2},{"value":"Query parameters","id":"query-parameters","depth":3},{"value":"Response","id":"response","depth":3},{"value":"Key batch fields","id":"key-batch-fields","depth":3},{"value":"Option B: Check batch settlement status","id":"option-b-check-batch-settlement-status","depth":2},{"value":"Query parameters in batch settlement status","id":"query-parameters-in-batch-settlement-status","depth":3},{"value":"Response in batch settlement status","id":"response-in-batch-settlement-status","depth":3},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"title":"Generate batch settlement reports","shortTitle":"Batch reports","intro":"Retrieve batch lists, settlement status, and batch details using the Batches API. Use these reports to reconcile settlements and monitor batch processing.","type":"how-to","seo":{"title":""}},"lastModified":"2026-06-05T02:46:44.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/how-tos/reports/batch-reporting","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}