{"templateId":"markdown","sharedDataIds":{"oas-apis/openapi.yaml":"oas-apis/openapi.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","openapi-code-sample"]},"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":["openapi"],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"about-achbank-account-payments","__idx":0},"children":["About ACH/bank account payments"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-is-ach","__idx":1},"children":["What is ACH"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Automated Clearing House (ACH) is a US payment network that processes electronic fund transfers between bank accounts. Unlike card payments that authorize in real time through card networks, ACH transactions are batched and cleared through the Federal Reserve or The Clearing House."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Paradise Gateway processes ACH payments through the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Vericheck"]}," processor."]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"---\nconfig:\n theme: 'neutral'\n---\nsequenceDiagram\n autonumber\n \n participant App as Your Application\n \n rect rgb(232, 241, 250)\n Note over App, GW: My Paradise Pay (Real-time)\n participant GW as My Paradise Pay\n end\n \n participant Proc as Processor (Vericheck)\n participant ACH as ACH Network\n participant Bank as Person's Bank\n\n App->>GW: POST /v1/transactions\n activate GW\n GW->>Proc: ACH Request\n activate Proc\n Proc-->>GW: Accepted (Synchronous)\n deactivate Proc\n GW-->>App: 200 OK (authorized)\n deactivate GW\n\n Note over Proc, Bank: Asynchronous Processing (1-3 Days)\n Proc->>ACH: Batch Submission\n activate ACH\n ACH->>Bank: Debit/Credit Request\n activate Bank\n Bank-->>ACH: Funds Settled\n deactivate Bank\n deactivate ACH\n Note right of Bank: OR Transaction Returned\n\n","diagramHtml":"Person's BankACH NetworkProcessor (Vericheck)My Paradise PayYour ApplicationPerson's BankACH NetworkProcessor (Vericheck)My Paradise PayYour ApplicationMy Paradise Pay (Real-time)Asynchronous Processing (1-3 Days)OR Transaction ReturnedPOST /v1/transactions1ACH Request2Accepted (Synchronous)3200 OK (authorized)4Batch Submission5Debit/Credit Request6Funds Settled7","diagramHtmlDark":"Person's BankACH NetworkProcessor (Vericheck)My Paradise PayYour ApplicationPerson's BankACH NetworkProcessor (Vericheck)My Paradise PayYour ApplicationMy Paradise Pay (Real-time)Asynchronous Processing (1-3 Days)OR Transaction ReturnedPOST /v1/transactions1ACH Request2Accepted (Synchronous)3200 OK (authorized)4Batch Submission5Debit/Credit Request6Funds Settled7"},"children":["---\nconfig:\n theme: 'neutral'\n---\nsequenceDiagram\n autonumber\n \n participant App as Your Application\n \n rect rgb(232, 241, 250)\n Note over App, GW: My Paradise Pay (Real-time)\n participant GW as My Paradise Pay\n end\n \n participant Proc as Processor (Vericheck)\n participant ACH as ACH Network\n participant Bank as Person's Bank\n\n App->>GW: POST /v1/transactions\n activate GW\n GW->>Proc: ACH Request\n activate Proc\n Proc-->>GW: Accepted (Synchronous)\n deactivate Proc\n GW-->>App: 200 OK (authorized)\n deactivate GW\n\n Note over Proc, Bank: Asynchronous Processing (1-3 Days)\n Proc->>ACH: Batch Submission\n activate ACH\n ACH->>Bank: Debit/Credit Request\n activate Bank\n Bank-->>ACH: Funds Settled\n deactivate Bank\n deactivate ACH\n Note right of Bank: OR Transaction Returned\n\n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ach-transaction-types","__idx":2},"children":["ACH transaction types"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Paradise Gateway supports two ACH Standard Entry Class (SEC) codes that determine how the payment was authorized."]},{"$$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":"SEC code"},"children":["SEC code"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Name"},"children":["Name"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Use case"},"children":["Use case"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Authorization method"},"children":["Authorization method"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["WEB"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Internet-initiated"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Person authorizes payment through a website or app"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Online consent form, checkbox, or click-through agreement"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PPD"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Prearranged payment and deposit"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Recurring payments authorized by written agreement"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Signed authorization form (physical or electronic)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"SEC code compliance"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Using the correct SEC code is a NACHA requirement. Using the wrong code can result in fines or ACH processing suspension. Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WEB"]}," for internet-originated transactions and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PPD"]}," for pre-authorized recurring payments with a signed agreement."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"processing-an-ach-payment","__idx":3},"children":["Processing an ACH payment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/transactions"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type: PAYMENT"]}," and the person's bank account details."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"required-fields","__idx":4},"children":["Required 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":"th","attributes":{"align":"left","data-label":"Example"},"children":["Example"]}]}]},{"$$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":["type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Transaction type"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYMENT"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Amount in cents"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["50000"]}," (500.00 USD)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_method.type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Payment method type"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACH"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_method.account_number"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Bank account number"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["9876543210"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_method.routing_number"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["ABA routing number (9 digits)"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["021000021"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_method.account_type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Account type"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checking"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["savings"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_method.name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Account holder name"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Montgomery Scott"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_method.email"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Account holder email"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["scotty@example.com"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request","__idx":5},"children":["Example request"]},{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-apis/openapi.yaml","operationId":"createTransaction","parameters":{},"requestBody":{"type":"PAYMENT","amount":50000,"payment_method":{"type":"ACH","account_number":"9876543210","routing_number":"021000021","account_type":"Checking","name":"Montgomery Scott","email":"scotty@example.com"},"recurring":false,"purchase_description":"Monthly service fee"},"environments":{},"codeSamplesResolved":[{"lang":"shell","title":"cURL","source":"curl -i -X POST \\\n https://api.dev.paradisegateway.net/v1/transactions \\\n -H 'Api-Key: YOUR_API_KEY_HERE' \\\n -H 'Client-Id: CLIENT-01KFDKXMQ637EKEAY410MSQSXB' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"type\": \"PAYMENT\",\n \"amount\": 50000,\n \"payment_method\": {\n \"type\": \"ACH\",\n \"account_number\": \"9876543210\",\n \"routing_number\": \"021000021\",\n \"account_type\": \"Checking\",\n \"name\": \"Montgomery Scott\",\n \"email\": \"scotty@example.com\"\n },\n \"recurring\": false,\n \"purchase_description\": \"Monthly service fee\"\n }'"},{"lang":"javascript","title":"JS","source":"const resp = await fetch(\n `https://api.dev.paradisegateway.net/v1/transactions`,\n {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n 'Client-Id': 'CLIENT-01KFDKXMQ637EKEAY410MSQSXB',\n 'Api-Key': 'YOUR_API_KEY_HERE'\n },\n body: JSON.stringify({\n type: 'PAYMENT',\n amount: 50000,\n payment_method: {\n type: 'ACH',\n account_number: '9876543210',\n routing_number: '021000021',\n account_type: 'Checking',\n name: 'Montgomery Scott',\n email: 'scotty@example.com'\n },\n recurring: false,\n purchase_description: 'Monthly service fee'\n })\n }\n);\n\nconst data = await resp.json();\nconsole.log(data);"},{"lang":"csharp","title":"C#","source":"using System;\nusing System.Net.Http;\nusing System.Threading.Tasks;\nusing System.Text;\nusing System.Text.Json;\n\npublic class Program\n{\n public static async Task Main()\n {\n System.Net.Http.HttpClient client = new()\n {\n DefaultRequestHeaders =\n {\n {\"Client-Id\", \"CLIENT-01KFDKXMQ637EKEAY410MSQSXB\"},\n {\"Api-Key\", \"YOUR_API_KEY_HERE\"},\n }\n };\n\n string json = JsonSerializer.Serialize(new\n {\n type = \"PAYMENT\",\n amount = \"50000\",\n payment_method = new {\n type = \"ACH\",\n account_number = \"9876543210\",\n routing_number = \"021000021\",\n account_type = \"Checking\",\n name = \"Montgomery Scott\",\n email = \"scotty@example.com\"\n },\n recurring = \"false\",\n purchase_description = \"Monthly service fee\"\n });\n\n using StringContent postData = new(json, Encoding.UTF8, \"application/json\");\n using HttpResponseMessage request = await client.PostAsync(\"https://api.dev.paradisegateway.net/v1/transactions\", postData);\n string response = await request.Content.ReadAsStringAsync();\n\n Console.WriteLine(response);\n }\n}"},{"lang":"python","title":"Python","source":"import requests\n\nurl = \"https://api.dev.paradisegateway.net/v1/transactions\"\n\npayload = {\n \"type\": \"PAYMENT\",\n \"amount\": 50000,\n \"payment_method\": {\n \"type\": \"ACH\",\n \"account_number\": \"9876543210\",\n \"routing_number\": \"021000021\",\n \"account_type\": \"Checking\",\n \"name\": \"Montgomery Scott\",\n \"email\": \"scotty@example.com\"\n },\n \"recurring\": False,\n \"purchase_description\": \"Monthly service fee\"\n}\n\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Client-Id\": \"CLIENT-01KFDKXMQ637EKEAY410MSQSXB\",\n \"Api-Key\": \"YOUR_API_KEY_HERE\"\n}\n\nresponse = requests.post(url, json=payload, headers=headers)\n\ndata = response.json()\nprint(data)"},{"lang":"go","title":"Go","source":"package main\n\nimport (\n \"fmt\"\n \"bytes\"\n \"net/http\"\n \"io/ioutil\"\n)\n\nfunc main() {\n reqUrl := \"https://api.dev.paradisegateway.net/v1/transactions\"\n var data = []byte(`{\n \"type\": \"PAYMENT\",\n \"amount\": 50000,\n \"payment_method\": {\n \"type\": \"ACH\",\n \"account_number\": \"9876543210\",\n \"routing_number\": \"021000021\",\n \"account_type\": \"Checking\",\n \"name\": \"Montgomery Scott\",\n \"email\": \"scotty@example.com\"\n },\n \"recurring\": false,\n \"purchase_description\": \"Monthly service fee\"\n }`)\n req, err := http.NewRequest(\"POST\", reqUrl, bytes.NewBuffer(data))\n if err != nil {\n panic(err)\n }\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"Client-Id\", \"CLIENT-01KFDKXMQ637EKEAY410MSQSXB\")\n req.Header.Add(\"Api-Key\", \"YOUR_API_KEY_HERE\")\n res, err := http.DefaultClient.Do(req)\n if err != nil {\n panic(err)\n }\n defer res.Body.Close()\n body, err := ioutil.ReadAll(res.Body)\n if err != nil {\n panic(err)\n }\n\n fmt.Println(res)\n fmt.Println(string(body))\n}"},{"lang":"ruby","title":"Ruby","source":"require 'json'\nrequire 'uri'\nrequire 'net/http'\nrequire 'openssl'\n\nurl = URI('https://api.dev.paradisegateway.net/v1/transactions')\n\nhttp = Net::HTTP.new(url.host, url.port)\nhttp.use_ssl = true\n\nrequest = Net::HTTP::Post.new(url)\nrequest['Content-Type'] = 'application/json'\nrequest['Client-Id'] = 'CLIENT-01KFDKXMQ637EKEAY410MSQSXB'\nrequest['Api-Key'] = 'YOUR_API_KEY_HERE'\nrequest.body = {\n type: 'PAYMENT',\n amount: 50000,\n payment_method: {\n type: 'ACH',\n account_number: '9876543210',\n routing_number: '021000021',\n account_type: 'Checking',\n name: 'Montgomery Scott',\n email: 'scotty@example.com'\n },\n recurring: false,\n purchase_description: 'Monthly service fee'\n}.to_json\n\nresponse = http.request(request)\nputs response.read_body\n"},{"lang":"java","title":"Java","source":"import java.net.*;\nimport java.net.http.*;\nimport java.util.*;\n\npublic class App {\n public static void main(String[] args) throws Exception {\n var httpClient = HttpClient.newBuilder().build();\n\n var payload = String.join(\"\\n\"\n , \"{\"\n , \" \\\"type\\\": \\\"PAYMENT\\\",\"\n , \" \\\"amount\\\": 50000,\"\n , \" \\\"payment_method\\\": {\"\n , \" \\\"type\\\": \\\"ACH\\\",\"\n , \" \\\"account_number\\\": \\\"9876543210\\\",\"\n , \" \\\"routing_number\\\": \\\"021000021\\\",\"\n , \" \\\"account_type\\\": \\\"Checking\\\",\"\n , \" \\\"name\\\": \\\"Montgomery Scott\\\",\"\n , \" \\\"email\\\": \\\"scotty@example.com\\\"\"\n , \" },\"\n , \" \\\"recurring\\\": false,\"\n , \" \\\"purchase_description\\\": \\\"Monthly service fee\\\"\"\n , \"}\"\n );\n\n var host = \"https://api.dev.paradisegateway.net\";\n var pathname = \"/v1/transactions\";\n var request = HttpRequest.newBuilder()\n .POST(HttpRequest.BodyPublishers.ofString(payload))\n .uri(URI.create(host + pathname ))\n .header(\"Content-Type\", \"application/json\")\n .header(\"Client-Id\", \"CLIENT-01KFDKXMQ637EKEAY410MSQSXB\")\n .header(\"Api-Key\", \"YOUR_API_KEY_HERE\")\n .build();\n\n var response = httpClient.send(request, HttpResponse.BodyHandlers.ofString());\n\n System.out.println(response.body());\n }\n}"},{"lang":"javascript","title":"Node.js","source":"import fetch from 'node-fetch';\n\nasync function run() {\n const resp = await fetch(\n `https://api.dev.paradisegateway.net/v1/transactions`,\n {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n 'Client-Id': 'CLIENT-01KFDKXMQ637EKEAY410MSQSXB',\n 'Api-Key': 'YOUR_API_KEY_HERE'\n },\n body: JSON.stringify({\n type: 'PAYMENT',\n amount: 50000,\n payment_method: {\n type: 'ACH',\n account_number: '9876543210',\n routing_number: '021000021',\n account_type: 'Checking',\n name: 'Montgomery Scott',\n email: 'scotty@example.com'\n },\n recurring: false,\n purchase_description: 'Monthly service fee'\n })\n }\n );\n\n const data = await resp.json();\n console.log(data);\n}\n\nrun();"},{"lang":"php","title":"PHP","source":"/**\n * Requires libcurl\n */\n\n$curl = curl_init();\n\n$payload = array(\n \"type\" => \"PAYMENT\",\n \"amount\" => 50000,\n \"payment_method\" => array(\n \"type\" => \"ACH\",\n \"account_number\" => \"9876543210\",\n \"routing_number\" => \"021000021\",\n \"account_type\" => \"Checking\",\n \"name\" => \"Montgomery Scott\",\n \"email\" => \"scotty@example.com\"\n ),\n \"recurring\" => false,\n \"purchase_description\" => \"Monthly service fee\"\n);\n\ncurl_setopt_array($curl, [\n CURLOPT_HTTPHEADER => [\n \"Api-Key: YOUR_API_KEY_HERE\",\n \"Client-Id: CLIENT-01KFDKXMQ637EKEAY410MSQSXB\",\n \"Content-Type: application/json\"\n ],\n CURLOPT_POSTFIELDS => json_encode($payload),\n CURLOPT_URL => \"https://api.dev.paradisegateway.net/v1/transactions\",\n CURLOPT_RETURNTRANSFER => true,\n CURLOPT_CUSTOMREQUEST => \"POST\",\n]);\n\n$response = curl_exec($curl);\n$error = curl_error($curl);\n\ncurl_close($curl);\n\nif ($error) {\n echo \"cURL Error #:\" . $error;\n} else {\n echo $response;\n}"},{"lang":"r","title":"R","source":"library(httr)\n\nbody = '{\n \"type\": \"PAYMENT\",\n \"amount\": 50000,\n \"payment_method\": {\n \"type\": \"ACH\",\n \"account_number\": \"9876543210\",\n \"routing_number\": \"021000021\",\n \"account_type\": \"Checking\",\n \"name\": \"Montgomery Scott\",\n \"email\": \"scotty@example.com\"\n },\n \"recurring\": false,\n \"purchase_description\": \"Monthly service fee\"\n}'\n\nurl = \"https://api.dev.paradisegateway.net/v1/transactions\"\n\ndata_req <- POST(\n url,\n add_headers(\"Content-Type\" = \"application/json\", \"Client-Id\" = \"CLIENT-01KFDKXMQ637EKEAY410MSQSXB\", \"Api-Key\" = \"YOUR_API_KEY_HERE\"),\n body = body,\n encode = \"json\",\n verbose()\n)\n\ncontent(data_req)"}]},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-response","__idx":6},"children":["Example response"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"id\": \"TRANSACTION-03LPSC0TTY9ZXQ5MV0H4Y6W8A\",\n \"object\": \"transaction\",\n \"type\": \"payment\",\n \"transaction_state\": \"authorized\",\n \"response_status\": \"Approved\",\n \"response_code\": \"00\",\n \"response_message\": \"The API request is approved.\",\n \"amount_requested\": 50000,\n \"amount_authorized\": 50000,\n \"correlation_id\": \"d4e5f6a7-b8c9-0123-def0-123456789abc\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The transaction returns immediately with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authorized"]}," state. This does not mean the funds have been transferred — the ACH network processes the debit asynchronously."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ach-vs-card-payment-timeline","__idx":7},"children":["ACH vs. card payment timeline"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ACH transactions settle more slowly than card transactions because the ACH network processes in scheduled batches rather than in real time."]},{"$$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":"Card (TSYS)"},"children":["Card (TSYS)"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"ACH (Vericheck)"},"children":["ACH (Vericheck)"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Authorization"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Real-time (< 3 seconds)"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Immediate API response (validation only)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Batch submitted"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["End of business day"]},{"$$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":["Funds settled"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["1–2 business days"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["2–3 business days"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Returns possible"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Not applicable (chargebacks instead)"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Up to 60 days"]}]}]}]}]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"%%{init: { 'flowchart': { 'nodeSpacing': 180, 'rankSpacing': 100 } } }%%\nflowchart LR\n %% Phases\n subgraph Day0 [Day 0]\n Req[[API Request]]\n end\n\n subgraph Day1 [Day 1]\n Proc{{Submit to ACH}}\n end\n\n subgraph Day2_3 [Day 2-3]\n Settle[/\"Funds Settle\"\\]\n end\n\n subgraph Window [Days 3-60]\n Risk([Return Window])\n end\n\n %% Progression\n Req -->|\"Synchronous\"| Proc\n Proc -->|\"Standard Rail\"| Settle\n Settle -.->|\"Consumer Right to Dispute\"| Risk\n\n %% Styling (aligned with @theme/styles.css)\n classDef brand fill:#1D80C3,color:#fff,stroke:#022D4B,stroke-width:2px\n classDef accent fill:#F05A26,color:#fff,stroke:#022D4B,stroke-width:1px\n classDef neutral fill:#E8F1FA,color:#022D4B,stroke:#1D80C3,stroke-width:1px\n classDef alert fill:#FFF,stroke:#F05A26,stroke-width:2px,stroke-dasharray: 5 5\n\n class Req,Proc brand\n class Settle accent\n class Risk alert\n\n","diagramHtml":"

Days 3-60

Day 2-3

Day 1

Day 0

Synchronous

Standard Rail

Consumer Right to Dispute

API Request

Submit to ACH

Funds Settle

Return Window

","diagramHtmlDark":"

Days 3-60

Day 2-3

Day 1

Day 0

Synchronous

Standard Rail

Consumer Right to Dispute

API Request

Submit to ACH

Funds Settle

Return Window

"},"children":["%%{init: { 'flowchart': { 'nodeSpacing': 180, 'rankSpacing': 100 } } }%%\nflowchart LR\n %% Phases\n subgraph Day0 [Day 0]\n Req[[API Request]]\n end\n\n subgraph Day1 [Day 1]\n Proc{{Submit to ACH}}\n end\n\n subgraph Day2_3 [Day 2-3]\n Settle[/\"Funds Settle\"\\]\n end\n\n subgraph Window [Days 3-60]\n Risk([Return Window])\n end\n\n %% Progression\n Req -->|\"Synchronous\"| Proc\n Proc -->|\"Standard Rail\"| Settle\n Settle -.->|\"Consumer Right to Dispute\"| Risk\n\n %% Styling (aligned with @theme/styles.css)\n classDef brand fill:#1D80C3,color:#fff,stroke:#022D4B,stroke-width:2px\n classDef accent fill:#F05A26,color:#fff,stroke:#022D4B,stroke-width:1px\n classDef neutral fill:#E8F1FA,color:#022D4B,stroke:#1D80C3,stroke-width:1px\n classDef alert fill:#FFF,stroke:#F05A26,stroke-width:2px,stroke-dasharray: 5 5\n\n class Req,Proc brand\n class Settle accent\n class Risk alert\n\n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ach-returns","__idx":8},"children":["ACH returns"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Unlike card chargebacks, ACH transactions can be ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["returned"]}," by the receiving bank after settlement. Returns can happen for several reasons."]},{"$$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":"Return code"},"children":["Return code"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Reason"},"children":["Reason"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Timeline"},"children":["Timeline"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["R01"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Insufficient funds"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["2 business days"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["R02"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Account closed"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["2 business days"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["R03"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No account / unable to locate"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["2 business days"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["R04"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Invalid account number"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["2 business days"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["R08"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Payment stopped"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["2 business days"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["R10"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Customer advises not authorized"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Up to 60 days"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["R29"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Corporate customer advises not authorized"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["2 business days"]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Handling returns"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Because ACH returns can occur days or weeks after settlement, build your system to handle asynchronous return notifications. Monitor transaction status through ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/transactions/{id}"]}," or configure webhooks to receive return notifications."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ach-payouts","__idx":9},"children":["ACH payouts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In addition to collecting payments, Paradise Gateway supports ACH payouts — sending funds ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["to"]}," a bank account. Payouts use the same endpoint with a different transaction type."]},{"$$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":"Direction"},"children":["Direction"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Transaction type"},"children":["Transaction 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":["Inbound (collect)"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Debit the person's bank account"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Outbound (pay)"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payout"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Credit the person's bank account"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"canceling-ach-transactions","__idx":10},"children":["Canceling ACH transactions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ACH transactions can be canceled before settlement using the cancel endpoint."]},{"$$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":"Original type"},"children":["Original type"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Cancel type"},"children":["Cancel type"]}]}]},{"$$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":["payment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cancel"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payout"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cancel"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After settlement, ACH reversals go through the ACH return process rather than API-initiated refunds."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tokenized-ach-payments","__idx":11},"children":["Tokenized ACH payments"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To avoid storing sensitive bank account details, tokenize the bank account and use the payment token for subsequent transactions."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"type\": \"payment\",\n \"amount\": 50000,\n \"payment_method\": {\n \"type\": \"token\",\n \"payment_token\": \"PAYMENT_TOKEN-03LPSC0TTY0AYRNZ5VQXS2G3AB\"\n },\n \"recurring\": true,\n \"purchase_description\": \"Monthly service fee\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more information, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/tokenization/what-is-tokenization"},"children":["About tokenization"]},"."]},{"$$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":["Validate routing numbers"]}," before submitting. Invalid routing numbers result in R03 or R04 returns."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use the correct SEC code"]}," (WEB for internet, PPD for recurring with signed authorization)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Handle returns asynchronously"]},". Do not treat the initial ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authorized"]}," response as final settlement."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recurring: true"]}]}," for subsequent charges against a stored bank account to comply with NACHA rules."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tokenize bank accounts"]}," for recurring payments rather than storing raw account numbers."]}]},{"$$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/concepts/transactions/transaction-lifecycle"},"children":["About the transaction lifecycle"]}]},{"$$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/get-started/supported-processors"},"children":["Supported processors"]}]}]}]},"headings":[{"value":"About ACH/bank account payments","id":"about-achbank-account-payments","depth":1},{"value":"What is ACH","id":"what-is-ach","depth":2},{"value":"ACH transaction types","id":"ach-transaction-types","depth":2},{"value":"Processing an ACH payment","id":"processing-an-ach-payment","depth":2},{"value":"Required fields","id":"required-fields","depth":3},{"value":"Example request","id":"example-request","depth":3},{"value":"Example response","id":"example-response","depth":3},{"value":"ACH vs. card payment timeline","id":"ach-vs-card-payment-timeline","depth":2},{"value":"ACH returns","id":"ach-returns","depth":2},{"value":"ACH payouts","id":"ach-payouts","depth":2},{"value":"Canceling ACH transactions","id":"canceling-ach-transactions","depth":3},{"value":"Tokenized ACH payments","id":"tokenized-ach-payments","depth":2},{"value":"Best practices","id":"best-practices","depth":2},{"value":"Further reading","id":"further-reading","depth":2}],"frontmatter":{"title":"About ACH/bank account payments","shortTitle":"ACH payments","intro":"ACH (Automated Clearing House) payments transfer funds directly between bank accounts. They cost less than card payments but take longer to settle and have different return rules.","type":"overview","seo":{"title":""}},"lastModified":"2026-06-05T02:46:44.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/concepts/transactions/ach-accounts","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}