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 (USPS Delivery Point Validation). See Address Formatting Requirements for the full rules, including which contexts are US-only.

Staging mirrors productionAddress 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.

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

{
  "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.

Where international addresses are acceptedInternational 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.

`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

{
  "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.

Quickstart: your first gift card purchase

Run the full happy path end to end — deposit funds, buy a gift card, and reveal it.

Address formatting requirements

The full validation rules behind these outcomes, with worked examples and error handling.

Get started

Fluz Dashboard

Quickstarts

Test Addresses

US test addresses

Example request

International test addresses

Addresses that fail validation

Example failing request

Next steps

Quickstart: your first gift card purchase

Address formatting requirements

​US test addresses

​Example request

​International test addresses

​Addresses that fail validation

​Example failing request

​Next steps

Quickstart: your first gift card purchase

Address formatting requirements

US test addresses

Example request

International test addresses

Addresses that fail validation

Example failing request

Next steps