Start transactie bij PremiumXS
Nadat de klant zijn eigen bank heeft gekozen kunt u de transactie opstarten bij PremiumXS.
Hiervoor maakt u gebruik van de functie DoIdealRequest().
Bij het aanroepen geeft u het issuerID van de door de gebruiker gekozen bank mee.
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.
De productbeschrijving die u meegeeft onder de parameter productDescription is uiteindelijk te zien op het bankafschrift van de gebruiker.
Nadat u de transactie hebt gestart ontvangt u van PremiumXS een forwardURL. Hiernaartoe kunt u uw klant doorsturen.
U kunt dit in hetzelfde browserwindow doen of in een nieuw venster/tabblad.
Het verdient de aanbeveling het doorsturen in hetzelfde browserwindow te doen.
Functie overzicht
DoIdealRequest() 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
|
|
issuerID
|
Unieke code van de bank van de klant.
|
Integer
|
-
|
|
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
|
|
returnURL
|
Naar deze URL wordt de klant doorgestuurd nadat de betaling succesvol is afgerond.
Aan deze URL wordt een querystring toegevoegd met daarin de parameters reference(uw eigen kenmerk) en id(het door PremiumXS aan de transactie toegekende kenmerk).
|
String
|
512 karakters
|
|
cancelURL
|
Naar deze URL wordt de klant doorgestuurd nadat de betaling mislukt is of wanneer deze is afgebroken.
Aan deze URL wordt een querystring toegevoegd met daarin de parameters reference(uw eigen kenmerk) en id(het door PremiumXS aan de transactie toegekende kenmerk).
|
String
|
512 karakters
|
|
languageCode
|
Taal van de klant. De meeste banken ondersteunen alleen Nederlands(NL).
|
String
|
2 karakters
|
DoIdealRequest() 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
|
-
|
|
forwardURL
|
De URL van de bank. Hiernaartoe kunt u uw gebruiker doorsturen.
|
String
|
512 karakters
|