Skip to content

SOAP API

This API is an legacy API. As service we implemented the giropay change also in this api
API URL = https://connect.icepay.com/webservice/ICEPAY.svc
We'll be adding the following fields to our API.

ShoppingCartType

This categorizes the shopping cart of a checkout based on the properties of the goods it contains.

  • PHYSICAL: The shopping cart contains only physical goods.

  • DIGITAL: The shopping cart contains only digital goods.

Depending on the value of ShoppingCartType, the following newly added fields are either mandatory or optional:

  • ShippingAddress.FirstName
  • ShippingAddress.LastName
  • ShippingAddress.PostalCode
  • ShippingAddress.City
  • ShippingAddress.Country
  • ShippingAddress.Email

Warning

Note that ShippingAddress is an XML object

To determine which fields are mandatory or optional (based on the value of ShoppingCartType), we provide the following table.

ShoppingCartType PHYSICAL DIGITAL
FirstName Mandatory Mandatory
LastName Mandatory Mandatory
PostalCode Mandatory Optional
City Mandatory Optional
Country Mandatory Optional
Email Optional Mandatory

If needed a WSDL can be retrieved from https://connect.icepay.com/webservice/ICEPAY.svc?singleWsdl Some examples on our API

PHYSICAL

<?xml version="1.0" encoding="utf-16"?>
<s:Envelope
    xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Header>
        <To s:mustUnderstand="1"
            xmlns="http://schemas.microsoft.com/ws/2005/05/addressing/none">https://connect.icepay.com/webservice/ICEPAY.svc
        </To>
        <Action s:mustUnderstand="1"
            xmlns="http://schemas.microsoft.com/ws/2005/05/addressing/none">connect.icepay.com/IICEPAY/Checkout
        </Action>
    </s:Header>
    <s:Body>
        <Checkout
            xmlns="connect.icepay.com">
            <request
                xmlns:a="http://schemas.datacontract.org/2004/07/APIService"
                xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <a:Checksum></a:Checksum>
                <a:MerchantID></a:MerchantID>
                <a:Timestamp>{{timestamp}}</a:Timestamp>
                <a:Amount>100</a:Amount>
                <a:Country>NL</a:Country>
                <a:Currency>EUR</a:Currency>
                <a:Description></a:Description>
                <a:Issuer>DEFAULT</a:Issuer>
                <a:Language>NL</a:Language>
                <a:OrderID></a:OrderID>
                <a:PaymentMethod>giropay</a:PaymentMethod>
                <a:Reference></a:Reference>
                <a:ShippingAddress>
                    <a:FirstName>John</a:FirstName>    
                    <a:LastName>Doe</a:LastName>
                    <a:PostalCode>1114AN</a:PostalCode>
                    <a:City>Amsterdam</a:City>
                    <a:Country>NL</a:Country>
                </a:ShippingAddress>
                <a:ShoppingCartType>PHYSICAL</a:ShoppingCartType>
                <a:URLCompleted>https://icepay.com</a:URLCompleted>
                <a:URLError>https://icepay.com</a:URLError>
            </request>
        </Checkout>
    </s:Body>
</s:Envelope>

DIGITAL

<?xml version="1.0" encoding="utf-16"?>
<s:Envelope
    xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Header>
        <To s:mustUnderstand="1"
            xmlns="http://schemas.microsoft.com/ws/2005/05/addressing/none">https://connect.icepay.com/webservice/ICEPAY.svc
        </To>
        <Action s:mustUnderstand="1"
            xmlns="http://schemas.microsoft.com/ws/2005/05/addressing/none">connect.icepay.com/IICEPAY/Checkout
        </Action>
    </s:Header>
    <s:Body>
        <Checkout
            xmlns="connect.icepay.com">
            <request
                xmlns:a="http://schemas.datacontract.org/2004/07/APIService"
                xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <a:Checksum></a:Checksum>
                <a:MerchantID></a:MerchantID>
                <a:Timestamp>{{timestamp}}</a:Timestamp>
                <a:Amount>100</a:Amount>
                <a:Country>NL</a:Country>
                <a:Currency>EUR</a:Currency>
                <a:Description></a:Description>
                <a:Issuer>DEFAULT</a:Issuer>
                <a:Language>NL</a:Language>
                <a:OrderID></a:OrderID>
                <a:PaymentMethod>giropay</a:PaymentMethod>
                <a:Reference></a:Reference>
                <a:ShippingAddress>
                    <a:FirstName>John</a:FirstName>    
                    <a:LastName>Doe</a:LastName>
                    <a:Email>info@icepay.com</a:Email>
                </a:ShippingAddress>
                <a:ShoppingCartType>DIGITAL</a:ShoppingCartType>
                <a:URLCompleted>https://icepay.com</a:URLCompleted>
                <a:URLError>https://icepay.com</a:URLError>
            </request>
        </Checkout>
    </s:Body>
</s:Envelope>