Overview
This method is used to verify the pin for a phone number with generating the transaction ticket. This method is used when VBT type is set to PIN.
Syntax
C#
[OperationContractAttribute()] SBT.API.DataContracts.Admin.WSVerificationResponse ConfirmVBTWithTransactionTicket( string securityToken, string orgCode, string phone, string pin )
WSDL
Production: https://ui.solutionsbytext.com/Sbt.App.SetUp/WSServices/MessageWSService.svc?singlewsdl
Staging: https://test.solutionsbytext.com/Sbt.App.SetUp/WSServices/MessageWSService.svc?singlewsdl
Parameters
securityToken
– String[1000] (Required) – SecurityToken to authenticate the user
orgCode
– String[20] (Required) – Default Organization Code where VBT is initiated
phone
– String[20] (Required) – Phone number with/without country code that the pin was sent to.
pin
– String[10] (Required) – Generated pin.
Return Value
WSVerificationResponse
NAME | TYPE | DESCRIPTION |
---|---|---|
Result |
Bool |
True/False whether the call was successful or not. |
ErrorCode |
Int |
For Success/Failure it will return error number. |
Message |
String |
Message related to the error code |
Verified |
Bool |
Verification pin status. |
TransactionTicket
|
String | Generated Transaction Ticket |
Examples
MessageClient messageResult = new MessageClient("MessageWSServiceHttpEndpoint"); string securityToken = txtToken.Text; string orgCode = txtOrgCode.Text; string phoneNo = txtMobileNo.Text; ; string pin = txtPin.Text; WSVerificationResponse wSVerificationResponse = messageResult.ConfirmVBTWithTransactionTicket(securityToken, orgCode, phoneNo, pin); if (!wSVerificationResponse.Result) { //handle error lblError.Text = wSVerificationResponse.Message; } else { //handle success lblError.Text = wSVerificationResponse.Message; }
Soap Request <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://SBTService/ServiceContracts/"> <soapenv:Header/> <soapenv:Body> <ser:ConfirmVBTWithTransactionTicket> <!--Required:--> <ser:securityToken>Security Token</ser:securityToken> <!--Required:--> <ser:orgCode>Org Code</ser:orgCode> <!--Required:--> <ser:phone>Phone Number</ser:phone> <!--Required:--> <ser:pin>Pin</ser:pin> </ser:ConfirmVBTWithTransactionTicket> </soapenv:Body> </soapenv:Envelope> Soap Response <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body> <ConfirmVBTWithTransactionTicketResponse xmlns="http://SBTService/ServiceContracts/"> <ConfirmVBTWithTransactionTicketResult xmlns:a="http://SBTAPIService/DataContract/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <a:Result>true</a:Result> <a:ErrorCode>1026</a:ErrorCode> <a:Message>Pin verified successfully</a:Message> <a:Verified>true</a:Verified> <a:TransactionTicket>Transaction Ticket</a:TransactionTicket> </ConfirmVBTWithTransactionTicketResult> </ConfirmVBTWithTransactionTicketResponse> </s:Body> </s:Envelope>
JAVA
MessageWSService srv = new MessageWSService(); IMessage iMessage = srv.getMessageWSServiceHttpEndpoint1(); WSVerificationResponse res = null; String securityToken = "securityToken"; String orgCode = "Org Code"; String phone = "Phone Number"; String pin = "Pin"; try { res = iMessage.ConfirmVBTWithTransactionTicket(securityToken, orgCode, phone, pin); } catch (Throwable e) { e.printStackTrace(); } if(res == null ){ System.out.println("Erron::"); return; } if (res.isResult() == null || !res.isResult()) { //handle error System.out.println("ErrorCode::"+res.getErrorCode()); System.out.println("ErrorMessage::"+res.getMessage().getValue()); } else { //handle successM System.out.println("ID::"+res.getId()); System.out.println("Message::"+res.getMessage().getValue()); }
PHP
<?php $client = new SoapClient("https://ui.solutionsbytext.com/Sbt.App.SetUp/wsservices/MessageWSService.svc?wsdl"); $param = array( 'securityToken' => 'securityToken', 'orgCode' => 'orgCode', 'phone' => '12345678999', 'pin' => 'PIN', ); $response = $client->__soapCall('ConfirmVBTWithTransactionTicket', array($param)); echo '<pre/>'; print_r($response); if($response->ConfirmVBTWithTransactionTicketResult->Result){ echo 'Message: '.$response->ConfirmVBTWithTransactionTicketResult->Message; } else { echo 'Message: '.$response->ConfirmVBTWithTransactionTicketResult->Message; } ?>
REST
Method: POST
JSON Request:
{ "securityToken": "Security Token", "orgCode": "Org Code", "phone": "Phone Number", "pin": "Pin" }
JSON Response:
{ "ConfirmVBTWithTransactionTicketResult": { "Result": true, "ErrorCode": 1026, "Message": "Pin verified successfully", "Verified": true, "TransactionTicket": "Transaction Ticket" } }