> ## Documentation Index
> Fetch the complete documentation index at: https://docs.argalabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bivo

> Bivo Scenario seeding parameters, nested fields, and examples

Use `bivo` in `twins` and put this configuration under `seed_config.bivo`.

Bivo banking accounts, ACH, wire, FX, card and coin workflows.

## Example seed

This is the complete Scenario request body for [creating a Scenario](https://docs.argalabs.com/api-reference/post-create-a-scenario.md). You can also import it with `arga test-runner scenarios import --file scenario.json`.

```json theme={null}
{
  "name": "Bivo eval fixture",
  "twins": [
    "bivo"
  ],
  "seed_config": {
    "bivo": {
      "individuals": [
        {
          "personalInfo": {
            "firstName": "Alex",
            "lastName": "Test",
            "email": "alex@example.test",
            "phoneNumber": "+15555550100"
          },
          "address": {
            "addressLine1": "1 Test Street",
            "zipCode": "94105",
            "city": "San Francisco",
            "state": "CA",
            "countryCode": "US"
          },
          "correlationId": "unique-per-client",
          "clientIpAddress": "127.0.0.1",
          "balance": 1000,
          "active": true
        }
      ],
      "businesses": [
        {
          "personalInfo": {
            "firstName": "Sam",
            "lastName": "Test",
            "email": "sam@example.test",
            "phoneNumber": "+15555550101"
          },
          "address": {
            "addressLine1": "2 Test Street",
            "zipCode": "94105",
            "city": "San Francisco",
            "state": "CA",
            "countryCode": "US"
          },
          "businessInfo": {
            "company": "Synthetic Company",
            "businessEin": "123456789"
          },
          "correlationId": "unique-per-business",
          "clientIpAddress": "127.0.0.1",
          "balance": 1000,
          "active": true
        }
      ]
    }
  }
}
```

## Parameters

The following fields belong directly inside `seed_config.bivo`. Required nested fields are marked in their tables. Provider-native objects can contain service-specific fields beyond the representative record shapes below.

| Parameter | Type | Description |
| - | - | - |
| `individuals` | `object[]` | Individuals fixtures in provider-native format. |
| `businesses` | `object[]` | Businesses fixtures in provider-native format. |
| `tenant` | `string` | Tenant. |

## Seeding behavior

`individuals` and `businesses` accept the provider create-account body, optionally wrapped in `request`, with `balance` and `active` fixture controls inside that body. Starting balances are synthetic twin state.

## Resource fields

These tables describe the record shapes used by the example. Keep native field names and casing. Map keys such as property names, IDs, and metadata keys are supplied by your fixture.

### `individuals[]`

| Parameter | Type | Description |
| - | - | - |
| `personalInfo` | `object` | PersonalInfo. |
| `address` | `object` | Address. |
| `correlationId` | `string` | CorrelationId. |
| `clientIpAddress` | `string` | ClientIpAddress. |
| `balance` | `integer` | Balance. |
| `active` | `boolean` | Enable or set active behavior. |

### `businesses[]`

| Parameter | Type | Description |
| - | - | - |
| `personalInfo` | `object` | PersonalInfo. |
| `address` | `object` | Address. |
| `businessInfo` | `object` | BusinessInfo. |
| `correlationId` | `string` | CorrelationId. |
| `clientIpAddress` | `string` | ClientIpAddress. |
| `balance` | `integer` | Balance. |
| `active` | `boolean` | Enable or set active behavior. |

See [Scenario seeding](https://docs.argalabs.com/twins/seeding.md) for saving, provisioning, and resetting fixtures.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.