Add ACH Account Corporate

post

https://api-{corename}.{env}.gpsrv.com/intserv/4.0/addAchAccountCorporate

Use the Add ACH Account Corporate endpoint to add an ACH corporate account to the specified customer account. If you are integrated with Plaid, set the RPVIR parameter to 1 to receive plaid_identity_values in the response. Use this endpoint to add external accounts that belong to companies. For ACH accounts that belong to individuals, use the Add ACH Account endpoint.

Status codes

See Global Response Statuses for status codes that are common across endpoints.

The table below lists status codes that apply to this specific endpoint.

Status code	Description
606-01	Identity validation failed
606-02	Failed to retrieve ACH account details
606-03	Error calling Plaid auth endpoint or failure calling Plaid identity endpoint
606-04	ACH account already exists

Form Data

apiLogin

string

required

Web service username, as provided by Galileo.
Pattern: Max 50 characters
Example: "AbC123-9999"

apiTransKey

string

required

Web service password, as provided by Galileo.
Pattern: Max 15 characters
Example: "4sb62fh6w4h7w34g"

providerId

int32

required

Galileo-issued provider identifier.
Pattern: Max 10 digits
Example: 9999

transactionId

string

required

1 to 60

A unique provider-generated ID to identify this API call. A UUID is preferred.
Pattern: 60 characters or less
Example: "9845dk-39fdk3fj3-4483483478"

accountNo

string

required

The PRN or PAN of the account.
Pattern: PAN or PRN
Example: "074103447228"

name

string | null

The display name of the external account. This field is required unless processorToken is populated.
Pattern: 1–22 supported characters
Example: "Tealbank account"

type

string | null

enum

Type of the external bank account:

C — Checking
S — Savings
M — Money market

Pattern: String
Example: "C"

Allowed:

achAccountNo

string | null

External bank account number.
Pattern: Up to 22 numerals
Example: "4483434234348"

achRoutingNo

string | null

Routing number for the external bank where achAccountNo is housed.
Pattern: Exactly 9 digits
Example: "124001545"

companyName

string | null

Required. Name of the company that holds the external account. Only the first 22 characters of this string will be present in the outgoing Nacha file. The contents of this field are populated differently in the Entry Detail Record of the Nacha file according to the SEC code of the transaction:

CCD — Receiving Company Name field
PPD — Individual Name field

Pattern: 1–40 supported characters
Example: "Mountain Star Utilities"

location

string | null

≤ 20

Unique location identifier (location) as returned by the Create Location endpoint. This value is also returned by the Get Locations endpoint depending on the value of locationType when the location was created:

0 or 2 — Returned in the location_id field
1 — Returned in the provider_specified_id field

Pattern: Integer if locationType: 0 or locationType: 2; max 15 characters if locationType: 1
Example: "a455-3483"

locationType

int32 | null

enum

Type of ID in location:

0 — Galileo location ID
1 — Partner location ID
2 — Don't validate

Pattern: Integer
Example: 1

Allowed:

processorToken

string | null

Obtained from Plaid if using Plaid integration. When passing this token it is not necessary to pass achAccountNumber, achRoutingNumber, name, or type. If you are not using Plaid, do not send this parameter with an empty or null value.
Pattern: String
Example: "processor-production-35cd43b-adfc-d8aa-b331-c9ba0fdha881"

verifyIdentity

int32

enum

Defaults to 0

If processorToken is populated, pass 1 to call the Plaid identity endpoint for account-holder verification.
Pattern: Integer
Example: 0

Allowed:

Headers

response-content-type

string

enum

Defaults to json

Use this header instead of the standard accept header to specify the response format.

Allowed:

Response

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Status codes

default