Creating accounts as an underwriter

Customers approved by a Trice sponsor bank with "underwriter" capability can create verified child Accounts and Persons at that bank. Here's a playbook for underwriters to create child accounts and get them ready to start transacting.

  1. Pre-requisites
    1. Your account is live with at least 1 sponsor bank:
      1. Your account is verified for at least 1 sponsor bank (see account.verified_for field) and has status=ok
      2. Your account has at least 1 Person verified at that sponsor bank (see person.verified_for field) and has status=ok
      3. Your account has a Bank Capability for that bank (see GET /hub/v1/bank_capabilities) with underwriter=active
    2. Take note of your bank_id in (see bank_id field in GET /hub/v1/account response)
    3. Take note of your bank RTN (see routing_number field in GET /hub/v1/enrollments response)
  2. Create child account. Note the following requirements in addition to other required fields:
    1. req.enrollments= [] (set to empty array)
    2. req.verified_for=["<bank_id>"] - use bank_id from step 1.
    3. do not set req.capabilities field
  3. Create bank capability for that child account (OPTIONAL)
    1. This step is only required if the child account should have party_underwriter=active, which is needed for sending RfPs.
    2. Set X-TRICE-ACCOUNT to the child account's account.id
  4. Create enrollment for that child account
    1. Set X-TRICE-ACCOUNT to the child account's account.id
    2. Use the routing numnber from step 1 above.
  5. Create Person for that child account
    1. Set X-TRICE-ACCOUNT to the child account's account.id
    2. req.verified_for=["<bank_id>"] - use bank_id from step 1.