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

C#
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
 
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

URL: https://ui.solutionsbytext.com/SBT.App.SetUp/RSServices/MessageRSService.svc/ConfirmVBTWithTransactionTicket

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"
    }
}

 

 Send Feedback