{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"ParadisePay Docs","description":"ParadisePay is the groundbreaking payment gateway that lets you integrate with the future of payments."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"ach-and-nacha-basics","__idx":0},"children":["ACH and NACHA basics"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ACH moves money directly between US bank accounts over a network operated by NACHA. It is the rail behind direct deposit and most recurring bill payment."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Compared with cards, the trade is cost against certainty."]},{"$$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":{"data-label":""},"children":[]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Card"},"children":["Card"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"ACH"},"children":["ACH"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cost"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A percentage of the amount"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Usually a flat fee"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authorization"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Real time, from the issuer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["None. There is no balance check"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Finality"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Decline arrives in the response"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A return can arrive days later"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Good for"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Any amount, immediate fulfillment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Large or recurring amounts, B2B"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"there-is-no-authorization-step","__idx":1},"children":["There is no authorization step"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is the difference that matters most, and it catches card-shaped integrations."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A card transaction asks the issuer a question and gets an answer. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["An ACH debit asks nobody."]}," It is submitted, it settles, and only afterwards can the receiving bank reject it — because the account was closed, the balance was short, or the customer revoked authorization."]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"---\nconfig:\n theme: 'neutral'\n---\nflowchart LR\n A[Submit debit] --> B[Approved]\n B --> C[Settles]\n C --> D{Receiving bank}\n D -->|accepts| E[Funds are yours]\n D -->|rejects, days later| F[Return]\n","diagramHtml":"

accepts

rejects, days later

Submit debit

Approved

Settles

Receiving bank

Funds are yours

Return

","diagramHtmlDark":"

accepts

rejects, days later

Submit debit

Approved

Settles

Receiving bank

Funds are yours

Return

"},"children":["---\nconfig:\n theme: 'neutral'\n---\nflowchart LR\n A[Submit debit] --> B[Approved]\n B --> C[Settles]\n C --> D{Receiving bank}\n D -->|accepts| E[Funds are yours]\n D -->|rejects, days later| F[Return]\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["So an approved ACH transaction is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["provisional"]},". Do not treat it as final for anything expensive to reverse until returns have had time to arrive."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sec-codes","__idx":2},"children":["SEC codes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every ACH entry carries a Standard Entry Class code declaring how the customer authorized it. It is a compliance statement, not a preference — send the one that matches what actually happened. There is no default: a payment without one is refused."]},{"$$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":{"data-label":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Authorization"},"children":["Authorization"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WEB"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Consumer authorized over the internet"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PPD"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Consumer authorized in writing"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TEL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Consumer authorized by telephone"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CCD"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Business to business"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POP"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check converted at the point of sale"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BOC"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check converted after the sale"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Keep evidence of the authorization. A disputed debit is resolved by producing it."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"returns","__idx":3},"children":["Returns"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A return is NACHA's mechanism for rejecting an entry after the fact. Each carries a three-character code — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["R01"]}," insufficient funds, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["R02"]}," account closed, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["R10"]}," customer advises unauthorized, and so on."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Four fields on the transaction report it: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_returned"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["returned_at"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["return_code"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["return_reason"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["return_code"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["return_reason"]}," are omitted rather than null"]}," when there has been no return, which is nearly always. Read them defensively."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There are no webhooks, so finding returns means polling. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/payments/accept-an-ach-payment"},"children":["Accept an ACH payment"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"direction","__idx":4},"children":["Direction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ACH runs both ways, and the gateway exposes both:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Debit"]}," — pull funds in. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SALE"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Credit"]}," — push funds out. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYOUT"]},". See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/payments/send-a-payout"},"children":["Send a payout"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A bank account accepts those two types and no others. There is no ACH authorization, so ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AUTH"]}," is rejected."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":5},"children":["Next steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/payments/accept-an-ach-payment"},"children":["Accept an ACH payment"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/payments/send-a-payout"},"children":["Send a payout"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/after-the-payment/find-and-report-on-transactions"},"children":["Find and report on transactions"]}]}]}]},"headings":[{"value":"ACH and NACHA basics","id":"ach-and-nacha-basics","depth":1},{"value":"There is no authorization step","id":"there-is-no-authorization-step","depth":2},{"value":"SEC codes","id":"sec-codes","depth":2},{"value":"Returns","id":"returns","depth":2},{"value":"Direction","id":"direction","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"title":"ACH and NACHA basics","shortTitle":"ACH and NACHA","intro":"How bank transfers differ from cards: cheaper, slower, and reversible days after they looked successful.","type":"overview","seo":{"title":""}},"lastModified":"2026-10-23T00:08:41.652Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/concepts/ach-and-nacha","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}