SMS Stubs

What is SMS Stubs Mode?

The SMS stubs mode allows customers to test their integration with greenID without having to send an SMS.

How does it work?

The web services that can be used to send an SMS will typically send 2 types of responses:

Submitted i.e. the SMS has been successfully accepted by the provider.
Failed i.e. the SMS has not been accepted by the provider.

The stubs numbers allow customers to receive one of the responses highlighted above while they are integrating with greenID.

Stubs Numbers

Numbers	Response
+111111111111	Submitted
+222222222222	Failed

Sample Response for +111111111111

<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
   <env:Header/>
   <env:Body>
      <ns2:registerVerificationAndSendHostedSMSInviteResponse xmlns:ns2="http://dynamicform.services.registrations.edentiti.com/">
         <return>
            <overallVerificationStatus>IN_PROGRESS</overallVerificationStatus>
            <responseErrorFlag>false</responseErrorFlag>
            <responseErrorMessage/>
            <verificationId>zrlXd8Pw</verificationId>
            <smsId>9ee9d6a2-ce12-4d42-91d6-335c64a01cb0</smsId>
            <smsStatus>Submitted</smsStatus>
         </return>
      </ns2:registerVerificationAndSendHostedSMSInviteResponse>
   </env:Body>
</env:Envelope>

Sample Response for +222222222222

<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
   <env:Header/>
   <env:Body>
      <ns2:registerVerificationAndSendHostedSMSInviteResponse xmlns:ns2="http://dynamicform.services.registrations.edentiti.com/">
         <return>
            <overallVerificationStatus>IN_PROGRESS</overallVerificationStatus>
            <responseErrorFlag>true</responseErrorFlag>
            <responseErrorMessage>An unexpected error occurred when attempting to send the SMS.</responseErrorMessage>
            <verificationId>QXFLekrq</verificationId>
            <smsId>9d4e12d5-e380-4ce0-a471-429f952f446e</smsId>
            <smsStatus>Error</smsStatus>
         </return>
      </ns2:registerVerificationAndSendHostedSMSInviteResponse>
   </env:Body>
</env:Envelope>

How can this be setup?

The stubs mode for this specific capability does not need to be 'setup'. If a customer send us either of the above numbers, greenID will recognise that these numbers are 'stubs numbers' and generate one of the 2 responses. Please note that these numbers do not work in the greenID Production environment - they are for testing / integration purposes only and will only work in a customer's test instance.