PaymentMethodCard

PaymentMethodCard

  • brand
    Type: string
    max length:  
    100
    required

    Card brand. Can be mastercard, visa or unknown.

  • exp_month
    Type: integer
    required

    Two-digit number representing the card's expiration month.

  • exp_year
    Type: integer
    required

    Four-digit number representing the card's expiration year.

  • funding
    Type: string
    max length:  
    100
    required

    Card funding type. Can be credit, debit, prepaid, or unknown.

  • last4
    Type: string
    max length:  
    100
    required

    The last four digits of the card.

  • cardholder_name
    Type: string | null
    max length:  
    100

    The cardholder name as read from the card, in ISO 7813 format. May include alphanumeric characters, special characters and first/last name separator (/). In some cases, the cardholder name may not be available depending on how the issuer has configured the card. Cardholder name is typically not available on with Apple Pay and Google Pay.

  • country
    Type: string | null
    max length:  
    100

    Two-letter ISO code representing the country of the card. You could use this attribute to get a sense of the international breakdown of cards you've collected.

  • display_brand
    Type: string | null
    max length:  
    100

    The brand to use when displaying the card, this accounts for customer's brand choice on dual-branded cards. Can be american_express, diners_club, discover, interac, jcb, mastercard, union_pay, visa, or other and may contain more values in the future.

  • fingerprint
    Type: string | null
    max length:  
    100

    Uniquely identifies this particular card number. You can use this attribute to check whether two customers who've signed up with you are using the same card number, for example. For payment methods that tokenize card information (Apple Pay, Google Pay), the tokenized number might be provided instead of the underlying card number.

  • iin
    Type: string
    max length:  
    100

    Issuer identification number of the card.

  • issuer
    Type: string | null
    max length:  
    100

    Issuing bank name.

  • segment
    Type: string
    max length:  
    100

    Card segment type. Can be commercial, consumer or unknown.

  • three_d_secure_usage
    Type: object · CardThreeDSecureUsage

    Contains details on how this Card may be used for 3D Secure authentication.

    • supported
      Type: boolean
      required

      Whether 3D Secure is supported on this card.

  • wallet
    Type: object · PaymentMethodCardWallet

    PaymentMethodCardWallet

    • type
      Type: stringenum
      required

      The type of the card wallet, one of apple_pay or google_pay.

      values
      • apple_pay
      • google_pay
    • dynamic_last4
      Type: string | null
      max length:  
      100

      (For tokenized numbers only.) The last four digits of the device account number.