ZenPayments
  1. Bank Accounts
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
      • 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
            PUT
          • Update
            PUT
          • Change
            PUT
        • 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. Bank Accounts

Update

PUT
/api/boarding-application/<id>
To update a Bank Account, you have to provide the ID of the Bank Account you want to update:

Request

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

Example
{
    "processing": {
        "banks": [
            {
                "id": 1,
                "type": "All",
                "accountNumber": "221221331331",
                "routingNumber": "123123123"
            }
        ]
    }
}

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 PUT '/api/boarding-application/<id>' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "processing": {
        "banks": [
            {
                "id": 1,
                "type": "All",
                "accountNumber": "221221331331",
                "routingNumber": "123123123"
            }
        ]
    }
}'

Responses

🟢200Update for Processing
application/json
Body

Example
{
    "id": 607,
    "processingMethod": "Acquiring",
    "mcc": null,
    "campaign": {
        "id": 206
    },
    "company": {
        "name": null,
        "type": null,
        "federalTaxId": null,
        "address": {
            "street": null,
            "city": null,
            "zip": null,
            "state": {
                "id": null
            },
            "country": {
                "id": 199
            }
        },
        "founded": null
    },
    "dba": {
        "sameAsCompany": "Yes",
        "name": null,
        "address": {
            "street": null,
            "city": null,
            "zip": null,
            "state": {
                "id": null
            },
            "country": {
                "id": 199
            }
        }
    },
    "website": null,
    "serviceDescription": null,
    "mailingAddress": "legal",
    "businessLocation": {
        "buildingType": null,
        "numberOfLocations": null,
        "buildingOwnership": null,
        "areaZoned": null,
        "squareFootage": null
    },
    "customerServiceContact": {
        "phone": null,
        "email": null
    },
    "corporateContact": {
        "phone": null,
        "fax": null,
        "email": null
    },
    "bankruptcy": {
        "hasBankruptcy": null,
        "description": null
    },
    "principals": [
        {
            "id": 739,
            "title": null,
            "name": {
                "first": null,
                "last": null
            },
            "dayOfBirth": null,
            "ssn": null,
            "nationalId": null,
            "nationality": {
                "id": 199
            },
            "driverLicense": {
                "number": null,
                "expiration": null,
                "state": {
                    "id": null
                }
            },
            "address": {
                "street": null,
                "city": null,
                "zip": null,
                "state": {
                    "id": null
                },
                "country": {
                    "id": 199
                }
            },
            "phone": null,
            "email": null,
            "ownershipPercentage": null,
            "isManagement": "Yes"
        }
    ],
    "processing": {
        "bank": {
            "accountNumber": "221221331331",
            "routingNumber": "123123123"
        },
        "banks": [
            {
                "id": 1,
                "type": "All",
                "accountNumber": "221221331331",
                "routingNumber": "123123123"
            }
        ],
        "volumes": {
            "monthlyTransactionAmount": null,
            "avgTransactionAmount": null,
            "maxTransactionAmount": null
        },
        "sales": {
            "swiped": null,
            "mail": null,
            "internet": null
        },
        "alreadyProcessing": {
            "isProcessing": "No",
            "processor": null
        },
        "terminated": {
            "isTerminated": null,
            "description": null
        },
        "customers": {
            "type": {
                "individual": null,
                "business": null,
                "government": null
            },
            "location": {
                "local": null,
                "national": null,
                "international": null
            }
        },
        "fulfillmentPolicy": {
            "fulfillment": null,
            "fulfillmentOther": null,
            "delivery": null,
            "deliveryOther": null
        },
        "recurringPayments": {
            "hasRecurring": "No",
            "description": null
        },
         "intendedUsage": {
            "creditCards": "Yes",
            "pinDebit": "No",
            "ebt": "No",
            "fns": null,
            "amex": {
                "optBlue": "Yes",
                "esa": ""
            },
            "notes": null
        },
        "seasonalBusiness": {
            "isSeasonal": "No",
            "months": []
        },
        "inventory": {
            "onSite": "No",
            "offSite": "No",
            "offSiteAddress": null,
            "thirdParty": "No",
            "serviceOnly": "No"
        },
        "retailLocation": null,
        "externalFulfillment": "No",
        "customerCharged": null,
        "equipmentUsed": null,
        "advertise": null,
        "refundPolicy": null,
        "feeSchedule": {
            "fees": [
                {
                    "id": 19321,
                    "type": {
                        "id": 1
                    },
                    "value": "1.00001"
                },
                {
                    "id": 19322,
                    "type": {
                        "id": 2
                    },
                    "value": "0.00002"
                },
                {
                    "id": 19323,
                    "type": {
                        "id": 3
                    },
                    "value": "0.00003"
                },
                {
                    "id": 19324,
                    "type": {
                        "id": 4
                    },
                    "value": "0.00004"
                },
                {
                    "id": 19325,
                    "type": {
                        "id": 5
                    },
                    "value": "0.00005"
                },
                {
                    "id": 19326,
                    "type": {
                        "id": 6
                    },
                    "value": "0.00000"
                },
                {
                    "id": 19327,
                    "type": {
                        "id": 7
                    },
                    "value": "0.00000"
                },
                {
                    "id": 19328,
                    "type": {
                        "id": 8
                    },
                    "value": "0.00000"
                },
                {
                    "id": 19329,
                    "type": {
                        "id": 9
                    },
                    "value": "0.00000"
                },
                {
                    "id": 19330,
                    "type": {
                        "id": 10
                    },
                    "value": "0.00000"
                },
                {
                    "id": 19331,
                    "type": {
                        "id": 11
                    },
                    "value": "0.00000"
                },
                {
                    "id": 19332,
                    "type": {
                        "id": 12
                    },
                    "value": "0.00000"
                },
                {
                    "id": 19333,
                    "type": {
                        "id": 13
                    },
                    "value": "0.00000"
                },
                {
                    "id": 19334,
                    "type": {
                        "id": 14
                    },
                    "value": "0.00000"
                },
                {
                    "id": 19335,
                    "type": {
                        "id": 15
                    },
                    "value": "0.00000"
                },
                {
                    "id": 19336,
                    "type": {
                        "id": 16
                    },
                    "value": "0.00000"
                },
                {
                    "id": 19337,
                    "type": {
                        "id": 17
                    },
                    "value": "0.00000"
                },
                {
                    "id": 19338,
                    "type": {
                        "id": 18
                    },
                    "value": "0.00000"
                },
                {
                    "id": 19339,
                    "type": {
                        "id": 18
                    },
                    "value": "0.00000"
                },
                {
                    "id": 19340,
                    "type": {
                        "id": 18
                    },
                    "value": "0.00000"
                },
                {
                    "id": 19341,
                    "type": {
                        "id": 19
                    },
                    "value": "0.00000"
                },
                {
                    "id": 19342,
                    "type": {
                        "id": 20
                    },
                    "value": "0.00000"
                },
                {
                    "id": 19343,
                    "type": {
                        "id": 21
                    },
                    "value": "0.00000"
                },
                {
                    "id": 19344,
                    "type": {
                        "id": 22
                    },
                    "value": "0.00000"
                }
            ],
            "note": null
        }
    },
    "ach": null,
    "documents": [],
    "agent": {
        "id": 14
    },
    "signature": {
        "status": "Unsigned",
        "via": null
    },
    "auto": {
        "sign": "Yes",
        "underwriting": "No"
    },
    "status": "New",
    "updatedOn": "2023-05-10 11:52:41",
    "createdOn": "2023-05-10 11:52:40"
}
Modified at 2025-08-09 05:39:41
Previous
Add
Next
Change
Built with