Lightweight descriptor of the currently selected card number context.

Returned inside CardFormEmbedState.cardNumberInfo so the host can distinguish whether the user is paying with a previously stored payment method or with a newly entered (encrypted) card number, without exposing raw PAN data.

interface CardNumberInfo {
    encryptedCardNumber: null | string;
    id: null | string;
    type: "STORED_PAYMENT_METHOD" | "ENCRYPTED_CARD_NUMBER";
}

Properties

encryptedCardNumber: null | string

Encrypted blob containing only the card number (PAN) when a new card is entered. Null for stored cards.

id: null | string

Identifier of the stored payment method when using a saved card. Null for newly entered cards.

type: "STORED_PAYMENT_METHOD" | "ENCRYPTED_CARD_NUMBER"

Source / representation type:

  • STORED_PAYMENT_METHOD – user picked an existing saved card. id is set and encryptedCardNumber is null.
  • ENCRYPTED_CARD_NUMBER – user entered a new card. encryptedCardNumber contains an encrypted payload and id is null.