Service Web Service

Service

Click here for a complete list of operations.

smpPerform3DTransaction

Initialize a 3D Secure Payment
uid - Your Adelante user name
pwd - Your Adelante password
accountid - Your Adelante Account ID
profileid
ordernumber - Merchant order reference
cardnumber - Card number or card token prefixed by 'TOK:'
expirydate - Card expiry date - MM/YY
issuenumber
startdate
cvvcode - Card CVV code
avsaddr1 - Deprecated
avspostcode - Deprecated
amount - Payment amount (including surcharge) IN PENNIES/ CENTS
surcharge - Surcharge amount IN PENNIES/ CENTS.
partialcardnumber
transactionflag - Internal Use Only
customerreference - Merchant customer reference number
fundcode - Merchant fund code
key - Merchant transaction key
gratuity - Gratuity amount IN PENNIES/ CENTS
accountnumber - Primary Ricpient Account No
surname - Primary Recipient Surname
dob - Primary Recipient DoB (YYYYMMDD)
cardholdername - CardHolder Name
billingfirstnames - Billing first names
billingsurname - Billing first names
billingaddressline1 - Billing Address line1
billingaddressline2 - Billing Address line2
billingcity - Billing Address City
billingstate - US State 2 digit code (Required if Country is US)
billingcountry - ISO3166 Country Code eg. GB, US, IE, DEbillingpostcode - Billing Address Postcode or ZIP
billingemail - Billing Email Address
billingtelephone - Billing Telephone Number
savecard - Save a token for future payments
ClientIPAddress - Save a token for future payments
BrowserAcceptHeader - HTTP accept headers as sent to you from the Cardholder’s browser including the exact content of the Accept field. An example value is: text/html,application/xhtml+xml,application/xml;q=0.9, */*;q=0.8
BrowserLanguage - Representing the browser language as defined in IETF BCP47. Returned from navigator.language property.
BrowserUserAgent - Exact content of the HTTP user-agent header.
BrowserJavascriptEnabled - Boolean that represents the ability of the cardholder browser to execute Java
RETURNS - XML Data

Test

To test the operation using the HTTP POST protocol, click the 'Invoke' button.

Parameter	Value
uid:
pwd:
accountid:
profileid:
ordernumber:
cardnumber:
expirydate:
issuenumber:
startdate:
cvvcode:
avsaddr1:
avspostcode:
amount:
surcharge:
partialcardnumber:
transactionflag:
customerreference:
fundcode:
key:
gratuity:
accountnumber:
surname:
dob:
cardholdername:
billingfirstnames:
billingsurname:
billingaddress1:
billingaddress2:
billingcity:
billingcounty:
billingcountry:
billingpostcode:
billingemail:
billingtelephone:
savecard:
ClientIPAddress:
BrowserJavascriptEnabled:
BrowserAcceptHeader:
BrowserLanguage:
BrowserUserAgent:

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 /Services/SmartPos2/Service.asmx HTTP/1.1
Host: connectpayadmin.test.app.adelante.co.uk
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://adelante-software.com/smpPerform3DTransaction"

<?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>
    <smpPerform3DTransaction xmlns="http://adelante-software.com/">
      <uid>string</uid>
      <pwd>string</pwd>
      <accountid>string</accountid>
      <profileid>string</profileid>
      <ordernumber>string</ordernumber>
      <cardnumber>string</cardnumber>
      <expirydate>string</expirydate>
      <issuenumber>string</issuenumber>
      <startdate>string</startdate>
      <cvvcode>string</cvvcode>
      <avsaddr1>string</avsaddr1>
      <avspostcode>string</avspostcode>
      <amount>int</amount>
      <surcharge>int</surcharge>
      <partialcardnumber>string</partialcardnumber>
      <transactionflag>string</transactionflag>
      <customerreference>string</customerreference>
      <fundcode>string</fundcode>
      <key>string</key>
      <gratuity>int</gratuity>
      <accountnumber>string</accountnumber>
      <surname>string</surname>
      <dob>string</dob>
      <cardholdername>string</cardholdername>
      <billingfirstnames>string</billingfirstnames>
      <billingsurname>string</billingsurname>
      <billingaddress1>string</billingaddress1>
      <billingaddress2>string</billingaddress2>
      <billingcity>string</billingcity>
      <billingcounty>string</billingcounty>
      <billingcountry>string</billingcountry>
      <billingpostcode>string</billingpostcode>
      <billingemail>string</billingemail>
      <billingtelephone>string</billingtelephone>
      <savecard>boolean</savecard>
      <ClientIPAddress>string</ClientIPAddress>
      <BrowserJavascriptEnabled>boolean</BrowserJavascriptEnabled>
      <BrowserAcceptHeader>string</BrowserAcceptHeader>
      <BrowserLanguage>string</BrowserLanguage>
      <BrowserUserAgent>string</BrowserUserAgent>
    </smpPerform3DTransaction>
  </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>
    <smpPerform3DTransactionResponse xmlns="http://adelante-software.com/">
      <smpPerform3DTransactionResult>xml</smpPerform3DTransactionResult>
    </smpPerform3DTransactionResponse>
  </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 /Services/SmartPos2/Service.asmx HTTP/1.1
Host: connectpayadmin.test.app.adelante.co.uk
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>
    <smpPerform3DTransaction xmlns="http://adelante-software.com/">
      <uid>string</uid>
      <pwd>string</pwd>
      <accountid>string</accountid>
      <profileid>string</profileid>
      <ordernumber>string</ordernumber>
      <cardnumber>string</cardnumber>
      <expirydate>string</expirydate>
      <issuenumber>string</issuenumber>
      <startdate>string</startdate>
      <cvvcode>string</cvvcode>
      <avsaddr1>string</avsaddr1>
      <avspostcode>string</avspostcode>
      <amount>int</amount>
      <surcharge>int</surcharge>
      <partialcardnumber>string</partialcardnumber>
      <transactionflag>string</transactionflag>
      <customerreference>string</customerreference>
      <fundcode>string</fundcode>
      <key>string</key>
      <gratuity>int</gratuity>
      <accountnumber>string</accountnumber>
      <surname>string</surname>
      <dob>string</dob>
      <cardholdername>string</cardholdername>
      <billingfirstnames>string</billingfirstnames>
      <billingsurname>string</billingsurname>
      <billingaddress1>string</billingaddress1>
      <billingaddress2>string</billingaddress2>
      <billingcity>string</billingcity>
      <billingcounty>string</billingcounty>
      <billingcountry>string</billingcountry>
      <billingpostcode>string</billingpostcode>
      <billingemail>string</billingemail>
      <billingtelephone>string</billingtelephone>
      <savecard>boolean</savecard>
      <ClientIPAddress>string</ClientIPAddress>
      <BrowserJavascriptEnabled>boolean</BrowserJavascriptEnabled>
      <BrowserAcceptHeader>string</BrowserAcceptHeader>
      <BrowserLanguage>string</BrowserLanguage>
      <BrowserUserAgent>string</BrowserUserAgent>
    </smpPerform3DTransaction>
  </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>
    <smpPerform3DTransactionResponse xmlns="http://adelante-software.com/">
      <smpPerform3DTransactionResult>xml</smpPerform3DTransactionResult>
    </smpPerform3DTransactionResponse>
  </soap12:Body>
</soap12:Envelope>

HTTP GET

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

GET /Services/SmartPos2/Service.asmx/smpPerform3DTransaction?uid=string&pwd=string&accountid=string&profileid=string&ordernumber=string&cardnumber=string&expirydate=string&issuenumber=string&startdate=string&cvvcode=string&avsaddr1=string&avspostcode=string&amount=string&surcharge=string&partialcardnumber=string&transactionflag=string&customerreference=string&fundcode=string&key=string&gratuity=string&accountnumber=string&surname=string&dob=string&cardholdername=string&billingfirstnames=string&billingsurname=string&billingaddress1=string&billingaddress2=string&billingcity=string&billingcounty=string&billingcountry=string&billingpostcode=string&billingemail=string&billingtelephone=string&savecard=string&ClientIPAddress=string&BrowserJavascriptEnabled=string&BrowserAcceptHeader=string&BrowserLanguage=string&BrowserUserAgent=string HTTP/1.1
Host: connectpayadmin.test.app.adelante.co.uk

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

<?xml version="1.0"?>
xml

HTTP POST

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

POST /Services/SmartPos2/Service.asmx/smpPerform3DTransaction HTTP/1.1
Host: connectpayadmin.test.app.adelante.co.uk
Content-Type: application/x-www-form-urlencoded
Content-Length: length

uid=string&pwd=string&accountid=string&profileid=string&ordernumber=string&cardnumber=string&expirydate=string&issuenumber=string&startdate=string&cvvcode=string&avsaddr1=string&avspostcode=string&amount=string&surcharge=string&partialcardnumber=string&transactionflag=string&customerreference=string&fundcode=string&key=string&gratuity=string&accountnumber=string&surname=string&dob=string&cardholdername=string&billingfirstnames=string&billingsurname=string&billingaddress1=string&billingaddress2=string&billingcity=string&billingcounty=string&billingcountry=string&billingpostcode=string&billingemail=string&billingtelephone=string&savecard=string&ClientIPAddress=string&BrowserJavascriptEnabled=string&BrowserAcceptHeader=string&BrowserLanguage=string&BrowserUserAgent=string

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

<?xml version="1.0"?>
xml