> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://infonite.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://infonite.dev/_mcp/server.

# Cards

**Where it lives:** at `cards` in the **Financial Position**, and on its own from the cards endpoint.

One endpoint returns all three kinds, and `sub_family` says which one you are holding. They share most of their shape; what differs is the part that matters for risk.

## Credit cards

The ones that carry debt: `limit` is what the issuer granted, `disposed` is what has been used, `available` is what is left.

### Schema (`CreditCardSchema`)

```yaml
components:
  schemas:
    PaymentCardBrand:
      type: string
      enum:
        - American Express
        - Mastercard
        - Visa
        - Mir
        - Maestro
        - Discover
        - Verve
        - Dankort
        - Troy
        - UnionPay
        - JCB
        - Diners Club
        - other
      description: >-
        Payment card brands supported by the
        [`PaymentCardNumber`][pydantic_extra_types.payment.PaymentCardNumber].
      title: PaymentCardBrand
    PanIdentifierSchema:
      type: object
      properties:
        type:
          type: string
          enum:
            - pan
        masked:
          type: string
          minLength: 1
          maxLength: 19
          description: Partial PAN
        brand:
          $ref: '#/components/schemas/PaymentCardBrand'
          description: Card brand
      required:
        - type
        - masked
      description: Primary Account Number
      title: PanIdentifierSchema
    CustomerSegment:
      type: string
      enum:
        - not_assigned
        - personal
        - business
        - corporate
        - private
        - retail
      title: CustomerSegment
    FinancialCardStatus:
      type: string
      enum:
        - unknown
        - active
        - cancelled
        - blocked
      title: FinancialCardStatus
    IBANIdentifierSchema:
      type: object
      properties:
        value:
          type: string
          format: iban
          description: International Bank Account Number
        masked:
          type: string
          minLength: 1
          maxLength: 34
          description: Partial IBAN
        entity_country:
          type: string
          description: Bank Country
        entity_code:
          type: string
          description: Bank code
        entity_office:
          type: string
          description: Bank office
        control_digits:
          type: string
          description: Control digits
      required:
        - value
        - masked
        - entity_country
        - entity_code
        - entity_office
        - control_digits
      description: International Bank Account Number
      title: IBANIdentifierSchema
    ClabeIdentifierSchema:
      type: object
      properties:
        value:
          type: string
          format: clabe
          description: Clave Bancaria Estandarizada
        masked:
          type: string
          minLength: 1
          maxLength: 19
          description: Partial Clabe
        entity_country:
          type: string
          description: Bank Country
        entity_code:
          type: string
          description: Bank code
        entity_office:
          type: string
          description: Bank office
        control_digits:
          type: string
          description: Control digit
      required:
        - value
        - masked
        - entity_country
        - entity_code
        - entity_office
        - control_digits
      description: Clave Bancaria Estandarizada
      title: ClabeIdentifierSchema
    GenericIdentifierSchema:
      type: object
      properties:
        value:
          type: string
          description: Identifier
        entity_country:
          type: string
          format: country
          description: Entity country
        entity_code:
          type: string
          description: Entity code
        entity_office:
          type: string
          description: Entity office
        control_digits:
          type: string
          description: Control digits
      required:
        - value
      description: Generic account identifier
      title: GenericIdentifierSchema
    CreditCardSchemaLinkedAccount:
      oneOf:
        - $ref: '#/components/schemas/IBANIdentifierSchema'
        - $ref: '#/components/schemas/ClabeIdentifierSchema'
        - $ref: '#/components/schemas/GenericIdentifierSchema'
      description: Linked account, if proceeds
      title: CreditCardSchemaLinkedAccount
    InfoniteSchemasUtilsCurrencyAmountSchema1Currency:
      oneOf:
        - type: string
          format: currency
        - type: string
          enum:
            - '***'
      description: >-
        Three-letter ISO currency code — or `***` when the source did not
        disclose the currency.
      title: InfoniteSchemasUtilsCurrencyAmountSchema1Currency
    infonite__schemas__utils__CurrencyAmountSchema__1:
      type: object
      properties:
        currency:
          $ref: >-
            #/components/schemas/InfoniteSchemasUtilsCurrencyAmountSchema1Currency
          description: >-
            Three-letter ISO currency code — or `***` when the source did not
            disclose the currency.
        amount:
          type: string
          format: number
          description: Decimal number with 2 digits precision
      required:
        - currency
        - amount
      description: A monetary amount together with its currency.
      title: infonite__schemas__utils__CurrencyAmountSchema__1
    FinancialTransactionType:
      type: string
      enum:
        - unknown
        - opening
        - closure
        - credit
        - debit
        - default
      title: FinancialTransactionType
    FinancialTransactionStatus:
      type: string
      enum:
        - unknown
        - pending
        - booked
        - cancelled
        - failed
        - reversed
      title: FinancialTransactionStatus
    IdentificationNumberSchemaType:
      type: string
      enum:
        - unknown
        - es:dni
        - es:nie
        - es:cif
        - es:ssn
        - co:cc
        - co:ce
        - co:nit
        - co:ti
      description: >-
        Kind of document the number belongs to (e.g. a national ID, passport,
        tax ID, or Social

        Security number).
      title: IdentificationNumberSchemaType
    IdentificationNumberSchema:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/IdentificationNumberSchemaType'
          description: >-
            Kind of document the number belongs to (e.g. a national ID,
            passport, tax ID, or Social

            Security number).
        value:
          type: string
          description: The number itself, as reported by the source.
        validated:
          type: boolean
          description: >-
            True when the value passed the platform's format and check-digit
            validation. It vouches for

            the NUMBER being well-formed — not for the official status of the
            document behind it.
        country:
          type:
            - string
            - 'null'
          format: country
          description: Country that issued the number, as a two-letter ISO code.
        valid_until:
          type: string
          format: date
          description: Expiry date of the document, when the source reports it.
      required:
        - type
        - value
        - validated
      description: >-
        One identification document: its type, its value, and whether the value
        passed validation.
      title: IdentificationNumberSchema
    EntitySchema:
      type: object
      properties:
        name:
          type: string
          description: Name
        code:
          type: string
          description: Code
        country_code:
          type: string
          format: country
          description: Country Code
        identifier:
          $ref: '#/components/schemas/IdentificationNumberSchema'
          description: Holder identifier
      title: EntitySchema
    CardTransactionSchema:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/FinancialTransactionType'
          description: Transaction type
        status:
          $ref: '#/components/schemas/FinancialTransactionStatus'
          description: Transaction status
        value_date:
          type: string
          format: date
          description: >-
            Represents the moment when funds were set aside for a specific
            transaction, ensuring their readiness for eventual processing. From
            a banking perspective, this might appear as a temporary allocation
            or pre-authorization related to the purchase.
        amount:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Transaction amount
        descriptions:
          type: array
          items:
            type: string
          description: Original transaction descriptions
        provider_id:
          type: string
          description: Unique ID for the transaction in the provider system
        merchant:
          $ref: '#/components/schemas/EntitySchema'
          description: Merchant information, if available
      required:
        - type
        - status
      title: CardTransactionSchema
    CreditCardSchema:
      type: object
      properties:
        id:
          type: string
          format: object-id
          description: >-
            Product ID for the current execution. Note: it may change between
            executions.
        product:
          type: string
          enum:
            - financial_card
        sub_family:
          type: string
          enum:
            - financial_card:credit
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        identifier:
          $ref: '#/components/schemas/PanIdentifierSchema'
          description: PAN
        entity_country:
          type: string
          format: country
          description: Entity country
        entity_code:
          type: string
          description: Entity code
        customer_segment:
          $ref: '#/components/schemas/CustomerSegment'
        product_name:
          type: string
          description: Product name
        product_alias:
          type: string
          description: Product alias
        product_description:
          type: string
          description: Product Description
        holder_name:
          type: string
          description: Card holder name
        status:
          $ref: '#/components/schemas/FinancialCardStatus'
        expiration_date:
          type: string
          format: date
          description: Card expiration date
        linked_account:
          $ref: '#/components/schemas/CreditCardSchemaLinkedAccount'
          description: Linked account, if proceeds
        available:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            The current amount of credit that a user has access to, based on
            their credit limit minus any current outstanding balances or pending
            transactions. It indicates the remaining amount the user can still
            borrow or use.
        disposed:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: The current amount of credit that a user has used or withdrawn.
        limit:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            The maximum amount of credit that a financial institution extends to
            a client through a line of credit. This represents the maximum
            amount of credit that a user can use or withdraw.
        payment_amount:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            The smallest amount that must be paid by a specified due date to
            keep the account in good standing and avoid potential penalties or
            additional interest charges. This amount generally covers the
            accrued interest and may include a portion of the principal balance.
            Paying only this amount by the due date may result in carrying a
            balance to the next billing cycle, which could incur interest.
        next_payment_date:
          type: string
          format: date
          description: Next Payment Date
        billing_period_start:
          type: string
          format: date
          description: Period Start Date
        billing_period_end:
          type: string
          format: date
          description: Period End Date
        transactions:
          type: array
          items:
            $ref: '#/components/schemas/CardTransactionSchema'
          description: Card transactions
      required:
        - id
        - product
        - sub_family
        - fetch_date
        - identifier
        - customer_segment
        - product_name
        - status
      title: CreditCardSchema
```

## Debit cards

Bound to an account, spending its balance rather than a credit line.

### Schema (`DebitCardSchema`)

```yaml
components:
  schemas:
    PaymentCardBrand:
      type: string
      enum:
        - American Express
        - Mastercard
        - Visa
        - Mir
        - Maestro
        - Discover
        - Verve
        - Dankort
        - Troy
        - UnionPay
        - JCB
        - Diners Club
        - other
      description: >-
        Payment card brands supported by the
        [`PaymentCardNumber`][pydantic_extra_types.payment.PaymentCardNumber].
      title: PaymentCardBrand
    PanIdentifierSchema:
      type: object
      properties:
        type:
          type: string
          enum:
            - pan
        masked:
          type: string
          minLength: 1
          maxLength: 19
          description: Partial PAN
        brand:
          $ref: '#/components/schemas/PaymentCardBrand'
          description: Card brand
      required:
        - type
        - masked
      description: Primary Account Number
      title: PanIdentifierSchema
    CustomerSegment:
      type: string
      enum:
        - not_assigned
        - personal
        - business
        - corporate
        - private
        - retail
      title: CustomerSegment
    FinancialCardStatus:
      type: string
      enum:
        - unknown
        - active
        - cancelled
        - blocked
      title: FinancialCardStatus
    IBANIdentifierSchema:
      type: object
      properties:
        value:
          type: string
          format: iban
          description: International Bank Account Number
        masked:
          type: string
          minLength: 1
          maxLength: 34
          description: Partial IBAN
        entity_country:
          type: string
          description: Bank Country
        entity_code:
          type: string
          description: Bank code
        entity_office:
          type: string
          description: Bank office
        control_digits:
          type: string
          description: Control digits
      required:
        - value
        - masked
        - entity_country
        - entity_code
        - entity_office
        - control_digits
      description: International Bank Account Number
      title: IBANIdentifierSchema
    ClabeIdentifierSchema:
      type: object
      properties:
        value:
          type: string
          format: clabe
          description: Clave Bancaria Estandarizada
        masked:
          type: string
          minLength: 1
          maxLength: 19
          description: Partial Clabe
        entity_country:
          type: string
          description: Bank Country
        entity_code:
          type: string
          description: Bank code
        entity_office:
          type: string
          description: Bank office
        control_digits:
          type: string
          description: Control digit
      required:
        - value
        - masked
        - entity_country
        - entity_code
        - entity_office
        - control_digits
      description: Clave Bancaria Estandarizada
      title: ClabeIdentifierSchema
    GenericIdentifierSchema:
      type: object
      properties:
        value:
          type: string
          description: Identifier
        entity_country:
          type: string
          format: country
          description: Entity country
        entity_code:
          type: string
          description: Entity code
        entity_office:
          type: string
          description: Entity office
        control_digits:
          type: string
          description: Control digits
      required:
        - value
      description: Generic account identifier
      title: GenericIdentifierSchema
    DebitCardSchemaLinkedAccount:
      oneOf:
        - $ref: '#/components/schemas/IBANIdentifierSchema'
        - $ref: '#/components/schemas/ClabeIdentifierSchema'
        - $ref: '#/components/schemas/GenericIdentifierSchema'
      description: Linked account, if proceeds
      title: DebitCardSchemaLinkedAccount
    FinancialTransactionType:
      type: string
      enum:
        - unknown
        - opening
        - closure
        - credit
        - debit
        - default
      title: FinancialTransactionType
    FinancialTransactionStatus:
      type: string
      enum:
        - unknown
        - pending
        - booked
        - cancelled
        - failed
        - reversed
      title: FinancialTransactionStatus
    InfoniteSchemasUtilsCurrencyAmountSchema1Currency:
      oneOf:
        - type: string
          format: currency
        - type: string
          enum:
            - '***'
      description: >-
        Three-letter ISO currency code — or `***` when the source did not
        disclose the currency.
      title: InfoniteSchemasUtilsCurrencyAmountSchema1Currency
    infonite__schemas__utils__CurrencyAmountSchema__1:
      type: object
      properties:
        currency:
          $ref: >-
            #/components/schemas/InfoniteSchemasUtilsCurrencyAmountSchema1Currency
          description: >-
            Three-letter ISO currency code — or `***` when the source did not
            disclose the currency.
        amount:
          type: string
          format: number
          description: Decimal number with 2 digits precision
      required:
        - currency
        - amount
      description: A monetary amount together with its currency.
      title: infonite__schemas__utils__CurrencyAmountSchema__1
    IdentificationNumberSchemaType:
      type: string
      enum:
        - unknown
        - es:dni
        - es:nie
        - es:cif
        - es:ssn
        - co:cc
        - co:ce
        - co:nit
        - co:ti
      description: >-
        Kind of document the number belongs to (e.g. a national ID, passport,
        tax ID, or Social

        Security number).
      title: IdentificationNumberSchemaType
    IdentificationNumberSchema:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/IdentificationNumberSchemaType'
          description: >-
            Kind of document the number belongs to (e.g. a national ID,
            passport, tax ID, or Social

            Security number).
        value:
          type: string
          description: The number itself, as reported by the source.
        validated:
          type: boolean
          description: >-
            True when the value passed the platform's format and check-digit
            validation. It vouches for

            the NUMBER being well-formed — not for the official status of the
            document behind it.
        country:
          type:
            - string
            - 'null'
          format: country
          description: Country that issued the number, as a two-letter ISO code.
        valid_until:
          type: string
          format: date
          description: Expiry date of the document, when the source reports it.
      required:
        - type
        - value
        - validated
      description: >-
        One identification document: its type, its value, and whether the value
        passed validation.
      title: IdentificationNumberSchema
    EntitySchema:
      type: object
      properties:
        name:
          type: string
          description: Name
        code:
          type: string
          description: Code
        country_code:
          type: string
          format: country
          description: Country Code
        identifier:
          $ref: '#/components/schemas/IdentificationNumberSchema'
          description: Holder identifier
      title: EntitySchema
    CardTransactionSchema:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/FinancialTransactionType'
          description: Transaction type
        status:
          $ref: '#/components/schemas/FinancialTransactionStatus'
          description: Transaction status
        value_date:
          type: string
          format: date
          description: >-
            Represents the moment when funds were set aside for a specific
            transaction, ensuring their readiness for eventual processing. From
            a banking perspective, this might appear as a temporary allocation
            or pre-authorization related to the purchase.
        amount:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Transaction amount
        descriptions:
          type: array
          items:
            type: string
          description: Original transaction descriptions
        provider_id:
          type: string
          description: Unique ID for the transaction in the provider system
        merchant:
          $ref: '#/components/schemas/EntitySchema'
          description: Merchant information, if available
      required:
        - type
        - status
      title: CardTransactionSchema
    DebitCardSchema:
      type: object
      properties:
        id:
          type: string
          format: object-id
          description: >-
            Product ID for the current execution. Note: it may change between
            executions.
        product:
          type: string
          enum:
            - financial_card
        sub_family:
          type: string
          enum:
            - financial_card:debit
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        identifier:
          $ref: '#/components/schemas/PanIdentifierSchema'
          description: PAN
        entity_country:
          type: string
          format: country
          description: Entity country
        entity_code:
          type: string
          description: Entity code
        customer_segment:
          $ref: '#/components/schemas/CustomerSegment'
        product_name:
          type: string
          description: Product name
        product_alias:
          type: string
          description: Product alias
        product_description:
          type: string
          description: Product Description
        holder_name:
          type: string
          description: Card holder name
        status:
          $ref: '#/components/schemas/FinancialCardStatus'
        expiration_date:
          type: string
          format: date
          description: Card expiration date
        linked_account:
          $ref: '#/components/schemas/DebitCardSchemaLinkedAccount'
          description: Linked account, if proceeds
        transactions:
          type: array
          items:
            $ref: '#/components/schemas/CardTransactionSchema'
          description: Card transactions
      required:
        - id
        - product
        - sub_family
        - fetch_date
        - identifier
        - customer_segment
        - product_name
        - status
      title: DebitCardSchema
```

## Prepaid cards

Loaded in advance, with a balance of their own.

### Schema (`PrepaidCardSchema`)

```yaml
components:
  schemas:
    PaymentCardBrand:
      type: string
      enum:
        - American Express
        - Mastercard
        - Visa
        - Mir
        - Maestro
        - Discover
        - Verve
        - Dankort
        - Troy
        - UnionPay
        - JCB
        - Diners Club
        - other
      description: >-
        Payment card brands supported by the
        [`PaymentCardNumber`][pydantic_extra_types.payment.PaymentCardNumber].
      title: PaymentCardBrand
    PanIdentifierSchema:
      type: object
      properties:
        type:
          type: string
          enum:
            - pan
        masked:
          type: string
          minLength: 1
          maxLength: 19
          description: Partial PAN
        brand:
          $ref: '#/components/schemas/PaymentCardBrand'
          description: Card brand
      required:
        - type
        - masked
      description: Primary Account Number
      title: PanIdentifierSchema
    CustomerSegment:
      type: string
      enum:
        - not_assigned
        - personal
        - business
        - corporate
        - private
        - retail
      title: CustomerSegment
    FinancialCardStatus:
      type: string
      enum:
        - unknown
        - active
        - cancelled
        - blocked
      title: FinancialCardStatus
    IBANIdentifierSchema:
      type: object
      properties:
        value:
          type: string
          format: iban
          description: International Bank Account Number
        masked:
          type: string
          minLength: 1
          maxLength: 34
          description: Partial IBAN
        entity_country:
          type: string
          description: Bank Country
        entity_code:
          type: string
          description: Bank code
        entity_office:
          type: string
          description: Bank office
        control_digits:
          type: string
          description: Control digits
      required:
        - value
        - masked
        - entity_country
        - entity_code
        - entity_office
        - control_digits
      description: International Bank Account Number
      title: IBANIdentifierSchema
    ClabeIdentifierSchema:
      type: object
      properties:
        value:
          type: string
          format: clabe
          description: Clave Bancaria Estandarizada
        masked:
          type: string
          minLength: 1
          maxLength: 19
          description: Partial Clabe
        entity_country:
          type: string
          description: Bank Country
        entity_code:
          type: string
          description: Bank code
        entity_office:
          type: string
          description: Bank office
        control_digits:
          type: string
          description: Control digit
      required:
        - value
        - masked
        - entity_country
        - entity_code
        - entity_office
        - control_digits
      description: Clave Bancaria Estandarizada
      title: ClabeIdentifierSchema
    GenericIdentifierSchema:
      type: object
      properties:
        value:
          type: string
          description: Identifier
        entity_country:
          type: string
          format: country
          description: Entity country
        entity_code:
          type: string
          description: Entity code
        entity_office:
          type: string
          description: Entity office
        control_digits:
          type: string
          description: Control digits
      required:
        - value
      description: Generic account identifier
      title: GenericIdentifierSchema
    PrepaidCardSchemaLinkedAccount:
      oneOf:
        - $ref: '#/components/schemas/IBANIdentifierSchema'
        - $ref: '#/components/schemas/ClabeIdentifierSchema'
        - $ref: '#/components/schemas/GenericIdentifierSchema'
      description: Linked account, if proceeds
      title: PrepaidCardSchemaLinkedAccount
    InfoniteSchemasUtilsCurrencyAmountSchema1Currency:
      oneOf:
        - type: string
          format: currency
        - type: string
          enum:
            - '***'
      description: >-
        Three-letter ISO currency code — or `***` when the source did not
        disclose the currency.
      title: InfoniteSchemasUtilsCurrencyAmountSchema1Currency
    infonite__schemas__utils__CurrencyAmountSchema__1:
      type: object
      properties:
        currency:
          $ref: >-
            #/components/schemas/InfoniteSchemasUtilsCurrencyAmountSchema1Currency
          description: >-
            Three-letter ISO currency code — or `***` when the source did not
            disclose the currency.
        amount:
          type: string
          format: number
          description: Decimal number with 2 digits precision
      required:
        - currency
        - amount
      description: A monetary amount together with its currency.
      title: infonite__schemas__utils__CurrencyAmountSchema__1
    FinancialTransactionType:
      type: string
      enum:
        - unknown
        - opening
        - closure
        - credit
        - debit
        - default
      title: FinancialTransactionType
    FinancialTransactionStatus:
      type: string
      enum:
        - unknown
        - pending
        - booked
        - cancelled
        - failed
        - reversed
      title: FinancialTransactionStatus
    IdentificationNumberSchemaType:
      type: string
      enum:
        - unknown
        - es:dni
        - es:nie
        - es:cif
        - es:ssn
        - co:cc
        - co:ce
        - co:nit
        - co:ti
      description: >-
        Kind of document the number belongs to (e.g. a national ID, passport,
        tax ID, or Social

        Security number).
      title: IdentificationNumberSchemaType
    IdentificationNumberSchema:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/IdentificationNumberSchemaType'
          description: >-
            Kind of document the number belongs to (e.g. a national ID,
            passport, tax ID, or Social

            Security number).
        value:
          type: string
          description: The number itself, as reported by the source.
        validated:
          type: boolean
          description: >-
            True when the value passed the platform's format and check-digit
            validation. It vouches for

            the NUMBER being well-formed — not for the official status of the
            document behind it.
        country:
          type:
            - string
            - 'null'
          format: country
          description: Country that issued the number, as a two-letter ISO code.
        valid_until:
          type: string
          format: date
          description: Expiry date of the document, when the source reports it.
      required:
        - type
        - value
        - validated
      description: >-
        One identification document: its type, its value, and whether the value
        passed validation.
      title: IdentificationNumberSchema
    EntitySchema:
      type: object
      properties:
        name:
          type: string
          description: Name
        code:
          type: string
          description: Code
        country_code:
          type: string
          format: country
          description: Country Code
        identifier:
          $ref: '#/components/schemas/IdentificationNumberSchema'
          description: Holder identifier
      title: EntitySchema
    CardTransactionSchema:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/FinancialTransactionType'
          description: Transaction type
        status:
          $ref: '#/components/schemas/FinancialTransactionStatus'
          description: Transaction status
        value_date:
          type: string
          format: date
          description: >-
            Represents the moment when funds were set aside for a specific
            transaction, ensuring their readiness for eventual processing. From
            a banking perspective, this might appear as a temporary allocation
            or pre-authorization related to the purchase.
        amount:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Transaction amount
        descriptions:
          type: array
          items:
            type: string
          description: Original transaction descriptions
        provider_id:
          type: string
          description: Unique ID for the transaction in the provider system
        merchant:
          $ref: '#/components/schemas/EntitySchema'
          description: Merchant information, if available
      required:
        - type
        - status
      title: CardTransactionSchema
    PrepaidCardSchema:
      type: object
      properties:
        id:
          type: string
          format: object-id
          description: >-
            Product ID for the current execution. Note: it may change between
            executions.
        product:
          type: string
          enum:
            - financial_card
        sub_family:
          type: string
          enum:
            - financial_card:prepaid
        fetch_date:
          type: string
          format: datetime
          description: Date this product was fetched
        identifier:
          $ref: '#/components/schemas/PanIdentifierSchema'
          description: PAN
        entity_country:
          type: string
          format: country
          description: Entity country
        entity_code:
          type: string
          description: Entity code
        customer_segment:
          $ref: '#/components/schemas/CustomerSegment'
        product_name:
          type: string
          description: Product name
        product_alias:
          type: string
          description: Product alias
        product_description:
          type: string
          description: Product Description
        holder_name:
          type: string
          description: Card holder name
        status:
          $ref: '#/components/schemas/FinancialCardStatus'
        expiration_date:
          type: string
          format: date
          description: Card expiration date
        linked_account:
          $ref: '#/components/schemas/PrepaidCardSchemaLinkedAccount'
          description: Linked account, if proceeds
        available:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: >-
            For cards with a prepaid function, this indicates the current
            available prepaid balance that a user can access.
        transactions:
          type: array
          items:
            $ref: '#/components/schemas/CardTransactionSchema'
          description: Card transactions
      required:
        - id
        - product
        - sub_family
        - fetch_date
        - identifier
        - customer_segment
        - product_name
        - status
      title: PrepaidCardSchema
```

## Type, status and brand

### Schema (`FinancialCardType`)

```yaml
components:
  schemas:
    FinancialCardType:
      type: string
      enum:
        - financial_card:debit
        - financial_card:credit
        - financial_card:prepaid
        - financial_card:mixed
      title: FinancialCardType
```

### Schema (`FinancialCardStatus`)

```yaml
components:
  schemas:
    FinancialCardStatus:
      type: string
      enum:
        - unknown
        - active
        - cancelled
        - blocked
      title: FinancialCardStatus
```

### Schema (`PaymentCardBrand`)

Payment card brands supported by the \[`PaymentCardNumber`]\[pydantic\_extra\_types.payment.PaymentCardNumber].

```yaml
components:
  schemas:
    PaymentCardBrand:
      type: string
      enum:
        - American Express
        - Mastercard
        - Visa
        - Mir
        - Maestro
        - Discover
        - Verve
        - Dankort
        - Troy
        - UnionPay
        - JCB
        - Diners Club
        - other
      title: PaymentCardBrand
```

## Movements

Card transactions are shaped like account transactions but shorter — a card movement has no running balance of its own.

### Schema (`CardTransactionSchema`)

```yaml
components:
  schemas:
    FinancialTransactionType:
      type: string
      enum:
        - unknown
        - opening
        - closure
        - credit
        - debit
        - default
      title: FinancialTransactionType
    FinancialTransactionStatus:
      type: string
      enum:
        - unknown
        - pending
        - booked
        - cancelled
        - failed
        - reversed
      title: FinancialTransactionStatus
    InfoniteSchemasUtilsCurrencyAmountSchema1Currency:
      oneOf:
        - type: string
          format: currency
        - type: string
          enum:
            - '***'
      description: >-
        Three-letter ISO currency code — or `***` when the source did not
        disclose the currency.
      title: InfoniteSchemasUtilsCurrencyAmountSchema1Currency
    infonite__schemas__utils__CurrencyAmountSchema__1:
      type: object
      properties:
        currency:
          $ref: >-
            #/components/schemas/InfoniteSchemasUtilsCurrencyAmountSchema1Currency
          description: >-
            Three-letter ISO currency code — or `***` when the source did not
            disclose the currency.
        amount:
          type: string
          format: number
          description: Decimal number with 2 digits precision
      required:
        - currency
        - amount
      description: A monetary amount together with its currency.
      title: infonite__schemas__utils__CurrencyAmountSchema__1
    IdentificationNumberSchemaType:
      type: string
      enum:
        - unknown
        - es:dni
        - es:nie
        - es:cif
        - es:ssn
        - co:cc
        - co:ce
        - co:nit
        - co:ti
      description: >-
        Kind of document the number belongs to (e.g. a national ID, passport,
        tax ID, or Social

        Security number).
      title: IdentificationNumberSchemaType
    IdentificationNumberSchema:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/IdentificationNumberSchemaType'
          description: >-
            Kind of document the number belongs to (e.g. a national ID,
            passport, tax ID, or Social

            Security number).
        value:
          type: string
          description: The number itself, as reported by the source.
        validated:
          type: boolean
          description: >-
            True when the value passed the platform's format and check-digit
            validation. It vouches for

            the NUMBER being well-formed — not for the official status of the
            document behind it.
        country:
          type:
            - string
            - 'null'
          format: country
          description: Country that issued the number, as a two-letter ISO code.
        valid_until:
          type: string
          format: date
          description: Expiry date of the document, when the source reports it.
      required:
        - type
        - value
        - validated
      description: >-
        One identification document: its type, its value, and whether the value
        passed validation.
      title: IdentificationNumberSchema
    EntitySchema:
      type: object
      properties:
        name:
          type: string
          description: Name
        code:
          type: string
          description: Code
        country_code:
          type: string
          format: country
          description: Country Code
        identifier:
          $ref: '#/components/schemas/IdentificationNumberSchema'
          description: Holder identifier
      title: EntitySchema
    CardTransactionSchema:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/FinancialTransactionType'
          description: Transaction type
        status:
          $ref: '#/components/schemas/FinancialTransactionStatus'
          description: Transaction status
        value_date:
          type: string
          format: date
          description: >-
            Represents the moment when funds were set aside for a specific
            transaction, ensuring their readiness for eventual processing. From
            a banking perspective, this might appear as a temporary allocation
            or pre-authorization related to the purchase.
        amount:
          $ref: >-
            #/components/schemas/infonite__schemas__utils__CurrencyAmountSchema__1
          description: Transaction amount
        descriptions:
          type: array
          items:
            type: string
          description: Original transaction descriptions
        provider_id:
          type: string
          description: Unique ID for the transaction in the provider system
        merchant:
          $ref: '#/components/schemas/EntitySchema'
          description: Merchant information, if available
      required:
        - type
        - status
      title: CardTransactionSchema
```

**Card numbers are never reconstructed.** What comes back is what the institution itself displays — a masked number — and it is handled as protected data end to end. Use `identifier` to recognise the same card across extractions, not to store a PAN.