Skip to main content
POST
/
3p
/
api
/
v2
/
users
/
{uuid}
/
bank-accounts
Add a new bank account for a user ( SUNSETTING )
curl --request POST \
  --url https://api.grailpay.com/3p/api/v2/users/{uuid}/bank-accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "plaid": {
    "access_token": "access-token",
    "account_id": "account-id"
  },
  "custom": {
    "account_number": "12345678901234567",
    "routing_number": 123456789,
    "account_name": "John Doe",
    "account_type": "checking",
    "validate_account_routing": true
  },
  "account_details": {},
  "billing_merchant_user_uuid": "a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6",
  "billing_processor_mid": "1213121313"
}
'
{
  "status": true,
  "message": "Bank account added successfully",
  "data": {
    "uuid": "12345678-1234-1234-1234-123456789012",
    "user_uuid": "12345678-1234-1234-1234-123456789012",
    "account_number": "12345678901234567",
    "routing_number": "123456789",
    "account_name": "John Doe",
    "account_type": "checking",
    "aggregator_type": "manual",
    "created_at": "2021-09-01 00:00:00",
    "is_default": true
  },
  "errors": null,
  "error_code": null
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
uuid
string<uuid>
required

UUID of the user

Body

application/json
​
plaid
object
​
custom
object
​
account_details
object
​
billing_merchant_user_uuid
string
Example:

"a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6"

​
billing_processor_mid
string
Example:

"1213121313"

Response

Bank account added successfully

​
status
boolean
Example:

true

​
message
string
Example:

"Bank account added successfully"

​
data
object
​
errors
string
Example:

null

​
error_code
string
Example:

null