{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":["tabs","tab"]},"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-ach-payouts","__idx":0},"children":["Recipe: ACH payouts"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"when-to-use-ach-payouts","__idx":1},"children":["When to use ACH payouts"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Pay vendors or contractors"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Disburse marketplace seller earnings"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Issue refunds directly to a bank account"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"flow","__idx":2},"children":["Flow"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"---\nconfig:\n theme: 'neutral'\n---\nsequenceDiagram\n participant Merchant\n participant API as Paradise Gateway\n participant Bank as Recipient's Bank\n Merchant->>API: POST /v1/transactions (type: payout)\n API-->>Merchant: approved\n API->>Bank: ACH credit initiated\n Bank-->>API: Settled (2-3 business days)\n","diagramHtml":"Recipient's BankParadise GatewayMerchantRecipient's BankParadise GatewayMerchantPOST /v1/transactions (type: payout)approvedACH credit initiatedSettled (2-3 business days)","diagramHtmlDark":"Recipient's BankParadise GatewayMerchantRecipient's BankParadise GatewayMerchantPOST /v1/transactions (type: payout)approvedACH credit initiatedSettled (2-3 business days)"},"children":["---\nconfig:\n theme: 'neutral'\n---\nsequenceDiagram\n participant Merchant\n participant API as Paradise Gateway\n participant Bank as Recipient's Bank\n Merchant->>API: POST /v1/transactions (type: payout)\n API-->>Merchant: approved\n API->>Bank: ACH credit initiated\n Bank-->>API: Settled (2-3 business days)\n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-tokenize-the-recipients-bank-account","__idx":3},"children":["Step 1: Tokenize the recipient's bank account"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you haven't stored the recipient's bank account yet, create a token first."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"shell","header":{"controls":{"copy":{}}},"source":"curl -X POST \\\n https://api.dev.paradisegateway.net/v1/payment_tokens \\\n -H \"Content-Type: application/json\" \\\n -H \"APIKEY: YOUR-API-KEY\" \\\n -d '{\n \"customer_id\": \"CUSTOMER-VENDOR-001\",\n \"nickname\": \"Vendor - ABC Supplies\",\n \"bank_account\": {\n \"routing_number\": \"021000021\",\n \"account_number\": \"987654321098\",\n \"account_type\": \"checking\",\n \"name\": \"ABC Supplies LLC\",\n \"email\": \"payments@abcsupplies.example.com\"\n }\n }'\n","lang":"shell"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-send-the-payout","__idx":4},"children":["Step 2: Send the payout"]},{"$$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\": \"payout\",\n \"amount\": 150000,\n \"payment_method\": {\n \"type\": \"payment_token\",\n \"payment_token\": \"PAYMENT_TOKEN-VENDOR-ABC001\"\n },\n \"metadata\": {\n \"payout_reason\": \"vendor_payment\",\n \"invoice_ref\": \"PO-2026-0099\"\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 = \"https://api.dev.paradisegateway.net\"\n\nresp = requests.post(\n f\"{BASE}/v1/transactions\",\n headers={\"Content-Type\": \"application/json\", \"APIKEY\": API_KEY},\n json={\n \"type\": \"payout\",\n \"amount\": 150000,\n \"payment_method\": {\n \"type\": \"payment_token\",\n \"payment_token\": \"PAYMENT_TOKEN-VENDOR-ABC001\",\n },\n \"metadata\": {\n \"payout_reason\": \"vendor_payment\",\n \"invoice_ref\": \"PO-2026-0099\",\n },\n },\n)\npayout = resp.json()\nprint(f\"Payout {payout['id']}: {payout['response_status']}\")\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 = \"https://api.dev.paradisegateway.net\";\n\nconst resp = await fetch(`${BASE}/v1/transactions`, {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\", \"APIKEY\": API_KEY },\n body: JSON.stringify({\n type: \"payout\",\n amount: 150000,\n payment_method: {\n type: \"payment_token\",\n payment_token: \"PAYMENT_TOKEN-VENDOR-ABC001\",\n },\n metadata: {\n payout_reason: \"vendor_payment\",\n invoice_ref: \"PO-2026-0099\",\n },\n }),\n});\nconst payout = await resp.json();\nconsole.log(`Payout ${payout.id}: ${payout.response_status}`);\n","lang":"javascript"},"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 \"id\": \"TRANSACTION-03MFHISS2CZTP7XSZ2U4I5DE\",\n \"type\": \"payout\",\n \"amount\": 150000,\n \"transaction_state\": \"authorized\",\n \"response_status\": \"approved\",\n \"response_code\": \"00\",\n \"correlation_id\": \"d4e5f6a7-b8c9-0123-def0-1234567890ab\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3-confirm-settlement","__idx":6},"children":["Step 3: Confirm settlement"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Monitor the transaction state. Payouts settle in 2–3 business days."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"shell","header":{"controls":{"copy":{}}},"source":"curl https://api.dev.paradisegateway.net/v1/transactions/TRANSACTION-03MFHISS2CZTP7XSZ2U4I5DE \\\n -H \"APIKEY: YOUR-API-KEY\"\n","lang":"shell"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"payments-vs-payouts","__idx":7},"children":["Payments vs. payouts"]},{"$$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":""},"children":[]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Payment (debit)"},"children":["Payment (debit)"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Payout (credit)"},"children":["Payout (credit)"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Direction"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Customer → Merchant"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Merchant → Recipient"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Transaction type"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sale"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payout"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Use case"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Collect invoice payment"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Pay vendor/contractor"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Returns"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Customer may dispute"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Recipient bank may reject"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cancel-a-payout","__idx":8},"children":["Cancel a payout"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the payout has not yet settled, you can cancel it."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"shell","header":{"controls":{"copy":{}}},"source":"curl -X POST \\\n https://api.dev.paradisegateway.net/v1/transactions/TRANSACTION-03MFHISS2CZTP7XSZ2U4I5DE/cancel \\\n -H \"Content-Type: application/json\" \\\n -H \"APIKEY: YOUR-API-KEY\" \\\n -d '{ \"type\": \"cancel\", \"amount\": 150000 }'\n","lang":"shell"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"best-practices","__idx":9},"children":["Best practices"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Verify the recipient"]}," — confirm the bank account belongs to the intended recipient before sending funds"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use metadata"]}," — attach ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payout_reason"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invoice_ref"]}," for audit and reconciliation"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Monitor for returns"]}," — ACH credits can be returned if the account is closed or invalid. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/tutorials/payment-cookbook/auth-returns"},"children":["ACH returns"]}]}]},{"$$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/tutorials/payment-cookbook/ach-for-invoices"},"children":["ACH for invoices"]}," — collect payments via ACH debit"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/tutorials/payment-cookbook/auth-returns"},"children":["ACH returns"]}," — handle return scenarios"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/how-tos/process-payments/process-ach-payout"},"children":["Process an ACH payout (how-to)"]}]}]}]},"headings":[{"value":"Recipe: ACH payouts","id":"recipe-ach-payouts","depth":1},{"value":"When to use ACH payouts","id":"when-to-use-ach-payouts","depth":2},{"value":"Flow","id":"flow","depth":2},{"value":"Step 1: Tokenize the recipient's bank account","id":"step-1-tokenize-the-recipients-bank-account","depth":2},{"value":"Step 2: Send the payout","id":"step-2-send-the-payout","depth":2},{"value":"Response","id":"response","depth":3},{"value":"Step 3: Confirm settlement","id":"step-3-confirm-settlement","depth":2},{"value":"Payments vs. payouts","id":"payments-vs-payouts","depth":2},{"value":"Cancel a payout","id":"cancel-a-payout","depth":2},{"value":"Best practices","id":"best-practices","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"title":"Recipe: ACH payouts","shortTitle":"ACH payouts","intro":"Send funds to a vendor, contractor, or customer via ACH credit (payout). Common uses include vendor payments, refunds-to-bank, and marketplace disbursements.","type":"tutorial","seo":{"title":""}},"lastModified":"2026-06-05T02:46:44.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/tutorials/payment-cookbook/ach-payouts","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}