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

# The Card object

### Description

The Card object is the virtual and secured version (i.e., the tokenized version) of a card that can be used to make a payment.

The card object is created upon successfully completing the card registration process. The same actual card can be registered several times for security and privacy purposes. As a consequence, for a single real-life card, multiple Card objects can be created in the Mangopay environment.

<Warning>
  **Caution – Card validation within 24 hours**

  A successful transaction (preauthorization, pay-in, or recurring) or card validation within 24 hours of the card registration is required to validate a card. Otherwise, the card becomes invalid and a new card registration will be necessary.
</Warning>

### Attributes

<ParamField body="ExpirationDate" type="string">
  Format: “MMYY”

  The expiration date of the card.
</ParamField>

<ParamField body="Alias" type="string">
  The card number, partially obfuscated.
</ParamField>

<ParamField body="CardType" type="string">
  **Returned values:** `CB_VISA_MASTERCARD`, `AMEX`, `MAESTRO`, `BCMC`

  **Default value:** `CB_VISA_MASTERCARD`

  The type of the card. If not supplied, the default value will be taken into account.
</ParamField>

<ParamField body="CardProvider" type="string">
  **Allowed values:** `CB`, `VISA`, `MASTERCARD`, `AMEX`, `MAESTRO`, `BCMC`, `JCB`, `DISCOVER`

  The provider of the card.
</ParamField>

<ParamField body="Country" type="string">
  Format: ISO-3166-1 alpha-3 three-letter country code (e.g., “FRA”)

  The country of the card (which is the same as the country of the issuer).
</ParamField>

<ParamField body="Product" type="string">
  The product type of the card.
</ParamField>

<ResponseField name="BankCode" type="string">
  The name of the card issuing bank.
</ResponseField>

<ParamField body="Active" type="boolean">
  Whether the card is active or not. Setting this parameter to `false` is irreversible and should be done once the pay-in is successful.
</ParamField>

<ParamField body="Currency" type="string">
  **Returned values:** The three-letter <a href="/api-reference/overview/data-formats" target="_blank">ISO 4217 code</a> (EUR, GBP, etc.) of a <a href="/guides/currencies" target="_blank">supported currency</a> (depends on feature, contract, and activation settings).

  The currency of the card.
</ParamField>

<ParamField body="Validity" type="string">
  **Returned values:** `UNKNOWN`, `VALID`, `INVALID`

  Whether the card is valid or not.

  * `UNKNOWN` – No payment or card validation has been processed, so the validity of the card remains unknown.
  * `VALID` – The first payment or card validation using the card was processed successfully within 24 hours of the initial card registration.
  * `INVALID` – The first payment or card validation using the card was attempted and failed, or the status of the corresponding card registration was `CREATED` for more than 24 hours.\
    Once a card is set to `INVALID`, it cannot be set back to `VALID`. A new card registration will be necessary to make a payment.
</ParamField>

<ParamField body="UserId" type="string">
  The unique identifier of the user the card belongs to.
</ParamField>

<ParamField body="Id" type="string">
  The unique identifier of the Card object.
</ParamField>

<ParamField body="Tag" type="string">
  Custom data added to this object.\
  In the case of the Card object, the tag value is inherited from the Card Registration object and is not editable.
</ParamField>

<ParamField body="CreationDate" type="Unix timestamp">
  The date and time at which the object was created.
</ParamField>

<ParamField body="Fingerprint" type="string">
  The unique representation of the card number. This string can be used to track the card behavior while keeping the card information confidential.
</ParamField>

<ParamField body="CardHolderName" type="string">
  Max. length: 45 characters

  The cardholder’s name shown on the payment card. This value is passed to the card network for use in transaction risk analysis.
</ParamField>

### Related resources

<CardGroup cols={2}>
  <Card title="How to" href="/guides/payment-methods/card/direct/how-to">
    Learn how to process a card payment
  </Card>

  <Card title="Guide" href="/guides/payment-methods/card">
    Learn about card registration and processing
  </Card>

  <Card title="Testing" href="/testing/payment-methods">
    Learn more about testing all payment methods
  </Card>

  <Card title="Checkout SDK" href="/sdks/checkout">
    Simplify card registration with Checkout SDK
  </Card>
</CardGroup>