---
title: "Crear Tarjeta"
method: POST
path: "/v2/users/{user_id}/cards"
tags: ["Tarjetas"]
---

# Crear Tarjeta

`POST /v2/users/{user_id}/cards`

Crear una o más tarjetas para un usuario previamente creado

## Request body

- object[]
  - `address1` string — Dirección del tarjetahabiente
  - `card_cvv` string, required — Código de validación de la tarjeta
  - `card_holder` string, required — Nombre del tarjetahabiente
  - `card_holder_dni` string, required — Número de identificación del tarjetahabiente
  - `card_number` string, required — Número de la tarjeta
  - `card_verification_config` object — Permite sobrescribir configuraciones del cliente y verificar operabilidad de la tarjeta
    - `invoke_card_verification` boolean — En caso de que el valor sea false y el cliente tenga habilitada la configuración, no será ejecutado el paso de verificación; En caso de que sea true y el cliente tenga deshabilitada la configuración, se ejecutará la verificación.
  - `city` string — Ciudad de la dirección del tarjetahabiente
  - `country` string — País de la dirección del tarjetahabiente
  - `credential_source` 'apple_pay' | 'google_pay' | 'click_to_pay' — Origin of the card used to process the payment. Indicates the wallet through which the transaction is made.
  - `credential_source_config` CredentialSourceConfig — Wallet configuration containing the encrypted data required to process the payment.
    - `type` 'apple_pay' | 'google_pay' | 'click_to_pay' — Type of wallet from which the card originates.
    - `values` object — Wallet token values used to process the payment.
      - `correlationId` string — Mastercard Click to Pay correlation identifier. Used to correlate Mastercard SDK and API calls for the same checkout session. When available from the Mastercard Click to Pay flow, it must be provided to preserve the existing checkout session.
      - `dpa` string, uuid — Mastercard Digital Payment Application identifier for the merchant. Maps to Mastercard's `srcDpaId`. Identifies the onboarded merchant/DPA registered for Mastercard Click to Pay.
      - `encrypted_data` string — Encrypted token data. The value depends on the wallet: - **Apple Pay:** maps to `token.paymentData.data`. - **Google Pay:** maps to `paymentData.paymentMethodData.tokenizationData.token`.
      - `encryption_header` object — Encryption data. Applies only to Apple Pay integrations.
        - `ephemeral_public_key` string — Ephemeral public key. Maps to Apple Pay's `token.paymentData.header.ephemeralPublicKey`.
        - `public_key_hash` string — Public key hash. Maps to Apple Pay's `token.paymentData.header.publicKeyHash`.
        - `signature` string — Credential signature. Maps to Apple Pay's `token.paymentData.signature`.
      - `is_cvv_requested` boolean — Indicates whether the consumer was asked to provide CVV/CVC during the Click to Pay checkout flow. This field does not contain the CVV/CVC value.
      - `merchant_transaction_id` string — - **Apple Pay:** Unique transaction identifier. Maps to `token.paymentData.header.transactionId`. - **Click to Pay:** Mastercard merchant checkout transaction identifier. Maps to Mastercard's `merchantTransactionId` / `merchant-transaction-id`. Used to link the frontend Click to Pay SDK checkout response with server-side API calls for the same transaction.
      - `src_cx_flow_id` string — - **Click to Pay:** Mastercard SRC checkout flow identifier. Maps to Mastercard's `x-src-cx-flow-id`. Used to preserve session affinity and correlate subsequent backend calls with the same Mastercard Click to Pay checkout flow. - **Apple Pay:** `mobile` indicates native integration on mobile applications.
      - `system` string — - **Apple Pay:** Version associated with the token. Maps to `token.paymentData.version` (for example, `EC_v1`). - **Google Pay:** Token type. Maps to `paymentData.paymentMethodData.tokenizationData.type` (for example, `DIRECT`). - **Click to Pay:** Provider integration used for the Click to Pay credential source. Use `mastercard_ucs` for Mastercard Unified Checkout Solutions.
  - `expiry_month` string, required — Mes de expiración de la tarjeta en 2 dígitos (formato MM).
  - `expiry_year` string, required — Año de expiración de la tarjeta en 4 dígitos (formato YYYY).
  - `fraud_config` FraudConfig — Configuración del sistema anti-fraude
    - `device_id` string — Se trata de un identificador único generado automáticamente por el sistema de la pasarela de pagos seleccionada. Este identificador se crea al recopilar información del dispositivo utilizado durante la transacción, proporcionando así una capa adicional de seguridad al momento de agregar una tarjeta de pago.
    - `invoke_fraud_checkpoint` boolean — Enviar como true si se quiere invocar el motor de decisiones del sistema anti-fraude. Esta propiedad, va a reemplazar la configuración establecida a nivel comercio. Al enviar false, no se invocará el motor de decisiones, sin importar que la configuración a nivel comercio esté activa.
  - `is_default` boolean — Indicador de tarjeta por defecto
  - `phone` string — Número de teléfono del tarjetahabiente
  - `state` string — Estado de la dirección del tarjetahabiente
  - `zip` string — Código postal de la dirección del tarjetahabiente

## Response `201`

Created

- CardInformation[]
  - `card_brand` 'mastercard' | 'visa' | 'amex' | 'diners' | 'jcb' | 'alia' | 'carnet' | 'codensa' | 'elo' | 'serfinanza' | 'privada' | 'unionpay' | 'aurea' | 'cartesbancaires' | 'bancontact' | 'girocard' | 'hipercard' | 'naranja' | 'cabal' | 'argencard' | 'cordobesa' | 'eftpos' — Standardized card brand.
  - `card_holder` string, required — Nombre del tarjetahabiente
  - `card_holder_dni` string, required — Número de identificación del tarjetahabiente
  - `card_type` 'credit_card' | 'debit_card' — Tipo de tarjeta
  - `company` string — Compañía que emite la tarjeta
  - `created_at` string — Fecha en que fue creada la tarjeta(UTC), información interna DEUNA
  - `deleted_at` string — Fecha en que fue eliminada la tarjeta(UTC), información interna DEUNA
  - `expiration_date` string — Fecha de expiración de la tarjeta
  - `first_six` string — Primeros 6 dígitos de la tarjeta
  - `id` string — Identificador único de la tarjeta creado por DEUNA y se utiliza en el proceso de /purchase API
  - `is_default` boolean — Indicador de tarjeta por defecto
  - `last_four` string — Últimos 4 dígitos de la tarjeta
  - `last_used` string — Fecha de la última compra realizada con la tarjeta(UTC)
  - `updated_at` string — Fecha de modificacion de la tarjeta(UTC), información interna DEUNA
  - `user_id` string — Identificador del usuario

## Other responses

- `400` — Bad Request
- `401` — Token de usuario inválido o incorrecto
- `422` — Unprocessable

---

[API](https://skmtc.dev/deuna/apis/user-network-api.md) · [All operations](https://skmtc.dev/deuna/apis/user-network-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/deuna/user-network-api/revisions/df73fa00ed05/schema)