Skip to content


class Athena::Validator::Constraints::Luhn
inherits Athena::Validator::Constraint

Validates that a credit card number passes the Luhn algorithm; a useful first step to validating a credit card. The underlying value is converted to a string via #to_s before being validated.

NOTE: As with most other constraints, nil and empty strings are considered valid values, in order to allow the value to be optional. If the value is required, consider combining this constraint with AVD::Constraints::NotBlank.


Optional Arguments

Type: String Default: This value is not a valid credit card number.

The message that will be shown if the value is not pass the Luhn check.


The following placeholders can be used in this message:

  • {{ value }} - The current (invalid) value.

Type: Array(String) | String | Nil Default: nil

The validation groups this constraint belongs to. AVD::Constraint::DEFAULT_GROUP is assumed if nil.


Type: Hash(String, String)? Default: nil

Any arbitrary domain-specific data that should be stored with this constraint. The payload is not used by Athena::Validator, but its processing is completely up to you.


CHECKSUM_FAILED_ERROR = "a4f089dd-fd63-4d50-ac30-34ed2a8dc9dd"

INVALID_CHARACTERS_ERROR = "c42b8d36-d9e9-4f5f-aad6-5190e27a1102"

Class methods

.new(message : String = "This value is not a valid credit card number.", groups : Array(String) | String | Nil = nil, payload : Hash(String, String)? = nil)


#validated_by : AVD::ConstraintValidator.class

Returns the AVD::ConstraintValidator.class that should handle validating self.