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

# Crear tarjetas

> Crea una nueva tarjeta en tu cuenta.

### Headers

<ParamField header="x-idempotency" type="string" required placeholder="Token único para garantizar la idempotencia de la petición">
  Token único para garantizar la idempotencia de la petición
</ParamField>

### Body

<ParamField body="customer_id" type="string" required placeholder="9dd4158b-0e45-42bc-b56f-a4c1f856814d">
  ID del cliente al que se le asignará la tarjeta. [Crear cliente](/client/customers/create).
</ParamField>

<ParamField body="wallet_id" type="string" required>
  ID de la billetera al que se le asignará la tarjeta.
</ParamField>

<ParamField body="nickname" type="string">
  Apodo para la tarjeta.
</ParamField>

<ParamField body="type" type="string" required placeholder="physical | virtual">
  Tipo de tarjeta.
</ParamField>

<ParamField body="address" type="object" required>
  Dirección de envío de la tarjeta.

  <Expandable title="properties">
    <ParamField body="line_1" type="string" required placeholder="Calle 123">
      Primera línea de la dirección.
    </ParamField>

    <ParamField body="line_2" type="string" required placeholder="Apto 123">
      Segunda línea de la dirección.
    </ParamField>

    <ParamField body="city" type="string" required placeholder="Ciudad">
      Ciudad de la dirección.
    </ParamField>

    <ParamField body="state" type="string" required placeholder="Estado">
      Estado de la dirección.
    </ParamField>

    <ParamField body="country" type="string" required placeholder="Código de país ISO 3166-1 alfa-2, CO, MX, US">
      Código de país ISO 3166-1 alfa-2
    </ParamField>

    <ParamField body="zip_code" type="string" required placeholder="12345">
      Código postal de la dirección.
    </ParamField>
  </Expandable>
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "9e4298cb-ad7b-40f0-929d-a68e20a561c9",
    "status": "created",
    "last_4": null,
    "nickname": null,
    "type": "physical",
    "customer_id": "9e4298cb-a9a4-476d-8c7d-287c0f1e103b",
    "wallet_id": "0195255e-3258-707e-bfaf-3f6807d12d60",
    "customer": {
      "id": "9e4298cb-a9a4-476d-8c7d-287c0f1e103b",
      "first_name": "Rossie",
      "last_name": "Rempel",
      "email": "",
      "phone": "+12259504339",
      "document_type": "CC",
      "document_number": "72827",
      "created_at": "2025-02-20T21:58:05.000000Z",
      "is_test": true
    },
    "address": {
      "line_1": "125 Novella Turnpike",
      "line_2": "40003 Lang Circle Suite 752",
      "state": "Boylefurt",
      "city": "Port Alessiaton",
      "country": "Zambia"
    },
    "wallet": {
      "id": "0195255e-3258-707e-bfaf-3f6807d12d60",
      "balance": 0,
      "label": "$0"
    }
  }
  ```

  ```json 422 theme={null}
  {
      "message": "The customer id field is required. (and 7 more errors)",
      "code": 10001,
      "code_name": "validation_error",
      "errors": {
          "customer_id": [
              "The customer id field is required."
          ],
          "wallet_id": [
              "The wallet id field is required."
          ],
          "address": [
              "The address field is required."
          ],
          "address.line_1": [
              "The address.line 1 field is required."
          ],
          "address.city": [
              "The address.city field is required."
          ],
          "address.state": [
              "The address.state field is required."
          ],
          "address.zip_code": [
              "The address.zip code field is required."
          ],
          "address.country": [
              "The address.country field is required."
          ]
      }
  }
  ```

  ```json 409 theme={null}
  {
    "message": "No se puede generar la operación, genera un token de idempotencia y envíelo en los headers como x-idempotency",
    "code": 10003,
    "code_name": "idempotency_error"
  }
  ```
</ResponseExample>