0900 nummer: Documentatie Pincodelijn
   Niet ingelogd, klik hier
TargetPay home TargetPay SEPA ready
Home iDEAL Bancontact SOFORT Banking Mobile Billing 0900 nummer Premium SMS Paysafecard



Introductie
Hoe werkt het?
Per gesprek lijn
Per minuut lijn
Uitbetalingen
Uw eigen 0900 nummer
Kant-en-klaar modules
Documentatie





0900 nummer: Documentatie Pincodelijn

1. Algemeen
De globale werking van het pincode systeem is als volgt:
  1. U toont aan uw bezoekers het nummer van de pincode lijn. Voor de beschikbare pincodelijnen kijkt u bij het tabblad lijnen. Een voorbeeld vindt u onder punt 2.
  2. De bezoeker belt de pincode lijn, tijdens het gesprek wordt een 6-cijferige pincode opgelezen;
  3. De bezoeker vult de pincode in op uw site. U kunt deze pincode controleren door een URL bij TargetPay aan te roepen (zie punt 3);
  4. Als de pincode juist is, krijgt u een OK status terug en wordt de verkoop op uw account verwerkt. Als de pincode niet juist is dan volgt een foutmelding.
  5. Afhankelijk van de status die teruggestuurd wordt verleent u toegang tot de site.

2. Voorbeeld betaalscherm
U toont de bezoeker een betaalscherm met de volgende informatie:
  • Telefoonnummer;
  • De kosten per gesprek (Nederland);
  • De kosten per minuut en de gespreksduur (België).
Naast deze informatie vraagt u de bezoeker om de ontvangen pincode in te voeren op uw website en dan op de knop 'verder' te klikken.

Voorbeeld

Bel naar 0909-0400170 (€ 1,30 per gesprek).

Tijdens het gesprek wordt een 6-cijferige pincode opgelezen.
Toets de pincode hieronder in en klik op 'verder'.

  



3. Betaling controleren
Om de betaling te controleren roept u de volgende URL aan met behulp van HTTP GET of POST:

https://www.targetpay.com/api/ivr-pincode

Met de volgende parameters:

Variabele Naam Formaat Verplicht
rtlo Layoutcode Numeriek Ja
code Door de gebruiker ingevoerde pincode Numeriek Ja
payline Gebruikte betaallijn Alfanumeriek Ja
country Land Numeriek Ja
test Testmode 0 of 1 Nee

Voorbeeld:

https://www.targetpay.com/api/ivr-pincode?rtlo=12345&code=123456&payline=0909-0400170&country=31

Toelichting per variabele:
  • rtlo
    Het subaccount waarop de verkopen geboekt moeten worden. Voor het aanleggen en bekijken van subaccounts, zie: www.targetpay.com/subaccounts.

  • code
    De 6-cijferige pincode die uw bezoeker heeft ingevuld op de site.

  • payline
    Het nummer van de betaallijn waarnaar gebeld is. In de vorm: '0909-0400885', dus zonder landcode maar met streepje.

  • country
    Land (bijv. 31 = Nederland). Voor een volledige lijst, zie www.targetpay.com/operators

  • test
    Als u de waarde 1 meegeeft voor 'test' dan worden alle checks doorlopen, maar zal altijd een OK status terugkomen, ook als de pincode al ingewisseld of niet uitgegeven is. U kunt deze parameter gebruiken om uw scripts te testen

4. Resultaatcodes
Indien de betaling goed verwerkt is, dan wordt de volgende tekst geretourneerd:

000 OK

Indien de betaling niet goed verwerkt is, dan wordt een van de volgende foutcodes teruggestuurd:

102 No layout code specified
103 No pincode specified
104 Pincode length incorrect
105 Internal Error: no connection to IVR
106 Pincode already checked or not paid
107 Layoutcode unknown
108 No country specified
109 No payline specified
900 Invalid request
901 Incorrect affiliate code
902 Incorrect layoutcode



5. Opmerkingen
  • Het is verplicht om naast de nummers van de bestellijn altijd de kosten te vermelden. Eventuele boetes als gevolg van het niet vermelden van de kosten komen voor uw eigen rekening.

  • U kunt in een script meerdere pincodes tegelijk verwerken, en op die manier veelvouden van bovenstaande tarieven afrekenen. U doet dan per pincode een aanroep zoals hierboven beschreven.

  • Uitgegeven pincodes zijn ca. 24 uur geldig

  • Alle pay-per-call lijnen in België van € 1,25 of hoger worden geblokkeerd door de mobiele operator Proximus. De lijnen blijven wel bereikbaar vanaf de andere mobiele operators en vanaf het vaste net. De lijnen tot en met € 1,00 zijn wel beschikbaar voor Proximus bellers. Dit is een beleidsmaatregel van Proximus waar alle partijen die opereren op de Belgische markt mee te maken hebben. De per-minuut lijnen van € 1,25 of hoger zijn onveranderd bereikbaar vanaf alle mobiele netwerken (dus ook Proximus) en het vaste net. Indien u veel met mobiele klanten werkt is een alternatief een per minuut lijn te gebruiken.
6. Voorbeeld validatiescript
Het onderstaande script kunt u gebruiken om pincodes te valideren. De variabelen bovenin de functie validatePincode() dienen nog op de juiste waarde te worden ingesteld.


<?php

// Geef de resultaatcode uit paragraaf 4  van $code
function validatePincode($code){
  // Stel deze parameters in 
  $rtlo = xxxxx;             // Uw layoutcode 
  $payline = "0909-0400170"; // Nummer van de pincodelijn
  $co = "31";                // Countrycode, 31=NL, 32=BE
  $test = "0";                
	
  $sRequest="http://www.targetpay.com/api/ivr-pincode";
  $strParamString = "?rtlo=".$rtlo."&payline=".$payline.
    "&code=".$code."&country=".$co.
    "&test=".$test;


  # get request
  $ch = curl_init($sRequest.$strParamString);
  curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1) ;
  $strResponse = curl_exec($ch);
  curl_close($ch);

  return $strResponse;
}
  
if( $_GET['pincode'] ){
  $strResponse = validatePincode( $_GET['pincode'] );
  echo  $strResponse; // 000 OK indien succesvol
} else {
  echo "<FORM method=\"GET\" >";
  echo "<input type=\"text\" name=\"pincode\">";
  echo "<input type=\"submit\">";
  echo "</form>";
}
?>


© TargetPay.com

F.A.Q. | Contact | Netwerk status | Voorwaarden | Cookie Policy | Cookie Instellingen | Privacy | Regelgeving | Over ons... | Print versie