Requests and Responses (Deprecated)
For all directkitjson users: please migrate to directkitjson2. We will only maintain the directkitjson for backward compatibility.
XML Soap and JSON formats are available, data are encoded using UTF-8.
Request model
Tip for WSDL users
A WSDL file is available to easily generate our objects and methods. If you wish to use it, just add ?wsdl to the URL of the DIRECTKIT.
Tip for JSON users
- Please send all parameters in all calls, even the ones that are not required (send an empty string). You do not have to do this with directkitjson2
- In the header of the request, you need to specify the content-type : "Content-type: application/json; charset=utf-8"
- Add the method name to the end of the DirectKit url, that is where you need to POST the data. Example if you wish to call RegisterWallet : https://../directkitjson/service.asmx/RegisterWallet
Format of the data to be sent :
XML
<?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>
<MethodName xmlns="Service_mb">
<wlPass>string</wlPass>
<wlLogin>string</wlLogin>
<language> string </language>
<version> string </version>
<walletIp> string </walletIp>
<walletUa>string </walletUa>
</MethodName>
</soap12:Body>
</soap12:Envelope>
JSON
{
"wlPass":"string",
"wlLogin":"string",
"language":" string ",
"version":" string ",
"walletIp":" string ",
"walletUa":"string "
}
MethodName: name of the method in this API i.e."RegisterWallet"
All requests should contain:
Item | Description | Mandatory | Format | Example |
---|---|---|---|---|
wlLogin | Your login | Yes | [1 : 50] char | Pizza87 |
wlPass | Your access key is given after the creation of your site, you can change it in the Backoffice. | Yes | [1 : 50] char | aizohdeh78 |
language | Response language | Yes | [2 : 3] char | fr: French (by default) |
version | A version of the method. Request and response can be different depending on the version used. | Yes | [4] char | 1.0 (by default) |
walletIp | IP address of the final client | Yes | char | 91.222.226.32 |
walletUa | User-agent of the final client | No | char | Mozilla/5.0 (Windows NT 6.1; WOW64) |
Please send the IP address and user agent of your client, not your server, to help us fight against fraud and reduce your Customer Care calls when we have a claim from a user.
Answers
The answer is returned as follow:
XML
<?xml version="1.0" encoding="utf-8" ?>
<String>The XML answer</String>
JSON
{
"String":"The XML answer"
}