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

Request

  • Base URL
    https://sandbox.pismolabs.io/passport
  • URL
    https://sandbox.pismolabs.io/passport/v2/accounts/{accountId}/bank-accounts/ach
  • Auth
    none declared. Required headers: Authorization

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"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.