> ## 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.

# Direcciones de prueba

Usa estas direcciones para poner a prueba los pasos de dirección de tu integración en staging: emisión de tarjetas virtuales, facturación de tarjetas bancarias, KYC y KYB, incluido el manejo de tu error `VC-0025`.

Las direcciones de facturación de tarjetas virtuales se validan con [Smarty](https://www.smarty.com/) (USPS Delivery Point Validation). Consulta [Requisitos de formato de dirección](/concepts/address-formatting-requirements) para conocer todas las reglas, incluidos los contextos que son exclusivos de EE. UU.

<Note>
  **Staging refleja producción**

  La validación de direcciones se comporta igual en staging que en producción, por lo que cualquier dirección real y actualmente entregable pasará la validación. Los siguientes ejemplos se proporcionan por comodidad y para activar resultados específicos.
</Note>

## Direcciones de prueba de EE. UU.

Cada una de estas es una dirección real de EE. UU. entregable por USPS que Smarty valida sin problemas. Una dirección real y entregable de **EE. UU.** funciona para **todos** los campos de dirección de la API: tarjetas virtuales, cuentas bancarias, tarjetas bancarias, KYC y 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        |

Para probar una unidad secundaria, agrega un número de apartamento o suite válido a `streetAddressLine2` (por ejemplo, `Apt 5` o `Ste 200`).

### Solicitud de ejemplo

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

## Direcciones de prueba internacionales

Estas son direcciones reales y entregables fuera de EE. UU. para probar contextos que aceptan direcciones internacionales.

<Note>
  **Dónde se aceptan las direcciones internacionales**

  Las direcciones internacionales funcionan para **direcciones de facturación de tarjetas bancarias**, **KYC** y **KYB**. **No** se aceptan para **direcciones de cuentas bancarias (ACH)** ni para **direcciones de facturación de tarjetas virtuales**; ambas son exclusivas de EE. UU. Enviar una dirección internacional para una tarjeta virtual devuelve `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        |

Algunos países no usan un estado o provincia. Como `state` es obligatorio en la mayoría de los objetos de dirección, proporciona la región administrativa más cercana (por ejemplo, la provincia, el condado o la región de la ciudad).

## Direcciones que fallan la validación

Usa estas para confirmar que tu aplicación maneja `VC-0025` (y otros rechazos) de forma adecuada. Ninguna de ellas guardará una dirección de tarjeta virtual.

| Address                                           | Result    | Why                                                                                                                                                                                                                                        |
| ------------------------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 2581 Oakwood Avenue, New York, NY 10605           | `VC-0025` | Discrepancia entre ciudad y código postal: `10605` corresponde a White Plains, NY, no a la ciudad de Nueva York, y no hay un punto de entrega coincidente.                                                                                 |
| 896 S State St, Dover, DE 19904                   | `VC-0025` | El número de edificio `896` no es un punto de entrega confirmado por USPS en esa calle y código postal.                                                                                                                                    |
| 123 Fake St, Springfield, IL 62704                | `VC-0025` | La calle no está presente en los datos de USPS.                                                                                                                                                                                            |
| PO Box 1001, Austin, TX 78701                     | Rechazado | El emisor de la tarjeta no acepta casillas postales.                                                                                                                                                                                       |
| 221B Baker Street, London NW1 6XE, United Kingdom | `VC-0025` | Dirección fuera de EE. UU.: las direcciones de tarjetas virtuales y cuentas bancarias son exclusivas de EE. UU. (Válida para facturación de tarjetas bancarias, KYC y KYB; consulta las Direcciones de prueba internacionales más arriba). |

### Ejemplo de solicitud fallida

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

Devuelve `VC-0025`. Reintentar con los mismos valores seguirá fallando: la dirección debe corregirse antes de poder guardarse.

## Próximos pasos

Ya tienes datos de prueba para cada parte del sandbox: tarjetas, cuentas bancarias, identidades, comercios y direcciones. Es momento de ponerlos en práctica.

<CardGroup cols={2}>
  <Card title="Guía rápida: tu primera compra de tarjeta de regalo" icon="gift" href="/quickstart">
    Ejecuta el flujo completo de extremo a extremo: deposita fondos, compra una tarjeta de regalo y revélala.
  </Card>

  <Card title="Requisitos de formato de dirección" icon="map-pin" href="/concepts/address-formatting-requirements">
    Las reglas de validación completas detrás de estos resultados, con ejemplos resueltos y manejo de errores.
  </Card>
</CardGroup>
