Bank accounts and direct deposit splits

Attributes

Attribute	Required?	Default
`account_type`	Yes
`account_number`	Yes
`routing_number`	Yes
`type`	Yes—must be `"Direct Deposit"`
`split_by`	Yes—must be either `"Amount"` (meaning: Cents) or `"Percentage"`
`split_amount`	Yes
`name`

Examples

See the following examples to explore different scenarios:

One bank account
Multiple bank accounts and split by percentage
Multiple bank accounts and split by amount in cents

Check here to see how this looks in the context of a full batch example.

Example with one bank account

One bank account with 100% direct deposit.

{
  "idempotency_key": "bcfc9744-0ab3-4ef3-ab0d-e728255d659c",
  "batch_action" : "create",
  "batch": [
    {
      "entity_type": "employee",

      "person": {
        "external_id": "employee-abc-123",
        "first_name": "Alice",
        "last_name": "Smith"
      },
      "bank_accounts": [
        {
          "account_type": "Checking",
          "account_number": "1234567890",
          "routing_number": "000234234223",
          "type": "Direct Deposit",
          "name": "Etrade Checking",
          "split_by": "Percentage",
          "split_amount": "100.0"
        }
      ]
    }
  ]
}

Example with multiple bank accounts and split by percentage

Two bank accounts with percentage split between direct deposits.

Percentages are required for all accounts, and have to add up to 100.0%

{
  "idempotency_key": "bcfc9744-0ab3-4ef3-ab0d-e728255d659c",
  "batch_action" : "create",
  "batch": [
    {
      "entity_type": "employee",

      "person": {
        "external_id": "employee-abc-123",
        "first_name": "Alice",
        "last_name": "Smith"
      },
      "bank_accounts": [
        {
          "name": "Etrade Checking",
          "account_type": "Checking",
          "account_number": "1234567890",
          "routing_number": "000234234223",
          "type": "Direct Deposit",
          "split_by": "Percentage",
          "split_amount": "80.0"
        },
        {
          "name": "Etrade Savings",
          "account_type": "Savings",
          "account_number": "1234567890",
          "routing_number": "0987693293",
			    "type": "Direct Deposit",
          "split_by": "Percentage",
          "split_amount": "20.0"
        }
      ]
    }
  ]
}

Example with multiple bank accounts and split by amount in cents

Two bank accounts with a split based on amounts in Cents between direct deposits.

The amount for the last account has to be given as null in order to receive the remainder.

{
  "idempotency_key": "bcfc9744-0ab3-4ef3-ab0d-e728255d659c",
  "batch_action" : "create",
  "batch": [
    {
      "entity_type": "employee",

      "person": {
        "external_id": "employee-abc-123",
        "first_name": "Alice",
        "last_name": "Smith"
      },
      "bank_accounts": [
        {
          "name": "BofA Checking",
          "account_type": "Checking",
          "routing_number": "266905059",
          "account_number": "5809431207",
          "type": "Direct Deposit",
          "split_by": "Amount",
          "split_amount": "450000"
        },
        {
          "name": "Etrade Savings",
          "account_type": "Savings",
          "account_number": "1234567890",
          "routing_number": "0987654543",
          "type": "Direct Deposit",
          "split_by": "Amount",
          "split_amount": null
        }
      ]

    }
  ]
}