Afrekenen met de Pay per Use variant werkt als volgt:
Uw website vraagt bij Targetmedia het te bellen telefoonnummer en de in te voeren betaalcode op (zie kopje 2);
U toont deze gegevens aan uw bezoeker (zie kopje 3);
De bezoeker belt naar het getoonde telefoonnummer en toetst de betaalcode in. De bezoeker blijft aan de lijn zolang hij of zij gebruik wil maken van uw dienst. Het gesprek wordt alleen verbroken indien de bezoeker ophangt of uw website geen toegang meer verleent tot de content. De bezoeker hoort elke 30 seconden een melding dat er nog steeds verbinding is.
Als de bezoeker heeft opgehangen, melden wij aan uw systeem dat de verbinding verbroken is. U kunt er dan voor zorgdragen dat de bezoeker geen toegang meer heeft tot de content.
2. Aanvraag telefoonnummer en betaalcode
2.1 Aanroep
Wanneer u de bezoeker de mogelijkheid wil bieden te bellen met de Pay per Use lijn, dient uw systeem een betaalcode en telefoonnummer aan te vragen bij ons systeem via een HTTP GET of POST naar:
tb Tariefband in centen in de lokale valuta van het gekozen land. Kijk op www.targetpay.com/advanced/ivr-ppu/lijn voor een overzicht
van alle mogelijkheden.
cu Uw url waar wij aan kunnen melden welke betaalstatus een bezoeker heeft. U kunt uw eigen parameters meegeven, zolang deze niet hetzelfde zijn als de parameters die Targetmedia gebruikt, zie: kopje 4.
iphash IP-adres van uw bezoeker of de eerste 10 tekens van een md5 hash van het IP-adres.
adult In sommige landen is het verplicht om het afrekenen van adult-diensten te laten verlopen via een aparte reeks telefoonnummers. Om waar nodig een adultnummer te kiezen dient u aan te geven of de betaling een adult dienst betreft of niet (1=adult dienst, 0=non-adult)
test Als u de waarde 1 meegeeft voor 'test' dan worden alle checks doorlopen, maar uw betaling wordt niet opgeslagen. U krijgt altijd dezelfde pincode en hetzelfde telefoonnummer terug indien alles OK is. U kunt deze parameter gebruiken om uw scripts te testen.
2.2 Resultaatcodes
Indien akkoord, dan wordt een tekst in het volgende formaat geretourneerd:
000 OK|xxxxxx|yyyyyy
Waarbij:
xxxxxx : 6-cijferige betaalcode welke uw bezoeker moet intoetsen tijdens het bellen
yyyyyy : Het te bellen telefoonnummer
Voorbeeld: Als het systeem antwoord met 000 OK|484932|0909-0400397, dan dient uw bezoeker te bellen
met 0909-0400397 en de code 484932 in te toetsen.
Als er een fout is opgetreden, dan volgt een foutnummer gevolgd door een fouttekst. Mogelijke foutmeldingen zijn:
001 Invalid call type
002 Invalid tariff for call type PC and country
003 Invalid tariff for call type PM and country
004 Invalid tariff for call type PU and country
005 Invalid call duration for this call type and country
006 Call type not available in this country
007 Invalid country code
008 Confirm URL missing
009 Call duration missing
010 Invalid iphash
3. Tonen betaalscherm aan bezoeker
U toont nu de bezoeker een betaalscherm met de volgende informatie:
Telefoonnummer (in het formaat zoals door ons is doorgegeven. Bijv. 0909-4001234 mag dus nooit vermeld worden als 090-94001234);
Betaalcode;
Valuta en prijs per minuut;
Naast deze informatie vraagt u de bezoeker op een knop te klikken als er verbinding is gemaakt met het betaalsysteem. Het is ook handig te vermelden dat de bezoeker aan de lijn dient te blijven.
Voorbeeld
Bel naar 0909-0400397 (€ 0,80 per minuut).
Toets tijdens het bellen de betaalcode 484932 in. Klik op de button 'verder' als er verbinding is gemaakt met de website. U dient aan de lijn te blijven zolang u gebruik wilt maken van deze dienst.
4. Uitleg van de confirm url
4.1 Aanroep bij verbinding
Na het controleren van de betaalcode en als de bezoeker verbonden is elke 30 seconden doen wij een aanroep via HTTP GET naar de url die u bij 2.1 heeft opgegeven:
http://www.[uwdomein].nl/status.asp
Met de volgende parameters:
Variabele
Naam
Formaat
Voorbeeld
callid
Call ID
Alfanumeriek
10038383-1-22567
status
Betaalstatus
Alfanumeriek
CON
paycode
De betaalcode
Numeriek
654321
payline
De 090x-lijn
Alfanumeriek
0909-0400397
country
2-cijferige landcode
Numeriek
31
caller
De bezoeker
Alfanumeriek
02012345xxx
Toelichting per variabele:
callid Uniek nummer gegenereerd door Targetmedia bij elk gesprek. Kan door u gebruikt worden als referentie in uw systeem.
paycode De betaalcode (geretourneerd bij 2.2)
status De status van de betaling, is altijd 'CON' (connected) bij verbinding.
payline Het telefoonnummer van de 0900-lijn waar de bezoeker naar belt.
country 2 cijferige landcode. Zelfde waarde als meegegeven onder 2.1)
caller Telefoonnummer van de bezoeker indien dit bij ons bekend is. Om privacy redenen kunnen wij de laatste 3 cijfers niet doorgeven.
Eventuele eigen parameters die u bij de aanroep heeft doorgegeven worden uiteraard ook geretourneerd.
4.2 Resultaatcode's
Een succesvolle aanroep dient uw systeem te beantwoorden met:
OK
Zonder deze OK melding wordt de verbinding door de IVR verbroken.
4.3 Aanroep bij ophangen
Wanneer de bezoeker opgehangen heeft of wij krijgen van uw systeem niet de juiste response (OK) terug dan roepen wij nogmaals de bij 2.1 opgegeven url aan via HTTP GET:
http://www.[uwdomein].nl/status.asp
Met de volgende parameters:
Variabele
Naam
Formaat
Voorbeeld
callid
Call ID
Alfanumeriek
10038383-1-22567
status
Betaalstatus
Alfanumeriek
DIS
paycode
De betaalcode
Numeriek
654321
cd
Gespreksduur in seconden
Numeriek
355
payline
De 0900-lijn
Alfanumeriek
0909-0400397
country
2-cijferige landcode
Numeriek
31
caller
De bezoeker
Alfanumeriek
02012345678
Toelichting per variabele:
callid Uniek nummer (zie 4.1).
paycode De betaalcode (zie 2.2)
cd De gespreksduur in seconden dat de bezoeker verbonden is geweest.
status De status van de betaling, is altijd 'DIS' (=disconnected) bij ophangen.
payline Het telefoonnummer van de 090x-lijn (zie 4.1).
country 2 cijferige landcode (zie 4.1)
caller Telefoonnummer van de bezoeker (zie 4.1).
Eventuele eigen parameters die u bij de aanroep heeft doorgegeven worden ook geretourneerd.
Niet ingelogd, klik hier
