Qualification Flow (Subscription)

To subscribe to a vehicle the user must first qualify. The qualification process includes submitting their driver’s license information to run a credit check and then their motor vehicle record (MVR).

1. Check customer qualification status.

   Customer qualification status query

   query CustomerQualificationStatus {
     customerQualificationStatus {
       mvrStatus
       creditStatus
       creditStatusLease
     }
   }
   
   enum QualifyCreditStatus {
     PASS
     FAIL
     PENDING
     ERROR
   }

2. Show eligibility requirements.

   

3. Collect driver’s license information.

   
   Drivers’ licenses use a pdf417 barcode and can be scanned using a compatible library.
   

4. Show disclosures

   

5. Confirm to the user that they are going to run a credit check and MVR.

   

6. Run credit check.

   Qualify Customer Credit mutation

   mutation QualifyCustomerCredit($input: QualifyCustomerCreditInput!) {
     qualifyCustomerCredit(input: $input) {
       status
       statusLease
       error {
         message
         code
       }
       steps {
         type
         status
         error {
           message
           code
         }
       }
     }
   }
   
   enum QualificationType {
     LEASE
     SUBSCRIPTION
   }
   
   input QualifyCustomerCreditInput {
     type: QualificationType!
     ssnLastFour: String # Required only if initial credit check cannot find consumer
   }
   
   enum QualifyCreditErrorCode {
     FROZEN
     NOT_FOUND
     NOT_FOUND_SEND_SSN
     THIN_FILE
     UNKNOWN
   }

   Qualify Customer Credit error response

   {
     "data": {
       "qualifyCustomerCredit": {
         "status": "PENDING",
         "statusLease": null,
         "error": {
           "message": "Credit report not found, send SSN",
           "code": "NOT_FOUND_SEND_SSN",
           "__typename": "QualifyCreditError"
         },
         "steps": [
           {
             "type": "CREDIT_RETRIEVE",
             "status": "ERROR",
             "error": null,
             "__typename": "QualifyStep"
           },
           {
             "type": "CREDIT_VERIFY_SCORE",
             "status": "PENDING",
             "error": null,
             "__typename": "QualifyStep"
           }
         ],
         "__typename": "QualifyCustomerCreditResult"
       }
     }
   }

   

7. Run MVR.

   Qualify Customer MVR mutation

   mutation QualifyCustomerMvr($input: QualifyCustomerMvrInput!) {
     qualifyCustomerMvr(input: $input) {
       status
       error {
         code
         message
       }
       steps {
         type
         status
         error {
           message
           code
         }
       }
     }
   }
   
   enum QualificationType {
     LEASE
     SUBSCRIPTION
   }
   
   input QualifyCustomerMvrInput {
     type: QualificationType!
   }