uuid
associated with the user, which is returned upon successful onboarding and is required for
future operations such as linking bank accounts and initiating transfers.
Onboarding a business is a core part of working with the GrailPay ACH API. This guide outlines the business onboarding
workflow and provides context for common use cases. For complete request and response schemas, refer to
the OpenAPI documentation.
billing_merchant_user_uuid
— UUID of the merchant user that should receive billing attribution.
This enables GrailPay to accurately report on merchant usage and ensures billing traceability across your organization.
bank_account.plaid.access_token
bank_account.plaid.account_id
account_number
routing_number
account_name
account_type
(checking
or savings
)validate_account_routing
is used, the response includes a valid_account
field with one of the following values:
Value | Meaning |
---|---|
valid | Account is valid. Person was successfully created. |
invalid | Account is invalid. Person was not created. (HTTP 406) |
not_validated | Could not validate. Person was created, but account status is unknown. |
uuid
of the person related to the business. This uuid is required for future operations such as linking bank accounts and initiating transfers.valid_account
field (if validation was enabled)