v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB
Bank accounts

Register ACH account

Register a new Automated Clearing House (ACH) bank account.

ACH is an electronic network for financial transactions in the United States. ACH processes large volumes of credit and debit transactions in batches.

To read about Pismo's banking offerings, see Banking overview.

This endpoint generates a Bank account registered event.

post/v2/accounts/{accountId}/bank-accounts/ach

Path parameters

accountIdstring required

Pismo account ID

Headers

Authorizationstring required

Account token - token encoded with a Pismo account ID. Tokens can expire quickly, which can result in a <b>401 Unauthorized</b> message

Request body

metadataMetadata

A set of key-value pairs used to store custom data or additional information.<br>

Note: This field must not be used to send Personally Identifiable Information (PII), Payment Card Industry (PCI) data, or any sensitive/regulated information. Metadata fields are intended for operational, non-sensitive data only. For sensitive data, use the specific parameters designed for that purpose. For more information, refer to Get started with Pismo APIs.

Example request

{
  "scheme": {
    "account_number": "12345678901234567",
    "routing_number": "123456789"
  }
}

Response

Response body

account_idinteger

Account ID

creation_datetimestring date-time

Account creation date time displayed in ISO 8601 format 2023-04-12T23:20:50.52Z.

metadataMetadata

A set of key-value pairs used to store custom data or additional information.<br>

Note: This field must not be used to send Personally Identifiable Information (PII), Payment Card Industry (PCI) data, or any sensitive/regulated information. Metadata fields are intended for operational, non-sensitive data only. For sensitive data, use the specific parameters designed for that purpose. For more information, refer to Get started with Pismo APIs.

Example response

{
  "account_id": 78123456,
  "creation_datetime": "2023-04-12T23:20:50.52Z",
  "scheme": {
    "account_number": "12345678901234567",
    "routing_number": "123456789"
  }
}