Package io.moov.sdk.models.components

Class Card

  • public class Card
extends java.lang.Object
    Card

    Describes a card on a Moov account.

    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description
      static class  Card.Builder  

    • Constructor Summary

      Constructors 
      Constructor Description
      Card​(java.lang.String cardID, java.lang.String fingerprint, CardBrand brand, CardType cardType, java.lang.String lastFourCardNumber, java.lang.String bin, CardExpiration expiration, CardAddress billingAddress, CardVerification cardVerification)  
      Card​(java.lang.String cardID, java.lang.String fingerprint, CardBrand brand, CardType cardType, java.util.Optional<java.lang.String> cardCategory, java.lang.String lastFourCardNumber, java.lang.String bin, CardExpiration expiration, java.util.Optional<java.lang.String> holderName, CardAddress billingAddress, CardVerification cardVerification, java.util.Optional<java.lang.String> issuer, java.util.Optional<java.lang.String> issuerCountry, java.util.Optional<java.lang.String> issuerURL, java.util.Optional<java.lang.String> issuerPhone, java.util.Optional<java.lang.Boolean> commercial, java.util.Optional<java.lang.Boolean> regulated, java.util.Optional<java.lang.Boolean> cardOnFile, java.util.Optional<java.lang.String> merchantAccountID, java.util.Optional<? extends CardAccountUpdater> cardAccountUpdater, java.util.Optional<? extends DomesticPushToCard> domesticPushToCard, java.util.Optional<? extends DomesticPullFromCard> domesticPullFromCard, java.util.Optional<? extends java.util.List<BasicPaymentMethod>> paymentMethods)  

    • Constructor Detail

      • Card

        public Card​(java.lang.String cardID,
            java.lang.String fingerprint,
            CardBrand brand,
            CardType cardType,
            java.util.Optional<java.lang.String> cardCategory,
            java.lang.String lastFourCardNumber,
            java.lang.String bin,
            CardExpiration expiration,
            java.util.Optional<java.lang.String> holderName,
            CardAddress billingAddress,
            CardVerification cardVerification,
            java.util.Optional<java.lang.String> issuer,
            java.util.Optional<java.lang.String> issuerCountry,
            java.util.Optional<java.lang.String> issuerURL,
            java.util.Optional<java.lang.String> issuerPhone,
            java.util.Optional<java.lang.Boolean> commercial,
            java.util.Optional<java.lang.Boolean> regulated,
            java.util.Optional<java.lang.Boolean> cardOnFile,
            java.util.Optional<java.lang.String> merchantAccountID,
            java.util.Optional<? extends CardAccountUpdater> cardAccountUpdater,
            java.util.Optional<? extends DomesticPushToCard> domesticPushToCard,
            java.util.Optional<? extends DomesticPullFromCard> domesticPullFromCard,
            java.util.Optional<? extends java.util.List<BasicPaymentMethod>> paymentMethods)

    • Method Detail

      • cardID

        public java.lang.String cardID()
        ID of the card.

      • fingerprint

        public java.lang.String fingerprint()
        Uniquely identifies a linked payment card or token. For Apple Pay, the fingerprint is based on the tokenized card number and may vary based on the user's device. This field can be used to identify specific payment methods across multiple accounts on your platform.

      • brand

        public CardBrand brand()
        The card brand.

      • cardType

        public CardType cardType()
        The type of the card.

      • cardCategory

        public java.util.Optional<java.lang.String> cardCategory()
        The category or level of the card defined by the issuer. Examples include, but not limited to, "REWARDS", "TRADITIONAL REWARDS", "CLASSIC", and "CORPORATE PURCHASING".

      • lastFourCardNumber

        public java.lang.String lastFourCardNumber()
        Last four digits of the card number

      • bin

        public java.lang.String bin()
        The first six to eight digits of the card number, which identifies the financial institution that issued the card.

      • expiration

        public CardExpiration expiration()
        The expiration date of the card or token.

      • holderName

        public java.util.Optional<java.lang.String> holderName()
        The name of the cardholder as it appears on the card.

      • cardVerification

        public CardVerification cardVerification()
        The results of submitting cardholder data to a card network for verification.

      • issuer

        public java.util.Optional<java.lang.String> issuer()
        Financial institution that issued the card.

      • issuerCountry

        public java.util.Optional<java.lang.String> issuerCountry()
        Country where the card was issued.

      • issuerURL

        public java.util.Optional<java.lang.String> issuerURL()
        URL of the issuer.

      • issuerPhone

        public java.util.Optional<java.lang.String> issuerPhone()
        Phone number of the issuer.

      • commercial

        public java.util.Optional<java.lang.Boolean> commercial()
        If true, the card is for commercial use, or associated with a business. If false, the card is associated with a general consumer.

      • regulated

        public java.util.Optional<java.lang.Boolean> regulated()
        If true, the card issuing bank is regulated, and the scheme fees for debit transactions will be limited based on the Durbin Amendment. If false, the card issuing bank is not regulated, and the scheme fees will not be limited.

      • cardOnFile

        public java.util.Optional<java.lang.Boolean> cardOnFile()
        Indicates cardholder has authorized card to be stored for future payments.

      • merchantAccountID

        public java.util.Optional<java.lang.String> merchantAccountID()

      • cardAccountUpdater

        public java.util.Optional<CardAccountUpdater> cardAccountUpdater()
        The results of the most recent card update request.

      • domesticPushToCard

        public java.util.Optional<DomesticPushToCard> domesticPushToCard()
        Indicates which level of domestic push-to-card transfer is supported by the card, if any.

      • domesticPullFromCard

        public java.util.Optional<DomesticPullFromCard> domesticPullFromCard()
        Indicates if the card supports domestic pull-from-card transfer.

      • paymentMethods

        public java.util.Optional<java.util.List<BasicPaymentMethod>> paymentMethods()
        Includes any payment methods created as a result of linking a card with the `x-wait-for` header set to `payment-method`.

        Only returned by the link card endpoint; not included when getting or listing cards.

      • withCardID

        public Card withCardID​(java.lang.String cardID)
        ID of the card.

      • withFingerprint

        public Card withFingerprint​(java.lang.String fingerprint)
        Uniquely identifies a linked payment card or token. For Apple Pay, the fingerprint is based on the tokenized card number and may vary based on the user's device. This field can be used to identify specific payment methods across multiple accounts on your platform.

      • withBrand

        public Card withBrand​(CardBrand brand)
        The card brand.

      • withCardType

        public Card withCardType​(CardType cardType)
        The type of the card.

      • withCardCategory

        public Card withCardCategory​(java.lang.String cardCategory)
        The category or level of the card defined by the issuer. Examples include, but not limited to, "REWARDS", "TRADITIONAL REWARDS", "CLASSIC", and "CORPORATE PURCHASING".

      • withCardCategory

        public Card withCardCategory​(java.util.Optional<java.lang.String> cardCategory)
        The category or level of the card defined by the issuer. Examples include, but not limited to, "REWARDS", "TRADITIONAL REWARDS", "CLASSIC", and "CORPORATE PURCHASING".

      • withLastFourCardNumber

        public Card withLastFourCardNumber​(java.lang.String lastFourCardNumber)
        Last four digits of the card number

      • withBin

        public Card withBin​(java.lang.String bin)
        The first six to eight digits of the card number, which identifies the financial institution that issued the card.

      • withExpiration

        public Card withExpiration​(CardExpiration expiration)
        The expiration date of the card or token.

      • withHolderName

        public Card withHolderName​(java.lang.String holderName)
        The name of the cardholder as it appears on the card.

      • withHolderName

        public Card withHolderName​(java.util.Optional<java.lang.String> holderName)
        The name of the cardholder as it appears on the card.

      • withBillingAddress

        public Card withBillingAddress​(CardAddress billingAddress)

      • withCardVerification

        public Card withCardVerification​(CardVerification cardVerification)
        The results of submitting cardholder data to a card network for verification.

      • withIssuer

        public Card withIssuer​(java.lang.String issuer)
        Financial institution that issued the card.

      • withIssuer

        public Card withIssuer​(java.util.Optional<java.lang.String> issuer)
        Financial institution that issued the card.

      • withIssuerCountry

        public Card withIssuerCountry​(java.lang.String issuerCountry)
        Country where the card was issued.

      • withIssuerCountry

        public Card withIssuerCountry​(java.util.Optional<java.lang.String> issuerCountry)
        Country where the card was issued.

      • withIssuerURL

        public Card withIssuerURL​(java.lang.String issuerURL)
        URL of the issuer.

      • withIssuerURL

        public Card withIssuerURL​(java.util.Optional<java.lang.String> issuerURL)
        URL of the issuer.

      • withIssuerPhone

        public Card withIssuerPhone​(java.lang.String issuerPhone)
        Phone number of the issuer.

      • withIssuerPhone

        public Card withIssuerPhone​(java.util.Optional<java.lang.String> issuerPhone)
        Phone number of the issuer.

      • withCommercial

        public Card withCommercial​(boolean commercial)
        If true, the card is for commercial use, or associated with a business. If false, the card is associated with a general consumer.

      • withCommercial

        public Card withCommercial​(java.util.Optional<java.lang.Boolean> commercial)
        If true, the card is for commercial use, or associated with a business. If false, the card is associated with a general consumer.

      • withRegulated

        public Card withRegulated​(boolean regulated)
        If true, the card issuing bank is regulated, and the scheme fees for debit transactions will be limited based on the Durbin Amendment. If false, the card issuing bank is not regulated, and the scheme fees will not be limited.

      • withRegulated

        public Card withRegulated​(java.util.Optional<java.lang.Boolean> regulated)
        If true, the card issuing bank is regulated, and the scheme fees for debit transactions will be limited based on the Durbin Amendment. If false, the card issuing bank is not regulated, and the scheme fees will not be limited.

      • withCardOnFile

        public Card withCardOnFile​(boolean cardOnFile)
        Indicates cardholder has authorized card to be stored for future payments.

      • withCardOnFile

        public Card withCardOnFile​(java.util.Optional<java.lang.Boolean> cardOnFile)
        Indicates cardholder has authorized card to be stored for future payments.

      • withMerchantAccountID

        public Card withMerchantAccountID​(java.lang.String merchantAccountID)

      • withMerchantAccountID

        public Card withMerchantAccountID​(java.util.Optional<java.lang.String> merchantAccountID)

      • withCardAccountUpdater

        public Card withCardAccountUpdater​(CardAccountUpdater cardAccountUpdater)
        The results of the most recent card update request.

      • withCardAccountUpdater

        public Card withCardAccountUpdater​(java.util.Optional<? extends CardAccountUpdater> cardAccountUpdater)
        The results of the most recent card update request.

      • withDomesticPushToCard

        public Card withDomesticPushToCard​(DomesticPushToCard domesticPushToCard)
        Indicates which level of domestic push-to-card transfer is supported by the card, if any.

      • withDomesticPushToCard

        public Card withDomesticPushToCard​(java.util.Optional<? extends DomesticPushToCard> domesticPushToCard)
        Indicates which level of domestic push-to-card transfer is supported by the card, if any.

      • withDomesticPullFromCard

        public Card withDomesticPullFromCard​(DomesticPullFromCard domesticPullFromCard)
        Indicates if the card supports domestic pull-from-card transfer.

      • withDomesticPullFromCard

        public Card withDomesticPullFromCard​(java.util.Optional<? extends DomesticPullFromCard> domesticPullFromCard)
        Indicates if the card supports domestic pull-from-card transfer.

      • withPaymentMethods

        public Card withPaymentMethods​(java.util.List<BasicPaymentMethod> paymentMethods)
        Includes any payment methods created as a result of linking a card with the `x-wait-for` header set to `payment-method`.

        Only returned by the link card endpoint; not included when getting or listing cards.

      • withPaymentMethods

        public Card withPaymentMethods​(java.util.Optional<? extends java.util.List<BasicPaymentMethod>> paymentMethods)
        Includes any payment methods created as a result of linking a card with the `x-wait-for` header set to `payment-method`.

        Only returned by the link card endpoint; not included when getting or listing cards.

      • equals

        public boolean equals​(java.lang.Object o)
        Overrides:
        equals in class java.lang.Object

      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class java.lang.Object

      • toString

        public java.lang.String toString()
        Overrides:
        toString in class java.lang.Object