diff --git a/bundled/minfraud.yaml b/bundled/minfraud.yaml index cb855af..a481f76 100644 --- a/bundled/minfraud.yaml +++ b/bundled/minfraud.yaml @@ -685,6 +685,14 @@ components: type: string maxLength: 255 description: The domain of the email address. Do not include the `@`. You do not need to send this field unless you send the email address as an MD5 hash. + verification_time: + type: string + format: date-time + pattern: ^\d{4}-\d{2}-\d{2}T([01]\d|2[0-3]):[0-5]\d:[0-5]\d(\.\d+)?(Z|[+-]([01]\d|2[0-3]):[0-5]\d)$ + description: The most recent date and time a verification of the email address was attempted, if known, in RFC 3339 date-time format. The time must not be before 1970-01-01T00:00:00Z or more than two days in the future. For a time outside this range, MaxMind ignores the input and returns a warning. + was_verification_successful: + type: boolean + description: Whether the most recent verification that the end user controls this email address was successful (e.g. by confirming a link sent to the email address). `true` if the email verification was successful, or `false` if the user failed email verification. Do not include this field if you have not performed this check. Event: type: object properties: @@ -1965,6 +1973,8 @@ components: email: address: 977577b140bfb7c516e4746204fbdb01 domain: maxmind.com + verification_time: '2026-10-01T14:25:00Z' + was_verification_successful: true event: party: customer shop_id: s2123 diff --git a/components/minfraud-request.yaml b/components/minfraud-request.yaml index b6c2ea7..15e201f 100644 --- a/components/minfraud-request.yaml +++ b/components/minfraud-request.yaml @@ -207,6 +207,24 @@ schemas: The domain of the email address. Do not include the `@`. You do not need to send this field unless you send the email address as an MD5 hash. + verification_time: + type: string + format: date-time + pattern: "^\\d{4}-\\d{2}-\\d{2}T([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(\\.\\d+)?(Z|[+-]([01]\\d|2[0-3]):[0-5]\\d)$" + description: >- + The most recent date and time a verification of the email address was + attempted, if known, in RFC 3339 date-time format. The time must not + be before 1970-01-01T00:00:00Z or more than two days in the future. + For a time outside this range, MaxMind ignores the input and returns a + warning. + was_verification_successful: + type: boolean + description: >- + Whether the most recent verification that the end user controls this + email address was successful (e.g. by confirming a link sent to the + email address). `true` if the email verification was successful, or + `false` if the user failed email verification. Do not include this + field if you have not performed this check. Address: type: object description: A billing or shipping address. diff --git a/examples/minfraud/request.yaml b/examples/minfraud/request.yaml index 6cde525..fb11506 100644 --- a/examples/minfraud/request.yaml +++ b/examples/minfraud/request.yaml @@ -43,6 +43,8 @@ value: email: address: 977577b140bfb7c516e4746204fbdb01 domain: maxmind.com + verification_time: "2026-10-01T14:25:00Z" + was_verification_successful: true event: party: customer shop_id: s2123