Fixed Price
U kunt een Fixed Price transactie starten via de functie DoFixedPremiumRateRequest(). Hierbij geeft u een ProductTypeID mee. Daarmee geeft u aan wat de aard is van het
product. Uw keuze hier bepaalt wat voor telefoonnummer u kunt gebruiken. In Nederland is er bijvoorbeeld keuze uit 0900(informatiediensten), 0906(erotiek) en
0909(entertainment). U geeft ook het bedrag mee dat u wilt af laten rekenen. Op basis hiervan wordt de gespreksduur berekend.
Bij de aanroep kunt u ook een reference meegeven.
Deze reference wordt door PremiumXS gebruikt bij het geven van de terugkoppeling en terugsturen van de klant naar uw website.
Met de reference kunt u de transactie dan binnen uw eigen systeem herkennen.
In het antwoord dat u ontvangt staat een telefoonnummer, een tariefmelding en een code. Deze kunt u aan de klant weergeven. De klant kan dan naar het opgegeven
telefoonnummer bellen. De code bestaat uit 4 of 5 cijfers(5-cijferige codes worden alleen gebruikt als het erg druk is). Daarnaast ontvangt u in het antwoord
de tijd(seconden) die nodig is om het gewenste bedrag te betalen.
Nadat de klant heeft ingebeld wordt deze verzocht de code in te toetsen en af te sluiten met een hekje(#). Wanneer de code is geaccepteerd begint het betalen.
Als de klant het volledige bedrag heeft volgebeld wordt de verbinding verbroken.
U ontvangt een terugkoppeling op de door u opgegeven statusURL. Hierin staat de statuscode '200'. Dit betekent dat de transactie is voltooid.
Als de klant tussentijds de verbinding verbreekt krijgt u een terugkoppeling met daarin de code '201'. U krijgt in de terugkoppeling ook het aantal seconden
dat er wel gebeld is mee. U kunt op basis hiervan zelf een actie ondernemen.
Functieoverzicht
DoFixedPremiumRateRequest() Aanroep
| Parameter |
Beschrijving |
Type |
Max. Lengte |
|
CustomerID
|
Unieke identificatie voor gebruik API
|
String
|
42 karakters
|
|
paymentProfileID
|
In een PaymentProfile staan verschikllende betaalmethoden geconfigureerd. U kunt standaard de volgende waarden gebruiken:
1: Standaard
3: Test(alleen voor PremiumRate)
|
Integer
|
-
|
|
Reference
|
Uw eigen kenmerk. Wordt ook gebruikt bij de terugkoppeling en het terugsturen van de klant naar uw website.
|
String
|
64 karakters
|
|
productCode
|
Hier kunt u zelf een waarde opgeven. Deze waarde wordt later gebruikt bij het genereren van statistieken.
|
String
|
16 karakters
|
|
productDescription
|
Beschrijving van het product dat afgerekend wordt. Komt later ook op het bankafschrift.
|
String
|
128 karakters
|
|
productTypeID
|
Geeft hiermee de aard van het product aan. U kunt kiezen uit de volgende waarden:
- Standaard
- Erotiek
- Entertainment
|
Integer
|
-
|
|
ipAddress
|
Het IP-adres van de klant.
|
String
|
15 karakters
|
|
countryCode
|
Het land waarin de klant zich bevindt.
|
String
|
2 karakters
|
|
price
|
Het bedrag dat u af wilt laten rekenen.
|
Decimal
|
-
|
|
currency
|
De munteenheid van het bedrag dat u wilt laten afrekenen.
|
String
|
3 karakters
|
|
addPaymentCosts
|
Deze parameter is momenteel niet in gebruik, geef hier de waarde ‘false’ op.
|
Boolean
|
-
|
|
statusURL
|
URL waarnaar de terugkoppeling wordt verzonden. Als u geen terugekoppeling wilt ontvangen kunt u dit veld leeglaten.
|
String
|
512 karakters
|
DoFixedPremiumRateRequest() Antwoord
| Parameter |
Beschrijving |
Type |
Max. Lengte |
| status |
Resultaat van de aanvraag. De waarde 'OK' betekent dat de transactie gestart is. Indien dit niet zo is staat hier de reden. |
String |
512 karakters |
| statusCode |
Code die het resultaat van de aanvraag bepaalt. Code '0' betekent dat de transactie gestart is. Anders staat hier een foutcode. |
Integer |
- |
|
transactionID
|
Uniek kenmerk dat door PremiumXS aan de transactie wordt gekoppeld. Wordt ook gebruikt bij de terugkoppeling en het terugsturen van de klant
naar uw website.
|
GUID
|
-
|
|
premiumRateNumber
|
Het betaalnummer waarnaar de klant moet bellen.
|
String
|
32 karakters
|
|
tariffMessage
|
De kosten per minuut voor het bellen naar het betaalnummer. U bent verplicht deze samen met het telefoonnummer weer te geven.
|
String
|
128 karakters
|
|
pincode
|
De code die klant in moet toetsen op de telefoon nadat het betaalnummer is gebeld.
|
Integer
|
1000 - 99999
|
|
callDuration
|
Het aantal seconden dat nodig is voor het gesprek. Bij PayPerCall is dat altijd 0.
|
Integer
|
-
|