ZenPayments
  1. Hosted Form
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
        • View
        • Create ACH
        • Create ACH & Save Customer
        • Create ACH for an existing Customer
        • Create ACH for an existing Customer and specific Account
        • Remove
      • Hosted Form
        • Example Request
          POST
      • 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. Hosted Form

Example Request

POST
/api/ach/hosted-form

Request

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

Example
{
   "dba":{
      "id":1
   },
   "amount":2,
   "memo":"Invoice 123",
   "returnUrl":"https://example.com",
   "useLogo":"Yes",
   "sendReceipt":"Yes"
}

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/hosted-form' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
   "dba":{
      "id":1
   },
   "amount":2,
   "memo":"Invoice 123",
   "returnUrl":"https://example.com",
   "useLogo":"Yes",
   "sendReceipt":"Yes"
}'

Responses

🟢200Example Request
text/plain
Body

Example
{
    "url": "https://zendashboard.com/ach/public/form?data=eyJpZCI6MSwidGhlbWUiOiJsaWdodCIsImFtb3VudCI6MiwibWVtbyI6Ikludm9pY2UgMTIzIiwicmV0dXJuVVJMIjoiaHR0cHM6XC9cL2V4YW1wbGUuY29tIiwibG9nbyI6IjEiLCJsb2NrIjpbImFtb3VudCIsIm1lbW8iXSwic2VuZFJlY2VpcHQiOiIxIiwiaGFzaCI6IjRkZmYyNGEyOTc4M2M5YzVlYzk4ZDg5YTJiMWI2Njc3ZDdiYjc2ZWE1Yjk1NjNjODY1NWNhNGQ4NTE2OGU4YjkifQ%3D%3D",
    "htmlForm": "<form action=\"https://zendashboard.com/ach/public/form\" method=\"GET\"><input type=\"hidden\" name=\"id\" value=\"1\"/><input type=\"hidden\" name=\"amount\" value=\"2\" placeholder=\"Amount\"/><input type=\"hidden\" name=\"memo\" value=\"Invoice 123\" placeholder=\"Memo\"/><input type=\"hidden\" name=\"returnURL\" value=\"https://example.com\"/><input type=\"hidden\" name=\"theme\" value=\"light\"/><input type=\"hidden\" name=\"hash\" value=\"4dff24a29783c9c5ec98d89a2b1b6677d7bb76ea5b9563c8655ca4d85168e8b9\"/><input type=\"hidden\" name=\"logo\" value=\"1\"/><input type=\"hidden\" name=\"sendReceipt\" value=\"1\"/><input type=\"hidden\" name=\"lock[]\" value=\"amount\"><input type=\"hidden\" name=\"lock[]\" value=\"memo\"><button type=\"submit\">Make Payment</button></form>",
    "htmlLink": "<a href=\"https://zendashboard.com/public/form?data=eyJpZCI6MSwidGhlbWUiOiJsaWdodCIsImFtb3VudCI6MiwibWVtbyI6Ikludm9pY2UgMTIzIiwicmV0dXJuVVJMIjoiaHR0cHM6XC9cL2V4YW1wbGUuY29tIiwibG9nbyI6IjEiLCJsb2NrIjpbImFtb3VudCIsIm1lbW8iXSwic2VuZFJlY2VpcHQiOiIxIiwiaGFzaCI6IjRkZmYyNGEyOTc4M2M5YzVlYzk4ZDg5YTJiMWI2Njc3ZDdiYjc2ZWE1Yjk1NjNjODY1NWNhNGQ4NTE2OGU4YjkifQ%3D%3D\">Make Payment</a>",
    "hostedForm": "<div id=\"maverick\"></div><script>(function() {var l = function() { new MaverickClient({ target: 'maverick', url: e.src, options: {\"data\":\"eyJpZCI6MSwidGhlbWUiOiJsaWdodCIsImFtb3VudCI6MiwibWVtbyI6Ikludm9pY2UgMTIzIiwicmV0dXJuVVJMIjoiaHR0cHM6XC9cL2V4YW1wbGUuY29tIiwibG9nbyI6IjEiLCJsb2NrIjpbImFtb3VudCIsIm1lbW8iXSwic2VuZFJlY2VpcHQiOiIxIiwiaGFzaCI6IjRkZmYyNGEyOTc4M2M5YzVlYzk4ZDg5YTJiMWI2Njc3ZDdiYjc2ZWE1Yjk1NjNjODY1NWNhNGQ4NTE2OGU4YjkifQ==\"} }); };if(typeof window.MaverickClient === \"undefined\") {window.webroot = \"https://zendashboard.com\";var e = document.createElement('script'); e.async = true;e.src = window.webroot + \"/js/ach/client.js?v=\" + Date.now();document.getElementsByTagName('head')[0].appendChild(e);e.onload = e.onreadystatechange = function() { l(); }} else { l(); }}());</script>"
}
Modified at 2025-08-09 05:39:41
Previous
Hosted Form
Next
Customers
Built with