OnlineAPI Web Service

OnlineAPI

Click here for a complete list of operations.

Payment_TokenizedVerifyResponse_Adyen

This method will verify the integrity of the information being returned, as a result of a payment request/result of Adyen Hosted Payment Pages. If OnlineAPI:Payment_TokenizedRequest method is used to generate the redirection parameter needed to connect to Adyen Hosted Payment Pages, a payment result from Adyen is received. This method is used to verify these Payment Result parameters when the shopper returns to their original site. Freedom will use the HMAC algorithm along with the HMAC secret key to calculate the correct signature of the input parameters and will compare the result with MerchantSig input parameter. If those values match, this method will return a success response. If a mismatch is detected in these values, this method will return a HMAC_VALIDATION_FAILED message. If the TokenizedPaymentAccontID input parameter is NOT set, this method will use the entered online order # for assigning the correct tokenized payment account based on the Online Order Territory.

Test

The test form is only available for requests from the local machine.

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /adapturedemo/webservice/OnlineAPI.asmx HTTP/1.1
Host: api.securefreedom.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://www.securefreedom.com/Payment_TokenizedVerifyResponse_Adyen"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <Payment_TokenizedVerifyResponse_Adyen xmlns="http://www.securefreedom.com/">
      <Credentials>
        <Username>string</Username>
        <Password>string</Password>
        <Token>string</Token>
      </Credentials>
      <OnlineOrderID>int</OnlineOrderID>
      <PaymentResultInfo>
        <MerchantReference>string</MerchantReference>
        <SkinCode>string</SkinCode>
        <ShopperLocale>string</ShopperLocale>
        <PaymentMethod>string</PaymentMethod>
        <AuthResult>string</AuthResult>
        <PspReference>string</PspReference>
        <MerchantReturnData>string</MerchantReturnData>
        <MerchantSig>string</MerchantSig>
      </PaymentResultInfo>
      <TokenizedPaymentAccountID>int</TokenizedPaymentAccountID>
    </Payment_TokenizedVerifyResponse_Adyen>
  </soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <Payment_TokenizedVerifyResponse_AdyenResponse xmlns="http://www.securefreedom.com/">
      <Payment_TokenizedVerifyResponse_AdyenResult>
        <RequestID>int</RequestID>
        <Success>int</Success>
        <Message>string</Message>
      </Payment_TokenizedVerifyResponse_AdyenResult>
    </Payment_TokenizedVerifyResponse_AdyenResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /adapturedemo/webservice/OnlineAPI.asmx HTTP/1.1
Host: api.securefreedom.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <Payment_TokenizedVerifyResponse_Adyen xmlns="http://www.securefreedom.com/">
      <Credentials>
        <Username>string</Username>
        <Password>string</Password>
        <Token>string</Token>
      </Credentials>
      <OnlineOrderID>int</OnlineOrderID>
      <PaymentResultInfo>
        <MerchantReference>string</MerchantReference>
        <SkinCode>string</SkinCode>
        <ShopperLocale>string</ShopperLocale>
        <PaymentMethod>string</PaymentMethod>
        <AuthResult>string</AuthResult>
        <PspReference>string</PspReference>
        <MerchantReturnData>string</MerchantReturnData>
        <MerchantSig>string</MerchantSig>
      </PaymentResultInfo>
      <TokenizedPaymentAccountID>int</TokenizedPaymentAccountID>
    </Payment_TokenizedVerifyResponse_Adyen>
  </soap12:Body>
</soap12:Envelope>

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <Payment_TokenizedVerifyResponse_AdyenResponse xmlns="http://www.securefreedom.com/">
      <Payment_TokenizedVerifyResponse_AdyenResult>
        <RequestID>int</RequestID>
        <Success>int</Success>
        <Message>string</Message>
      </Payment_TokenizedVerifyResponse_AdyenResult>
    </Payment_TokenizedVerifyResponse_AdyenResponse>
  </soap12:Body>
</soap12:Envelope>