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