{"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-for-invoices","__idx":0},"children":["Recipe: ACH for invoices"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"when-to-use-ach-for-invoices","__idx":1},"children":["When to use ACH for invoices"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["B2B payments where customers pay by bank transfer"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Recurring invoices (rent, subscriptions, memberships)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["High-value transactions where card fees would be significant"]}]},{"$$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 Customer's Bank\n Merchant->>API: POST /v1/payment_tokens (tokenize bank account)\n API-->>Merchant: payment_token\n Note over Merchant: Invoice generated\n Merchant->>API: POST /v1/transactions (bank_account_payment)\n API-->>Merchant: approved (pending settlement)\n API->>Bank: ACH debit initiated\n Bank-->>API: Settled (2-3 business days)\n","diagramHtml":"Customer's BankParadise GatewayMerchantCustomer's BankParadise GatewayMerchantInvoice generatedPOST /v1/payment_tokens (tokenize bank account)payment_tokenPOST /v1/transactions (bank_account_payment)approved (pending settlement)ACH debit initiatedSettled (2-3 business days)","diagramHtmlDark":"Customer's BankParadise GatewayMerchantCustomer's BankParadise GatewayMerchantInvoice generatedPOST /v1/payment_tokens (tokenize bank account)payment_tokenPOST /v1/transactions (bank_account_payment)approved (pending settlement)ACH debit 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 Customer's Bank\n Merchant->>API: POST /v1/payment_tokens (tokenize bank account)\n API-->>Merchant: payment_token\n Note over Merchant: Invoice generated\n Merchant->>API: POST /v1/transactions (bank_account_payment)\n API-->>Merchant: approved (pending settlement)\n API->>Bank: ACH debit initiated\n Bank-->>API: Settled (2-3 business days)\n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-tokenize-the-customers-bank-account","__idx":3},"children":["Step 1: Tokenize the customer's bank account"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Store the customer's bank account once. Use the token for all future invoice payments."]},{"$$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/payment_tokens \\\n -H \"Content-Type: application/json\" \\\n -H \"APIKEY: YOUR-API-KEY\" \\\n -d '{\n \"customer_id\": \"CUSTOMER-01KFDKXMQ637EKEAY410MSQSXB\",\n \"nickname\": \"Acme Corp Checking\",\n \"bank_account\": {\n \"routing_number\": \"021000021\",\n \"account_number\": \"123456789012\",\n \"account_type\": \"checking\",\n \"name\": \"Acme Corporation\",\n \"email\": \"ap@acmecorp.example.com\"\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\ntoken_resp = requests.post(\n f\"{BASE}/v1/payment_tokens\",\n headers={\"Content-Type\": \"application/json\", \"APIKEY\": API_KEY},\n json={\n \"customer_id\": \"CUSTOMER-01KFDKXMQ637EKEAY410MSQSXB\",\n \"nickname\": \"Acme Corp Checking\",\n \"bank_account\": {\n \"routing_number\": \"021000021\",\n \"account_number\": \"123456789012\",\n \"account_type\": \"checking\",\n \"name\": \"Acme Corporation\",\n \"email\": \"ap@acmecorp.example.com\",\n },\n },\n)\npayment_token = token_resp.json()[\"payment_token\"]\nprint(f\"Token: {payment_token}\")\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 tokenResp = await fetch(`${BASE}/v1/payment_tokens`, {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\", \"APIKEY\": API_KEY },\n body: JSON.stringify({\n customer_id: \"CUSTOMER-01KFDKXMQ637EKEAY410MSQSXB\",\n nickname: \"Acme Corp Checking\",\n bank_account: {\n routing_number: \"021000021\",\n account_number: \"123456789012\",\n account_type: \"checking\",\n name: \"Acme Corporation\",\n email: \"ap@acmecorp.example.com\",\n },\n }),\n});\nconst { payment_token } = await tokenResp.json();\nconsole.log(`Token: ${payment_token}`);\n","lang":"javascript"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-process-the-invoice-payment","__idx":4},"children":["Step 2: Process the invoice payment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the invoice is due, debit the customer's bank account using the stored token."]},{"$$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\": \"sale\",\n \"amount\": 250000,\n \"payment_method\": {\n \"type\": \"payment_token\",\n \"payment_token\": \"PAYMENT_TOKEN-02LGEHBA0BZSPA6WRY1T3H4CD\"\n },\n \"metadata\": {\n \"invoice_id\": \"INV-2026-0042\"\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":"txn_resp = requests.post(\n f\"{BASE}/v1/transactions\",\n headers={\"Content-Type\": \"application/json\", \"APIKEY\": API_KEY},\n json={\n \"type\": \"sale\",\n \"amount\": 250000,\n \"payment_method\": {\n \"type\": \"payment_token\",\n \"payment_token\": payment_token,\n },\n \"metadata\": {\"invoice_id\": \"INV-2026-0042\"},\n },\n)\ntxn = txn_resp.json()\nprint(f\"Status: {txn['response_status']}, ID: {txn['id']}\")\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 txnResp = await fetch(`${BASE}/v1/transactions`, {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\", \"APIKEY\": API_KEY },\n body: JSON.stringify({\n type: \"sale\",\n amount: 250000,\n payment_method: { type: \"payment_token\", payment_token },\n metadata: { invoice_id: \"INV-2026-0042\" },\n }),\n});\nconst txn = await txnResp.json();\nconsole.log(`Status: ${txn.response_status}, ID: ${txn.id}`);\n","lang":"javascript"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3-track-settlement","__idx":5},"children":["Step 3: Track settlement"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ACH transactions settle in 2–3 business days. Poll the transaction or check batch status to confirm."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"shell","header":{"controls":{"copy":{}}},"source":"curl https://api.dev.paradisegateway.net/v1/transactions/TRANSACTION-01KEW32V6YNV11T33XGDR7TGWC \\\n -H \"APIKEY: YOUR-API-KEY\"\n","lang":"shell"},"children":[]},{"$$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":"State"},"children":["State"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Meaning"},"children":["Meaning"]}]}]},{"$$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":["authorized"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["ACH debit submitted to the network"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["completed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Funds transfer completed"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["settled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Funds deposited to your account"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["ACH return received (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/tutorials/payment-cookbook/auth-returns"},"children":["ACH returns"]},")"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ach-vs-card-payments-for-invoices","__idx":6},"children":["ACH vs. card payments for invoices"]},{"$$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":"Factor"},"children":["Factor"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"ACH"},"children":["ACH"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Card"},"children":["Card"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Processing fee"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Flat fee (lower)"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Percentage + flat fee (higher)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Settlement time"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["2–3 business days"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Next business day"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Chargebacks"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["ACH returns (limited window)"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Card disputes (longer window)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Best for"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["High-value, recurring B2B"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Consumer, low-value"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"best-practices","__idx":7},"children":["Best practices"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Store the token once"]}," — reuse for every invoice to avoid re-collecting bank details"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use metadata"]}," — attach ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invoice_id"]}," for reconciliation"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Handle returns"]}," — ACH debits can be returned for up to 60 days. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/tutorials/payment-cookbook/auth-returns"},"children":["ACH returns"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Notify the customer"]}," — send an email when the debit is initiated and another when it settles"]}]},{"$$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/tutorials/payment-cookbook/ach-payouts"},"children":["ACH payouts"]}," — send funds to vendors"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/tutorials/payment-cookbook/auth-returns"},"children":["ACH returns"]}," — handle returned debits"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/transactions/ach-accounts"},"children":["About ACH payments"]}]}]}]},"headings":[{"value":"Recipe: ACH for invoices","id":"recipe-ach-for-invoices","depth":1},{"value":"When to use ACH for invoices","id":"when-to-use-ach-for-invoices","depth":2},{"value":"Flow","id":"flow","depth":2},{"value":"Step 1: Tokenize the customer's bank account","id":"step-1-tokenize-the-customers-bank-account","depth":2},{"value":"Step 2: Process the invoice payment","id":"step-2-process-the-invoice-payment","depth":2},{"value":"Step 3: Track settlement","id":"step-3-track-settlement","depth":2},{"value":"ACH vs. card payments for invoices","id":"ach-vs-card-payments-for-invoices","depth":2},{"value":"Best practices","id":"best-practices","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"title":"Recipe: ACH for invoices","shortTitle":"ACH for invoices","intro":"Collect invoice payments via ACH bank debits — lower cost than card processing and well-suited for B2B and recurring billing scenarios.","type":"tutorial","seo":{"title":""}},"lastModified":"2026-06-05T02:46:44.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/tutorials/payment-cookbook/ach-for-invoices","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}