Skip to main content
POST
Onboard a new Business or Merchant into the ACH application ( SUNSETTING )

Authorizations

Authorization
string
header
required

Token-based authentication using Authorization: Bearer <YOUR_API_KEY> provided by the GrailPay Support Team.

Body

application/json
kyb
boolean
required
Example:

true

client_reference_id
string
required
Example:

"123456"

first_name
string
required
Example:

"John"

last_name
string
required
Example:

"Doe"

email
string
required
Example:

"test@example.org"

phone
string
required
Example:

"1234567890"

business
object
required
business_owners
object[]
bank_account
object

Bank account can be either Plaid or Custom, not both

billing_merchant_user_uuid
string<uuid> | null
Example:

"2bcf2ac3-38fc-4238-a638-4f092821fc27"

billing_processor_mid
string | null
Example:

"21245678932"

Response

Business registered successfully

Schema for a Business response

status
boolean

Response status

Example:

true

message
string

Response message

data
object

Business data

errors
object | null

Error details if any

error_code
string | null

Error code if any