Merge pull request #7 from illiminable/master

Merge mobile support

Author: illiminable

src/TeleSign.Services.Verify/RawVerifyService.cs

@@ -120,6 +120,33 @@ public string CallRaw(
                         language);
         }
 
+        /// <summary>
+        /// Initiates a PhoneId Push Mobile transaction returning the raw JSON response from
+        /// the REST API.
+        /// </summary>
+        /// <param name="phoneNumber">The phone number to call.</param>
+        /// <param name="verifyCode">
+        /// The code to send to the user. When null a code will
+        /// be generated for you.
+        /// </param>
+        /// <param name="language">
+        /// The language that the message should be in. This parameter is ignored if
+        /// you supplied a message template.
+        /// </param>
+        /// <returns>The raw JSON response from the REST API.</returns>
+        public string PushRaw(
+                    string phoneNumber,
+                    string verifyCode = null)
+        {
+            phoneNumber = this.CleanupPhoneNumber(phoneNumber);
+
+            return this.InternalVerify(
+                        VerificationMethod.Push,
+                        phoneNumber,
+                        verifyCode,
+                        "TS2FA");
+        }
+
         /// <summary>
         /// Checks the status of a Verify transaction. When the code is
         /// supplied it verifies this code. The response also contains 
@@ -242,10 +269,21 @@ private static Dictionary<string, string> ConstructVerifyArgs(
 
             Dictionary<string, string> args = new Dictionary<string, string>();
             args.Add("phone_number", phoneNumber);
-            args.Add("verify_code", verifyCode.ToString());
+
+            if (verificationMethod == VerificationMethod.Push)
+            {
+                if (!string.IsNullOrEmpty(verifyCode))
+                {
+                    args.Add("notification_value", verifyCode.ToString());
+                }
+            }
+            else
+            {
+                args.Add("verify_code", verifyCode.ToString());
+            }
             args.Add("language", language);
 
-            if (verificationMethod == VerificationMethod.Sms)
+            if (verificationMethod == VerificationMethod.Sms || verificationMethod == VerificationMethod.Push)
             {
                 args.Add("template", messageTemplate);
             }

src/TeleSign.Services.Verify/VerifyService.cs

@@ -211,6 +211,44 @@ public VerifyResponse InitiateCall(
             }
         }
 
+        /// <summary>
+        /// Initiates a TeleSign Verify transaction via a voice call.
+        /// </summary>
+        /// <param name="phoneNumber">The phone number to call.</param>
+        /// <param name="verifyCode">
+        /// The code to send to the user. When null a code will
+        /// be generated for you.
+        /// </param>
+        /// <param name="language">
+        /// The language that the message should be in. This parameter is ignored if
+        /// you supplied a message template.
+        /// TODO: Details about language string format.
+        /// </param>
+        /// <returns>
+        /// A VerifyResponse object with the status and returned information
+        /// for the transaction.
+        /// </returns>
+        public VerifyResponse InitiatePush(
+                    string phoneNumber,
+                    string verifyCode = null)
+        {
+            string rawResponse = this.PushRaw(
+                        phoneNumber,
+                        verifyCode);
+
+            try
+            {
+                return this.parser.ParseVerifyResponse(rawResponse);
+            }
+            catch (Exception x)
+            {
+                throw new ResponseParseException(
+                            "Error parsing Verify call response",
+                            rawResponse,
+                            x);
+            }
+        }
+
         /// <summary>
         /// Validates the code provided by the user. After the code has been
         /// sent to the user, they enter the code to your website/application

src/TeleSign.Services/VerificationMethod.cs

@@ -28,5 +28,10 @@ public enum VerificationMethod
         /// Verify by sms.
         /// </summary>
         Sms,
+
+        /// <summary>
+        /// Verify by mobile push.
+        /// </summary>
+        Push,
     }
 }