{"templateId":"markdown","sharedDataIds":{},"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":"handle-partial-captures","__idx":0},"children":["Handle partial captures"]},{"$$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":"li","attributes":{},"children":["An authorized transaction from a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card_auth"]}," request (the two-step flow)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"when-to-use-partial-captures","__idx":2},"children":["When to use partial captures"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Split shipments"]},": An order with multiple items ships in separate packages. Capture the amount for each shipment as it leaves."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Adjusted totals"]},": The final order amount is less than the initial authorization (item unavailable, price adjustment)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Hotel / rental"]},": The estimated hold exceeds the actual charge."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-authorize-the-full-estimated-amount","__idx":3},"children":["Step 1: Authorize the full estimated amount"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"shell","header":{"controls":{"copy":{}}},"source":"curl -X POST \\\n https://api.dev.paradisegateway.net/v1/transactions \\\n -H \"Content-Type: application/json\" \\\n -H \"APIKEY: YOUR-API-KEY\" \\\n -d '{\n \"type\": \"auth\",\n \"amount\": 50000,\n \"payment_method\": {\n \"type\": \"card\",\n \"pan\": \"5500000000005678\",\n \"expiry\":\n \"month\": \"07\",\n \"year\": \"2029\"\n },\n \"cardholder_name\": \"Nyota Uhura\",\n \"cvv\": \"789\",\n \"address_line1\": \"42 Subspace Ln\",\n \"zip\": \"30301\"\n },\n \"metadata\": {},\n \"recurring\": false,\n \"purchase_description\": \"Starfleet uniform\"\n }'\n","lang":"shell"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Response returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_state: authorized"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount: 50000"]},". Save the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-capture-a-partial-amount","__idx":4},"children":["Step 2: Capture a partial amount"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/transactions/{id}/capture"]}," with an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]}," less than the authorized total."]},{"$$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 -X POST \\\n https://api.dev.paradisegateway.net/v1/transactions/TRANSACTION-02KNUHURA8YWP4LT9G3X5V7Z0/capture \\\n -H \"Content-Type: application/json\" \\\n -H \"APIKEY: YOUR-API-KEY\" \\\n -d '{\n \"type\": \"capture\",\n \"amount\": 30000,\n \"tip\": 0\n }'\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\ntransaction_id = \"TRANSACTION-02KNUHURA8YWP4LT9G3X5V7Z0\"\nresp = requests.post(\n f\"https://api.dev.paradisegateway.net/v1/transactions/{transaction_id}/capture\",\n headers={\"Content-Type\": \"application/json\", \"APIKEY\": \"YOUR-API-KEY\"},\n json={\"type\": \"capture\", \"amount\": 30000, \"tip\": 0},\n)\nprint(resp.json())\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 transactionId = \"TRANSACTION-02KNUHURA8YWP4LT9G3X5V7Z0\";\nconst resp = await fetch(\n `https://api.dev.paradisegateway.net/v1/transactions/${transactionId}/capture`,\n {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"APIKEY\": \"YOUR-API-KEY\",\n },\n body: JSON.stringify({\n type: \"capture\",\n amount: 30000,\n tip: 0,\n }),\n }\n);\nconsole.log(await resp.json());\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 transactionId = \"TRANSACTION-02KNUHURA8YWP4LT9G3X5V7Z0\";\nvar payload = new { type = \"capture\", amount = 30000, tip = 0 };\nvar resp = await client.PostAsJsonAsync(\n $\"https://api.dev.paradisegateway.net/v1/transactions/{transactionId}/capture\",\n payload);\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":"String transactionId = \"TRANSACTION-02KNUHURA8YWP4LT9G3X5V7Z0\";\nString body = \"\"\"\n {\"type\": \"capture\", \"amount\": 30000, \"tip\": 0}\n \"\"\";\nHttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(\n \"https://api.dev.paradisegateway.net/v1/transactions/\"\n + transactionId + \"/capture\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"APIKEY\", \"YOUR-API-KEY\")\n .POST(HttpRequest.BodyPublishers.ofString(body)).build();\nHttpResponse 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":"transactionID := \"TRANSACTION-02KNUHURA8YWP4LT9G3X5V7Z0\"\npayload := strings.NewReader(`{\"type\": \"capture\", \"amount\": 30000, \"tip\": 0}`)\nreq, _ := http.NewRequest(\"POST\",\n \"https://api.dev.paradisegateway.net/v1/transactions/\"+transactionID+\"/capture\",\n payload)\nreq.Header.Set(\"Content-Type\", \"application/json\")\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":"$id = \"TRANSACTION-02KNUHURA8YWP4LT9G3X5V7Z0\";\n$ch = curl_init(\n \"https://api.dev.paradisegateway.net/v1/transactions/$id/capture\");\ncurl_setopt_array($ch, [\n CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true,\n CURLOPT_HTTPHEADER => [\"Content-Type: application/json\", \"APIKEY: YOUR-API-KEY\"],\n CURLOPT_POSTFIELDS => json_encode([\n \"type\" => \"capture\", \"amount\" => 30000, \"tip\" => 0,\n ]),\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":"id = \"TRANSACTION-02KNUHURA8YWP4LT9G3X5V7Z0\"\nuri = URI(\n \"https://api.dev.paradisegateway.net/v1/transactions/#{id}/capture\")\nreq = Net::HTTP::Post.new(uri, {\n \"Content-Type\" => \"application/json\", \"APIKEY\" => \"YOUR-API-KEY\",\n})\nreq.body = { type: \"capture\", amount: 30000, tip: 0 }.to_json\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":2,"id":"step-3-verify-the-capture","__idx":5},"children":["Step 3: Verify the capture"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response confirms the captured amount. The remaining 200.00 USD hold (500.00 authorized − 300.00 captured) is released back to the person."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"id\": \"TRANSACTION-02KNUHURA8YWP4LT9G3X5V7Z0\",\n \"type\": \"capture\",\n \"transaction_state\": \"completed\",\n \"response_status\": \"Approved\",\n \"response_code\": \"00\",\n \"amount\": 30000,\n \"tip\": 0,\n \"correlation_id\": \"f6a7b8c9-d0e1-2345-f012-3456789abcde\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-partial-captures-work","__idx":6},"children":["How partial captures work"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"---\nconfig:\n theme: 'neutral'\n---\nflowchart TD\n A[\"Authorization: 500.00 USD\"] --> B{Full or partial?}\n B -->|Full| C[\"Capture 500.00 USD\"]\n B -->|Partial| D[\"Capture 300.00 USD\"]\n D --> E[\"200.00 USD hold released\"]\n C --> F[Settled in next batch]\n D --> F\n","diagramHtml":"

Full

Partial

Authorization: 500.00 USD

Full or partial?

Capture 500.00 USD

Capture 300.00 USD

200.00 USD hold released

Settled in next batch

","diagramHtmlDark":"

Full

Partial

Authorization: 500.00 USD

Full or partial?

Capture 500.00 USD

Capture 300.00 USD

200.00 USD hold released

Settled in next batch

"},"children":["---\nconfig:\n theme: 'neutral'\n---\nflowchart TD\n A[\"Authorization: 500.00 USD\"] --> B{Full or partial?}\n B -->|Full| C[\"Capture 500.00 USD\"]\n B -->|Partial| D[\"Capture 300.00 USD\"]\n D --> E[\"200.00 USD hold released\"]\n C --> F[Settled in next batch]\n D --> F\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":{"align":"left","data-label":"Scenario"},"children":["Scenario"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Authorized"},"children":["Authorized"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Captured"},"children":["Captured"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Released to person"},"children":["Released to person"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Full capture"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["500.00"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["500.00"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["0.00"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Partial capture"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["500.00"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["300.00"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["200.00"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Zero capture (cancel)"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["500.00"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["0.00"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["500.00"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"rules-and-constraints","__idx":7},"children":["Rules and constraints"]},{"$$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":"Rule"},"children":["Rule"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Details"},"children":["Details"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Capture amount must be ≤ authorized amount"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["You cannot capture more than was authorized"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Single capture per authorization"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Each authorization can be captured once (for multiple captures, use multiple authorizations)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Timing"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Must capture before the authorization expires (7–30 days, varies by issuer)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Tip at capture"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["You can include a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tip"]}," in the capture request; the total (amount + tip) must not exceed the authorized amount"]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Split shipments"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For orders that ship in multiple packages, authorize the full order amount up front, then create separate authorizations for each shipment and capture individually. This is more reliable than attempting multiple partial captures against a single authorization."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":8},"children":["Next steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/how-tos/process-payments/authorize-capture-separately"},"children":["Authorize and capture separately"]}," — the full two-step flow"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/how-tos/process-payments/add-tip"},"children":["Add a tip or surcharge"]}," — adjust the amount before capture"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/transactions/cancels-and-refunds"},"children":["About cancels and refunds"]}," — what to do if you do not need to capture"]}]}]},"headings":[{"value":"Handle partial captures","id":"handle-partial-captures","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"When to use partial captures","id":"when-to-use-partial-captures","depth":2},{"value":"Step 1: Authorize the full estimated amount","id":"step-1-authorize-the-full-estimated-amount","depth":2},{"value":"Step 2: Capture a partial amount","id":"step-2-capture-a-partial-amount","depth":2},{"value":"Step 3: Verify the capture","id":"step-3-verify-the-capture","depth":2},{"value":"How partial captures work","id":"how-partial-captures-work","depth":2},{"value":"Rules and constraints","id":"rules-and-constraints","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"title":"Handle partial captures","shortTitle":"Partial captures","intro":"Capture less than the authorized amount when only part of an order ships or the final amount is lower than estimated. The remaining hold is released back to the person.","type":"how-to","seo":{"title":""}},"lastModified":"2026-06-05T02:46:44.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/how-tos/process-payments/handle-partial-capture","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}