CardKYCFields

Payment card information for KYC verification.

Contains credit or debit card details for payment processing. All field keys are automatically prefixed with "card." when serialized.

Supports:

• Full card details (number, expiration, CVC)

• Tokenized card references (for PCI DSS compliance)

• Billing address information

• Card network identification

Security considerations:

• Use tokenized cards when possible to avoid handling sensitive card data

• Never log or store full card numbers in application logs

• Follow PCI DSS compliance requirements when handling card data

• Consider encryption for card data in transit and at rest

Example - Full card details:

val card = CardKYCFields(
    number = "4111111111111111",
    expirationDate = "29-11", // YY-MM format (November 2029)
    cvc = "123",
    holderName = "John Doe",
    network = "Visa",
    postalCode = "12345",
    countryCode = "US"
)

// Extract fields for submission (automatically adds "card." prefix)
val fields = card.fields()
// Result: {"card.number": "4111...", "card.expiration_date": "29-11", ...}

Example - Tokenized card:

val card = CardKYCFields(
    token = "tok_visa_1234",
    holderName = "John Doe",
    countryCode = "US"
)

See also:

• NaturalPersonKYCFields for individual customer fields

• FinancialAccountKYCFields for bank account information

• SEP-0009 Specification