{"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":"recipe-authorize-and-capture","__idx":0},"children":["Recipe: Authorize and capture"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"when-to-use-two-step-payments","__idx":1},"children":["When to use two-step payments"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["E-commerce"]}," — authorize at checkout, capture when the order ships"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Hotels / car rentals"]}," — authorize an estimated amount, capture the final charge"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Subscriptions"]}," — authorize a recurring amount, capture after usage is calculated"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a comparison of one-step vs. two-step flows, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/transactions/sale-vs-auth"},"children":["Sale vs. authorization"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"payment-state-lifecycle","__idx":2},"children":["Payment state lifecycle"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://files.modern-mermaid.live/images/1776276907982-mermaid-diagram-1776276908167.png","alt":"image"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":3},"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":["A TSYS integration configured for card processing"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-authorize","__idx":4},"children":["Step 1: Authorize"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card_auth"]}," transaction to place a hold on the customer's card."]},{"$$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 \\\n -H \"Content-Type: application/json\" \\\n -H \"APIKEY: YOUR-API-KEY\" \\\n -d '{\n \"type\": \"card_auth\",\n \"amount\": 4995,\n \"card\": {\n \"pan\": \"4111111111111111\",\n \"expiry_month\": \"12\",\n \"expiry_year\": \"2027\",\n \"cvv\": \"123\",\n \"cardholder_name\": \"Jane Smith\",\n \"address\": { \"line1\": \"123 Main St\", \"zip\": \"62704\" }\n }\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 os, requests\n\nAPI_KEY = os.environ[\"PARADISE_API_KEY\"]\nBASE = os.environ.get(\"PARADISE_BASE_URL\", \"https://api.dev.paradisegateway.net\")\nHEADERS = {\"Content-Type\": \"application/json\", \"APIKEY\": API_KEY}\n\nauth_resp = requests.post(f\"{BASE}/v1/transactions\", headers=HEADERS, json={\n \"type\": \"card_auth\",\n \"amount\": 4995,\n \"card\": {\n \"pan\": \"4111111111111111\",\n \"expiry_month\": \"12\",\n \"expiry_year\": \"2027\",\n \"cvv\": \"123\",\n \"cardholder_name\": \"Jane Smith\",\n \"address\": {\"line1\": \"123 Main St\", \"zip\": \"62704\"},\n },\n})\nauth = auth_resp.json()\ntxn_id = auth[\"id\"]\nprint(f\"Authorized: {txn_id} — state: {auth['transaction_state']}\")\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 API_KEY = process.env.PARADISE_API_KEY;\nconst BASE = process.env.PARADISE_BASE_URL || \"https://api.dev.paradisegateway.net\";\nconst headers = { \"Content-Type\": \"application/json\", \"APIKEY\": API_KEY };\n\nconst authResp = await fetch(`${BASE}/v1/transactions`, {\n method: \"POST\",\n headers,\n body: JSON.stringify({\n type: \"card_auth\",\n amount: 4995,\n card: {\n pan: \"4111111111111111\",\n expiry_month: \"12\",\n expiry_year: \"2027\",\n cvv: \"123\",\n cardholder_name: \"Jane Smith\",\n address: { line1: \"123 Main St\", zip: \"62704\" },\n },\n }),\n});\nconst auth = await authResp.json();\nconsole.log(`Authorized: ${auth.id} — state: ${auth.transaction_state}`);\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();\nvar baseUrl = Environment.GetEnvironmentVariable(\"PARADISE_BASE_URL\") ?? \"https://api.dev.paradisegateway.net\";\nclient.DefaultRequestHeaders.Add(\"APIKEY\", Environment.GetEnvironmentVariable(\"PARADISE_API_KEY\"));\n\nvar authResp = await client.PostAsJsonAsync($\"{baseUrl}/v1/transactions\", new {\n type = \"card_auth\",\n amount = 4995,\n card = new {\n pan = \"4111111111111111\",\n expiry_month = \"12\",\n expiry_year = \"2027\",\n cvv = \"123\",\n cardholder_name = \"Jane Smith\",\n address = new { line1 = \"123 Main St\", zip = \"62704\" },\n },\n});\nvar auth = await authResp.Content.ReadAsStringAsync();\nConsole.WriteLine(auth);\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();\nString baseUrl = System.getenv().getOrDefault(\"PARADISE_BASE_URL\", \"https://api.dev.paradisegateway.net\");\n\nHttpRequest authReq = HttpRequest.newBuilder()\n .uri(URI.create(baseUrl + \"/v1/transactions\"))\n .header(\"Content-Type\", \"application/json\")\n .header(\"APIKEY\", System.getenv(\"PARADISE_API_KEY\"))\n .POST(HttpRequest.BodyPublishers.ofString(\"\"\"\n {\n \"type\": \"card_auth\",\n \"amount\": 4995,\n \"card\": {\n \"pan\": \"4111111111111111\",\n \"expiry_month\": \"12\",\n \"expiry_year\": \"2027\",\n \"cvv\": \"123\",\n \"cardholder_name\": \"Jane Smith\",\n \"address\": { \"line1\": \"123 Main St\", \"zip\": \"62704\" }\n }\n }\"\"\"))\n .build();\nHttpResponse authResp = client.send(authReq, HttpResponse.BodyHandlers.ofString());\nSystem.out.println(authResp.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":"payload := `{\n \"type\": \"card_auth\",\n \"amount\": 4995,\n \"card\": {\n \"pan\": \"4111111111111111\",\n \"expiry_month\": \"12\",\n \"expiry_year\": \"2027\",\n \"cvv\": \"123\",\n \"cardholder_name\": \"Jane Smith\",\n \"address\": {\"line1\": \"123 Main St\", \"zip\": \"62704\"}\n }\n}`\nreq, _ := http.NewRequest(\"POST\", base+\"/v1/transactions\", strings.NewReader(payload))\nreq.Header.Set(\"Content-Type\", \"application/json\")\nreq.Header.Set(\"APIKEY\", apiKey)\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":"$payload = json_encode([\n \"type\" => \"card_auth\",\n \"amount\" => 4995,\n \"card\" => [\n \"pan\" => \"4111111111111111\",\n \"expiry_month\" => \"12\",\n \"expiry_year\" => \"2027\",\n \"cvv\" => \"123\",\n \"cardholder_name\" => \"Jane Smith\",\n \"address\" => [\"line1\" => \"123 Main St\", \"zip\" => \"62704\"],\n ],\n]);\n$ch = curl_init(\"{$base}/v1/transactions\");\ncurl_setopt_array($ch, [\n CURLOPT_RETURNTRANSFER => true,\n CURLOPT_POST => true,\n CURLOPT_HTTPHEADER => [\"Content-Type: application/json\", \"APIKEY: {$apiKey}\"],\n CURLOPT_POSTFIELDS => $payload,\n]);\necho curl_exec($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(\"#{base}/v1/transactions\")\nreq = Net::HTTP::Post.new(uri)\nreq[\"Content-Type\"] = \"application/json\"\nreq[\"APIKEY\"] = api_key\nreq.body = { type: \"card_auth\", amount: 4995, card: {\n pan: \"4111111111111111\", expiry_month: \"12\", expiry_year: \"2027\",\n cvv: \"123\", cardholder_name: \"Jane Smith\",\n address: { line1: \"123 Main St\", zip: \"62704\" }\n} }.to_json\nres = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }\nputs res.body\n","lang":"ruby"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"authorization-response","__idx":5},"children":["Authorization response"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"id\": \"TRANSACTION-01KEW32V6YNV11T33XGDR7TGWC\",\n \"type\": \"card_auth\",\n \"amount\": 4995,\n \"transaction_state\": \"authorized\",\n \"response_status\": \"approved\",\n \"response_code\": \"00\",\n \"avs_result_code\": \"Y\",\n \"cvv_result\": \"M\",\n \"correlation_id\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Save the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," — you need it for capture or cancel."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Check fraud signals"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Review ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["avs_result_code"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cvv_result"]}," before fulfilling. If AVS or CVV fails, consider canceling the authorization. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/security-compliance/fraud-protection"},"children":["Fraud prevention"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-capture","__idx":6},"children":["Step 2: Capture"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you are ready to charge (for example, when the order ships), capture the authorized amount."]},{"$$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-01KEW32V6YNV11T33XGDR7TGWC/capture \\\n -H \"Content-Type: application/json\" \\\n -H \"APIKEY: YOUR-API-KEY\" \\\n -d '{ \"amount\": 4995 }'\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":"cap_resp = requests.post(\n f\"{BASE}/v1/transactions/{txn_id}/capture\",\n headers=HEADERS,\n json={\"amount\": 4995},\n)\ncap = cap_resp.json()\nprint(f\"Captured: {cap['transaction_state']}\")\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 capResp = await fetch(`${BASE}/v1/transactions/${auth.id}/capture`, {\n method: \"POST\",\n headers,\n body: JSON.stringify({ amount: 4995 }),\n});\nconst cap = await capResp.json();\nconsole.log(`Captured: ${cap.transaction_state}`);\n","lang":"javascript"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"partial-capture","__idx":7},"children":["Partial capture"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To capture less than the authorized amount (for example, partial shipment), specify a smaller ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]},". The remaining hold is released."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"shell","header":{"controls":{"copy":{}}},"source":"curl -X POST \\\n https://api.dev.paradisegateway.net/v1/transactions/TRANSACTION-01KEW32V6YNV11T33XGDR7TGWC/capture \\\n -H \"Content-Type: application/json\" \\\n -H \"APIKEY: YOUR-API-KEY\" \\\n -d '{ \"amount\": 2500 }'\n","lang":"shell"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3-handle-edge-cases","__idx":8},"children":["Step 3: Handle edge cases"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cancel-before-capture","__idx":9},"children":["Cancel before capture"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the order is canceled before capture, void the authorization to release the hold."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"shell","header":{"controls":{"copy":{}}},"source":"curl -X POST \\\n https://api.dev.paradisegateway.net/v1/transactions/TRANSACTION-01KEW32V6YNV11T33XGDR7TGWC/cancel \\\n -H \"Content-Type: application/json\" \\\n -H \"APIKEY: YOUR-API-KEY\"\n","lang":"shell"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"authorization-expired","__idx":10},"children":["Authorization expired"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Authorization holds typically expire after 7–10 days. If the hold expires before capture, you must create a new authorization."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"timing-rules","__idx":11},"children":["Timing rules"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"gantt\n title Auth/capture timeline\n dateFormat X\n axisFormat %s\n section Authorization\n Hold placed : 0, 1\n section Window\n Capture window (7-10 days) : 1, 10\n section Capture\n Capture or cancel : 10, 11\n","diagramHtml":"01234567891011Hold placed Capture window (7-10 days) Capture or cancel AuthorizationWindowCaptureAuth/capture timeline","diagramHtmlDark":"01234567891011Hold placed Capture window (7-10 days) Capture or cancel AuthorizationWindowCaptureAuth/capture timeline"},"children":["gantt\n title Auth/capture timeline\n dateFormat X\n axisFormat %s\n section Authorization\n Hold placed : 0, 1\n section Window\n Capture window (7-10 days) : 1, 10\n section Capture\n Capture or cancel : 10, 11\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":"Event"},"children":["Event"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Timing"},"children":["Timing"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Authorization created"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Immediate"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Hold placed on card"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Immediate"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Capture window"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["7–10 days (processor-dependent)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Settlement after capture"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Next batch close"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"best-practices","__idx":12},"children":["Best practices"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Capture promptly"]}," — don't let authorization holds expire. Capture as soon as you're ready."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Check AVS/CVV"]}," — review fraud signals on the auth response before fulfilling."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use metadata"]}," — attach your order ID to the transaction for reconciliation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Include idempotency keys"]}," — safe to retry if the capture request times out."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Log ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["correlation_id"]}]}," — include it in your order records for support requests."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"further-reading","__idx":13},"children":["Further reading"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/tutorials/payment-cookbook/auth-capture-ecommerce"},"children":["Auth/capture for e-commerce"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/how-tos/process-payments/handle-partial-capture"},"children":["Handle partial captures"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/how-tos/manage-transactions/cancel-auth"},"children":["Cancel an authorized transaction"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/transactions/sale-vs-auth"},"children":["Sale vs. authorization"]}]}]}]},"headings":[{"value":"Recipe: Authorize and capture","id":"recipe-authorize-and-capture","depth":1},{"value":"When to use two-step payments","id":"when-to-use-two-step-payments","depth":2},{"value":"Payment state lifecycle","id":"payment-state-lifecycle","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Step 1: Authorize","id":"step-1-authorize","depth":2},{"value":"Authorization response","id":"authorization-response","depth":3},{"value":"Step 2: Capture","id":"step-2-capture","depth":2},{"value":"Partial capture","id":"partial-capture","depth":3},{"value":"Step 3: Handle edge cases","id":"step-3-handle-edge-cases","depth":2},{"value":"Cancel before capture","id":"cancel-before-capture","depth":3},{"value":"Authorization expired","id":"authorization-expired","depth":3},{"value":"Timing rules","id":"timing-rules","depth":2},{"value":"Best practices","id":"best-practices","depth":2},{"value":"Further reading","id":"further-reading","depth":2}],"frontmatter":{"title":"Recipe: Authorize and capture","shortTitle":"Authorize and capture","intro":"Walk through the two-step payment flow — authorize to hold funds, then capture when ready to charge. Includes the full state lifecycle, edge cases, and timing considerations.","type":"tutorial","seo":{"title":""}},"lastModified":"2026-06-05T02:46:44.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/tutorials/payment-cookbook/authorize-and-capture","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}