Add email verification inputs to minFraud

bundled/minfraud.yaml

@@ -558,6 +558,31 @@ components:
           type: string
           pattern: ^[0-9A-Z]{1,4}$
           description: The ISO 3166-2 subdivision code.
+    Billing:
+      description: A billing address, with phone verification details.
+      allOf:
+        - $ref: '#/components/schemas/Address'
+        - type: object
+          properties:
+            phone_verification_method:
+              type: string
+              enum:
+                - delivered_code
+                - network
+                - other
+              description: |-
+                The most recent method used to verify the billing phone number.
+
+                - `delivered_code`: a code delivered to the phone, such as by SMS, voice call, or messaging app.
+                - `network`: verification through the mobile network operator, such as silent network authentication.
+                - `other`: another verification method.
+            phone_verification_time:
+              type: string
+              format: date-time
+              description: The date and time of the most recent verification of the billing phone number, in RFC 3339 date-time format.
+            phone_was_verification_successful:
+              type: boolean
+              description: Whether the most recent verification of the billing phone number succeeded. Omit this field if no verification was attempted.
     CreditCard:
       type: object
       properties:
@@ -654,6 +679,13 @@ 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
+          description: The date and time of the most recent verification of the email address, in RFC 3339 date-time format.
+        was_verification_successful:
+          type: boolean
+          description: Whether the most recent verification of the email address succeeded. Omit this field if no verification was attempted.
     Event:
       type: object
       properties:
@@ -999,7 +1031,7 @@ components:
           $ref: '#/components/schemas/Account'
           description: Information about the account involved in the event.
         billing:
-          $ref: '#/components/schemas/Address'
+          $ref: '#/components/schemas/Billing'
           description: The billing address for the order.
         credit_card:
           $ref: '#/components/schemas/CreditCard'
@@ -1901,6 +1933,9 @@ components:
           last_name: Doe
           phone_country_code: '1'
           phone_number: 203-000-0000
+          phone_verification_method: delivered_code
+          phone_verification_time: '2026-10-01T14:30:00Z'
+          phone_was_verification_successful: true
           postal: '06511'
           region: CT
         credit_card:
@@ -1926,6 +1961,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

components/minfraud-request.yaml

@@ -26,7 +26,7 @@ schemas:
         $ref: "#/schemas/Account"
         description: Information about the account involved in the event.
       billing:
-        $ref: "#/schemas/Address"
+        $ref: "#/schemas/Billing"
         description: The billing address for the order.
       credit_card:
         $ref: "#/schemas/CreditCard"
@@ -206,6 +206,17 @@ 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
+        description: >-
+          The date and time of the most recent verification of the email
+          address, in RFC 3339 date-time format.
+      was_verification_successful:
+        type: boolean
+        description: >-
+          Whether the most recent verification of the email address succeeded.
+          Omit this field if no verification was attempted.
   Address:
     type: object
     description: A billing or shipping address.
@@ -254,6 +265,40 @@ schemas:
         type: string
         pattern: "^[0-9A-Z]{1,4}$"
         description: The ISO 3166-2 subdivision code.
+  Billing:
+    description: A billing address, with phone verification details.
+    allOf:
+      - $ref: "#/schemas/Address"
+      - type: object
+        properties:
+          phone_verification_method:
+            type: string
+            enum:
+              - delivered_code
+              - network
+              - other
+            description: >-
+              The most recent method used to verify the billing phone number.
+
+
+              - `delivered_code`: a code delivered to the phone, such as by SMS,
+              voice call, or messaging app.
+
+              - `network`: verification through the mobile network operator,
+              such as silent network authentication.
+
+              - `other`: another verification method.
+          phone_verification_time:
+            type: string
+            format: date-time
+            description: >-
+              The date and time of the most recent verification of the billing
+              phone number, in RFC 3339 date-time format.
+          phone_was_verification_successful:
+            type: boolean
+            description: >-
+              Whether the most recent verification of the billing phone number
+              succeeded. Omit this field if no verification was attempted.
   Shipping:
     description: A shipping address, with the delivery speed for the order.
     allOf:

examples/minfraud/request.yaml

@@ -13,6 +13,9 @@ value:
     last_name: Doe
     phone_country_code: "1"
     phone_number: 203-000-0000
+    phone_verification_method: delivered_code
+    phone_verification_time: "2026-10-01T14:30:00Z"
+    phone_was_verification_successful: true
     postal: "06511"
     region: CT
   credit_card:
@@ -40,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