ZenPayments
  1. Transactions
ZenPayments
  • General Information
    • Authentication
    • Errors
    • Responses
    • Filters
      • Example - gte
      • Example - between
      • Example - like
      • Example - in
      • Example - non-empty
    • Pagination
      • 10 results per page
    • Data Types
  • Merchants
    • Sandbox
      • Sandbox Payment Gateway
    • Card Payments
      • Authorization
      • Sale
      • Capture
      • Partial Capture
      • Refund
      • Partial Refund
      • Soft/Dynamic Descriptor
      • Card Authentication
      • Card Tokenization
      • Card Tokenization with Global Token
      • Sale with a Fee Terminal
    • Hosted Form
      • Generate
      • Generate with Billing and Contact Information
    • Hosted Fields
      • How it Works
      • Hosted Fields Token
        • Hosted Fields Token
      • Integration Guide
        • Step 1: Include the JavaScript Library
        • Step 2: Add HTML Elements for all payment fields
        • Step 3: Set the AccessToken and Configure the rest of the form
        • Step 4: Add styling
        • Step 5: Listen for Events
        • Step 6: Get the tokenized card
          • Get the tokenized card
        • Add Payment Method Page
        • Testing your integration
    • CustomerVault
      • Sandbox
        • Sandbox Dashboard
      • Hosted Card Form
        • Generate
      • Customers
        • List
        • View
        • Create
        • Update
        • Archive
        • Delete
      • Cards
        • List Cards
        • View
        • Add Card
        • Update Exp Date
        • Archive
        • Unarchive
        • Delete
      • Billing Information
        • List
        • View
        • Update
        • Create
      • Shipping Information
        • List
        • View
        • Update
        • Create
      • Recurring Payment
        • List
        • View
        • Update
        • Create
    • Transaction Reporting
      • List
      • View
    • Response Codes
      • Verification Response Codes
    • 3DSecure
      • Version
      • Create
        • Create
      • Check
        • Check
      • Test Cards
    • Account Updater
      • Card Compatibility
      • How It Works
        • Sale with Account Updater
    • ACH Payments
      • General Information
      • Transactions
        • SEC Codes
        • Statuses
        • Actions
          • Action
        • History Log
          • Log
        • List
          GET
        • View
          GET
        • Create ACH
          POST
        • Create ACH & Save Customer
          POST
        • Create ACH for an existing Customer
          POST
        • Create ACH for an existing Customer and specific Account
          POST
        • Remove
          DELETE
      • Hosted Form
        • Example Request
      • Customers
        • List Customers
        • View specific Customer
        • Create Customer
        • Update Customer
        • Delete a Customer
      • Customer Accounts
        • List Customer Accounts
        • Create Customer Account
        • Update Customer Account
        • Delete a Customer Account
      • Bank Information
        • View
      • ACH Settlements
        • List
        • View
      • ACH Webhooks
        • New ACH Record
        • ACH Status Update
        • New ACH Customer
    • Reporting
      • Sandbox
        • Sandbox Dashboard
      • Authorizations
        • List
        • List with Filters
      • Batches
        • List
        • List with Filters
        • Summary
      • Payouts
        • List
        • View
        • Export
      • Chargebacks
        • Disputes
          • Upload a temporary file
          • Create a Dispute
          • Preview
          • Submit
        • Webhooks
          • Signatures
          • Events
            • Chargeback
              • New Chargeback Record
              • Chargeback Update
        • View
          • List
          • View
      • Statements
        • List
        • Download
      • Reserve
        • List
      • Fraud Report
        • Generate
      • Visa Verifi
        • Submiting External Transactions
          • Submit
        • List
      • Other Reports
        • Request a Report
        • Check Status
        • Download
    • Gateway Test Cards
  • Platforms
    • Sandbox
      • Sandbox Dashboard
    • Onboarding
      • Boarding Applications
        • Campaigns
          • List
        • Equipment
          • Terminals
            • List
            • View
          • View
          • Update
        • List
          • List Boarding Applications
        • Create
          • Create Boarding Application
        • Delete
          • Delete Boarding Application
        • View
          • View Boarding Application
        • Update
          • Update Boarding Application
        • Principals
          • List Principals
          • Create Principal
          • Update a Single Principal
          • Mass update Principals
          • Delete Principal
        • Processing
          • View Processing section
          • Update Processing section
        • Merchant Category Codes (MCCs)
          • List MCCs
        • ACH
          • View ACH section
          • Update ACH section
        • Documents
          • Attachment About
            • List All Document Categories
          • View all documents
          • MPA
          • Assign a single document
          • Assign multiple documents
          • Update a single document
          • Delete a single document
        • Fees
          • Types
            • List
          • Other Fees
            • Add
            • Update
            • Delete
          • List all fees
          • View a specific fee
          • Update a single fee
          • Update multiple fees
        • Bank Accounts
          • Add
          • Update
          • Change
        • Validate
          • Validate a Boarding Application
        • URL
          • GET URL of Boarding Application
        • Signature
          • Request E-sign
            • Request Signature
          • Embed E-sign
            • Embeded E-sign Example Flow 1
            • Embeded E-sign Example Flow 2
            • Request Embed
          • Manually Signing
            • Manual Sign
          • External eSign Signing
            • External eSign
        • Automation
          • AutoSign
            • Set AutoSign
          • AutoUnderwriting
            • Set AutoUnderwriting
        • Status
          • Set status to Underwriting
        • Notes
          • List
          • Create
      • Merchants
        • Terminals
          • List Terminals
          • View a specific Terminal
          • VAR Sheet
          • VAR View
        • List Merchants
      • DBA
        • List
        • View
      • Attachments
        • Temporary Upload
          • Temporary Upload
        • Chunk Upload
          • Initialize
          • Upload Request 1/2
          • Upload Request 2/2
        • Standard Upload
        • List attachments
        • View
        • View in browser
        • Download
        • Delete
      • Webhooks
        • Signatures
        • Events
          • Boarding Application
          • Merchant
            • Account
              • New Acquiring Account
              • New ACH Account
              • Closed Acquiring Account
              • Closed ACH Account
            • Terminal
              • New Terminal Record
              • Update Terminal Record
              • Delete Terminal Record
    • Reporting
      • Authorizations
        • List
        • List with Filters
      • Batches
        • List
        • List with Filters
        • Summary
      • Payouts
        • List
        • View
        • Export
      • Chargebacks
        • View
          • List
          • View
        • Disputes
          • Upload a temporary file
          • Create a Dispute
          • Preview
          • Submit
        • Webhooks
          • Signatures
          • Events
            • Chargeback
              • New Chargeback Record
              • Chargeback Update
      • Statements
        • List
        • Download
      • Reserve
        • List
      • Fraud Report
        • Generate
      • Other Reports
        • Request a Report
        • Check Status
        • Download
    • Residuals
      • List
      • View
    • Tickets
      • Update Ticket Status
        • Close
        • Re-Open
      • Responses
        • List
        • Create
        • Add an Attachment
      • Attachments
        • List
        • View
        • Create
        • Delete
      • Categories
        • List
      • Notes
        • List
        • View
        • Create
        • Update
        • Delete
        • Attachments
      • List
      • Create
      • View a specific ticket
    • Connect
      • Webhooks
        • Access Granted
        • Access Updated
        • Access Revoked
    • Misc
      • Address Checker
        • List Countries
        • List States
        • List Cities and Zip Codes
        • Filter by City and State
      • BIN Check
        • Get BIN Information
  1. Transactions

Create ACH

POST
/api/ach
Use this endpoint to create ACH Transactions.
ACH Object
FieldsDescriptionTypeFilterableRequiredReadonly
idUnique ID of the ACH recordIntegerYesNoYes
amountAmount of the transaction including taxNumberNoYesNo
taxThe tax included in the amount in absolute valueNumberNoNoNo
checkNumberCheck NumberStringYesNoNo
routingNumberRouting NumberStringYesYesNo
accountNameName of the accountStringNoYesNo
accountNumberAccess NumberStringYesYesNo
accountTypeChecking or SavingsENUMNoYesNo
traceNumberTrace NumberStringYesNoYes
transactionIDTransaction IDIntegerYesNoYes
SECCodePPD, CCD, WEB or TELENUMNoYesNo
transactionTypeDebit or CreditENUMYesYesNo
transactionDateThe desired date to submit the transaction. If it’s empty, it takes the current date but never before.DateNoNoNo
transactionStatusStatus of the transactionENUMYesNoYes
memoShort note on your checkStringNoNoNo
addendaTextAdditional information for the transaction, to appear on the statement based on the banking institution.StringNoNoNo
fileFileObjectNoNoYes
file.idOrigination File IDIntegerYesNoYes
file.dateOrigination File DateDatetimeYesNoYes
dbaDoing Business AsObjectNoYesNo
dba.idID of your DBAIntegerYesYesNo
dba.nameName of the DBAStringNoNoYes
customerCustomer DetailsObjectYesYesNo
customer.idUnique ID of the customerStringYesNoNo
customer.firstNameFirst name of the customer (32-character limit)StringNoNoNo
customer.lastNameLast name of the customer (32-character limit)StringNoNoNo
customer.phonePhone number of the customerStringNoNoNo
customer.emailEmail address of the customerStringNoYesNo
customer.address1Address of the customer line 1StringNoNoNo
customer.address2Address of the customer line 2StringNoNoNo
customer.cityCity of the customerStringNoNoNo
customer.stateState of the customer. Example: NY, CA, etc...StringNoNoNo
customer.zipCodeZip Code of the customerStringNoNoNo
customer.identifierExternal Unique ID on a merchants platformStringNoNoNo
customer.sendReceiptSend receipt to the customer. Yes or No default NoStringNoNoNo
customer.saveSave customer info for further use. Yes or NoStringNoNoNo
recurringRecurring Payment object concerned only for recurring.id. Everything else recurring.\\\* is with the initializing transaction.ObjectNoNoNo
recurring.idThe ID of the parent recurring transactionIntegerYesNoNo
recurring.initDetermine if this is a recurring transaction - Yes or NoStringYesNoNo
recurring.everyBilling EveryIntegerNoNoNo
recurring.frequencyBilling FrequencyENUMNoNoNo
recurring.beginDateBegin DateDateNoNoNo
recurring.endAfterDefine the number of transactions after which recurring needs to end. If 0 will be unlimited.IntegerNoNoNo
recurring.statusThe recurring transaction status: Active, Cancelled or CompletedStringYesNoYes
verificationVerification DataObjectNoNoYes
verification.statusVerification StatusENUMYesNoYes
verification.dateDatetime of last updateDatetimeNoNoYes
sourceSourceENUMNoNoYes
returnReturn DataObjectNoNoYes
return.codeReturn CodeStringNoNoYes
return.dateReturn DateDateNoNoYes
createdOnDatetime of creationDatetimeYesNoYes
updatedOnDatetime of last updateDatetimeYesNoYes

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json

Example
{
    "amount": 55.95,
    "tax": 5.95,
    "routingNumber": "123123123",
    "accountName": "John Wick",
    "accountNumber": "1122334455",
    "accountType": "Checking",
    "transactionType": "Debit",
    "customer": {
        "email": "test@test.com"
    },
    "dba": {
        "id": "9"
    }
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/ach' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": 55.95,
    "tax": 5.95,
    "routingNumber": "123123123",
    "accountName": "John Wick",
    "accountNumber": "1122334455",
    "accountType": "Checking",
    "transactionType": "Debit",
    "customer": {
        "email": "test@test.com"
    },
    "dba": {
        "id": "9"
    }
}'

Responses

🟢200Create ACH
application/json
Body

Example
{
    "id": "327"
}
Modified at 2025-08-09 05:39:41
Previous
View
Next
Create ACH & Save Customer
Built with