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

# Test Addresses

Use these addresses to exercise the address steps of your integration in staging — virtual card issuance, bank card billing, KYC, and KYB — including your `VC-0025` error handling.

Virtual card billing addresses are validated with [Smarty](https://www.smarty.com/) (USPS Delivery Point Validation). See [Address Formatting Requirements](/concepts/address-formatting-requirements) for the full rules, including which contexts are US-only.

<Note>
  **Staging mirrors production**

  Address validation behaves the same in staging as in production, so any real, currently-deliverable address will pass. The examples below are provided for convenience and to trigger specific outcomes.
</Note>

## US test addresses

Each of these is a real, USPS-deliverable US address that Smarty validates cleanly. A real, deliverable **US** address works for **every** address field in the API — virtual cards, bank accounts, bank cards, KYC, and KYB.

| `streetAddressLine1`   | `city`         | `state` | `postalCode` |
| ---------------------- | -------------- | ------- | ------------ |
| 1600 Amphitheatre Pkwy | Mountain View  | CA      | 94043        |
| 5732 Lincoln Dr        | Minneapolis    | MN      | 55436        |
| 8084 Hogwarts Dr       | Rives Junction | MI      | 49277        |

To test a secondary unit, add a valid apartment or suite to `streetAddressLine2` (for example, `Apt 5` or `Ste 200`).

### Example request

```json theme={null}
{
  "input": {
    "billingAddress": {
      "streetAddressLine1": "1600 Amphitheatre Pkwy",
      "country": "United States",
      "city": "Mountain View",
      "state": "CA",
      "postalCode": "94043"
    }
  }
}
```

## International test addresses

These are real, deliverable non-US addresses for testing contexts that accept international addresses.

<Note>
  **Where international addresses are accepted**

  International addresses work for **bank card billing addresses**, **KYC**, and **KYB**. They are **not** accepted for **bank account (ACH) addresses** or **virtual card billing addresses** — both are US-only. Submitting an international address to a virtual card returns `VC-0025`.
</Note>

| `streetAddressLine1`  | `city`  | `state` | `postalCode` | `country`      |
| --------------------- | ------- | ------- | ------------ | -------------- |
| 221B Baker Street     | London  | England | NW1 6XE      | United Kingdom |
| 100 Queen Street West | Toronto | ON      | M5H 2N1      | Canada         |
| 200 George Street     | Sydney  | NSW     | 2000         | Australia      |
| Unter den Linden 77   | Berlin  | Berlin  | 10117        | Germany        |

Some countries do not use a state or province. Because `state` is required on most address objects, provide the closest administrative region (for example, the province, county, or city region).

## Addresses that fail validation

Use these to confirm your app handles `VC-0025` (and other rejections) gracefully. None of them will save a virtual card address.

| Address                                           | Result    | Why                                                                                                                                                             |
| ------------------------------------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 2581 Oakwood Avenue, New York, NY 10605           | `VC-0025` | City / ZIP mismatch — `10605` is White Plains, NY, not New York City — and no matching delivery point.                                                          |
| 896 S State St, Dover, DE 19904                   | `VC-0025` | Building number `896` is not a confirmed USPS delivery point on that street and ZIP.                                                                            |
| 123 Fake St, Springfield, IL 62704                | `VC-0025` | Street is not present in USPS data.                                                                                                                             |
| PO Box 1001, Austin, TX 78701                     | Rejected  | PO boxes are not accepted by the card issuer.                                                                                                                   |
| 221B Baker Street, London NW1 6XE, United Kingdom | `VC-0025` | Non-US address — virtual card and bank account addresses are US-only. (Valid for bank card billing, KYC, and KYB — see the International test addresses above.) |

### Example failing request

```json theme={null}
{
  "input": {
    "billingAddress": {
      "streetAddressLine1": "2581 Oakwood Avenue",
      "country": "United States",
      "city": "New York",
      "state": "NY",
      "postalCode": "10605"
    }
  }
}
```

Returns `VC-0025`. Retrying with the same values will keep failing — the address must be corrected before it can be saved.

## Next steps

You've now got test data for every part of the sandbox — cards, bank accounts, identities, merchants, and addresses. Time to put it to work.

<CardGroup cols={2}>
  <Card title="Quickstart: your first gift card purchase" icon="gift" href="/quickstart">
    Run the full happy path end to end — deposit funds, buy a gift card, and reveal it.
  </Card>

  <Card title="Address formatting requirements" icon="map-pin" href="/concepts/address-formatting-requirements">
    The full validation rules behind these outcomes, with worked examples and error handling.
  </Card>
</CardGroup>