Micropayments (Pincode variant)
With this setup of the micropayments-system you can let your customer pay without opening a order screen.
Payment procedure
The procedure for payments is slightly different from the other variants of the micropayments system. With the pincode variant you only need to mention the premium rated phoneline your customers should call: For example: "Call to 0909-8356 (€ 1,30 per call)" and enter the code that will be given to you.
During the call a 6-digit code will be read, to check the validity of that code you need to call an URL on our server along with your layoutcode and countrycode. When the payment has been validated the sale will be counted and you'll get an 'OK' message in return.
To verify a payment, call the URL: "http://www.ringtonio.nl/mp", with these parameters:
| co | Countrycode (31 = Netherlands) |
| rtlo | Layoutcode (look up) |
| code | Pincode |
Bijv. http://www.ringtonio.nl/mp?co=31&rtlo=1234&code=123456
You can find examples in ASP and PHP below. The resultcode will be put in $result (PHP) or x_Result (ASP) respectively. A complete list with all possible return codes can be found on the bottom of this page.
Important!
- You must clearly mention the costs of using the premium rated line next to the phonenumber (0909-8356), these are € 1,30 per call;
- This option is currently only available in the Netherlands;
- Kick-backs for these micropayments are € 1,- including VAT.
- To test your service, you can give an extra parameter to our URL: 'test=1' . All pincodes will return an OK status, when they are passed on in the proper format;
Example PHP
<?
$pincode = $_GET["code"];
$co = "31";
$url = "http://www.ringtonio.nl/mp?rtlo=1234&co=$co&code=";
$url .= urlencode($pincode);
$result = @implode("",file($url));
?>
| |
Example ASP
XMLHTTP must be installed to get it working!
code=Request("code")
co="31"
Set xml = Server.CreateObject("Microsoft.XMLHTTP")
xurl="http://www.ringtonio.nl/mp?rtlo=1234&code=" & code & "&co=" & co
xml.Open "GET", trim(xurl), False
xml.Send ""
HTTPReturnCode=xml.status
x_Result = xml.ResponseText
Set xml = Nothing |
Possible resultcodes
| Code | Explanation |
| OK |
Pincode was correct, the order has been counted. |
| Geen layout-code meegegeven (102) |
The parameter 'rtlo' was not given. |
Geen pincode meegegeven (103)
|
The parameter 'pincode' was not given. |
Onjuiste pincode meegegeven (104)
|
The pincode doesn't consist of 6-digits. |
| Pincode is reeds ingewisseld of niet betaald (106) |
This pincode is not payed, or was entered before. |
| Klantnummer bij subaccount ... is niet bekend (107) |
The system couldn't determine to which partner the layout 'rtlo' belongs. |
