paysafecard voor Webservices API

  Laatst bijgewerkt: 

 

CW50.png

A "paysafecard" is een voorafbetaalde kaart die uw klanten wereldwijd bij verkooppunten (bijvoorbeeld bij PayPoint) kunnen kopen. Elke paysafecard bevat een unieke pincode die de klant op de kassapagina kan invoeren om een aankoop te voltooien.

"myPaysafe" is een persoonlijke online betaalrekening om klanten te helpen meerdere PIN-codes op paysafecard bij te houden. De klant kan ervoor kiezen om zich op het moment van aankoop aan te melden bij zijn "myPaysafe" account, waarmee hij kan betalen met paysafecard PIN-codes die op zijn account zijn opgeslagen.

  Ondersteunde landen   Geen beperkingen voor landen van de klant
  Ondersteunde munteenheden   ARS, AUD, BGN, CAD, CHF, CZK, DKK, EUR, GBP, HUF, MXN, NOK, NZD, PEN, PLN, RON, SEK, TRY, USD, UYU
  Terugbetalingen

Alleen Payouts worden ondersteund.

  Terugboekingen

  Betalingen zijn niet onderhevig aan terugboekingen.

  Zero-authorisation

  Niet ondersteund.

  Terugkerende betalingen

  Niet ondersteund.

 

Configuratie

Om paysafecard op uw account in te schakelen, neemt u contact op met uw accountmanager.
Er wordt een testzandbakaccount verstrekt, die u nodig hebt om uw implementatie te testen.

 

Procesoverzicht

Wat zal de klant zien?

  • Tijdens het afrekenen presenteert uw website paysafecard als betaalmethode.
  • De klant selecteert het gewenste afleveradres op uw afrekenpagina en kiest voor betaling via paysafecard.
  • De klant wordt doorgestuurd naar paysafecard, waar hij zijn PIN-code(s) kan invoeren of kan inloggen op zijn "myPaysafe" account.
  • De klant bekijkt zijn bestelling en gaat akkoord met de betaling op paysafecard.
  • De klant wordt doorgestuurd naar uw website, waar een bevestiging wordt weergegeven (bv. "Betaling geslaagd").

CW14-NL.png

Hoe werkt het achter de schermen?

De paysafecard betalingsstroom kan worden opgesplitst in drie hoofdonderdelen, zoals hieronder weergegeven:


  1. Initieer de klant
    • De klant gaat akkoord met een betaling via paysafecard op de website van de verkoper.
    • Merchant dient ORDER verzoek in om de sessie te starten, inclusief cancelurl en returnurl.
    • Merchant ontvangt ORDER antwoord, inclusief customerredirecturl.

  2. Doorverwijzen naar paysafecard
    • De Merchant leidt de browser van de klant door naar de customerredirecturl.
    • De klant voert de PIN-code(s) in die te vinden is (zijn) op paysafecard of meldt zich aan.
    • Als dit lukt, wordt de browser van de klant omgeleid naar de returnurl.

        Als de bestelling op paysafecard wordt geannuleerd, wordt de browser doorgestuurd naar de cancelurl waar een foutmelding kan worden weergegeven. We raden aan om alternatieve betaalmethoden weer te geven, zodat de klant het opnieuw kan proberen.

  3. De verwerking van de autorisatie
    • Alleen als het bovenstaande is gelukt, dient de verkoper een AUTH verzoek in om de betaling te verwerken.
    • De verkoper ontvangt het antwoord AUTH en toont de ontvangstpagina aan de klant.

 

1. Initieer de klant

Wanneer de klant ervoor kiest te betalen met paysafecard, moet uw systeem een ORDER verzoek uitvoeren en het teruggestuurde antwoord interpreteren.

 

ORDER verzoekvoorbeeld

Python PHP cURL Ruwe JSON Ruwe XML
#!/usr/bin/python
import securetrading

stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)

order = {
"currencyiso3a": "GBP",
"requesttypedescription": "ORDER",
"accounttypedescription": "ECOM",
"sitereference": "test_site12345",
"baseamount": "2001",
"paymenttypedescription": "PAYSAFECARD",
"returnurl": "https://www.example.com/return",
"cancelurl": "https://www.example.com/cancel",
"billingid": "000001",
"paysafeminage": "18",
"paysafekyclevel": "SIMPLE",
"paysafecountryrestriction": "DE"
}

strequest = securetrading.Request()
strequest.update(order)
stresponse = st.process(strequest) #stresponse contains the transaction response

Vervang <DOMAIN> met een ondersteund domein. Klik hier voor een volledige lijst.

 

Specificatie veld

  Veld Formaat Beschrijving
X1-EN.png accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) Alleen "ECOM" (e-commerce) wordt ondersteund.
X1-EN.png baseamount
XPath: /billing/amount
Numeriek (11) Het bedrag van de transactie in basiseenheden, zonder komma's of decimalen, dus €10 wordt ingediend als 1000. Deze waarde moet groter zijn dan nul.
X1-EN.png billingid
XPath: /billing/@id
Alfanumeriek (100) Een door u opgegeven id, gebruikt om de klant te identificeren.

 U moet altijd een billingid:

  • Aan elke klant moet een unieke id worden toegekend.
  • Dit id moet opnieuw worden gebruikt door terugkerende klanten.
X1-EN.png cancelurl
XPath: /merchant/cancelurl
URL (2048) De URL waarnaar de klant wordt teruggestuurd als hij de autorisatie annuleert terwijl hij zich op de servers van paysafecardbevindt.
X1-EN.png currencyiso3a
XPath: /billing/amount/@currencycode
Alpha (3) De Munt waarin de transactie zal worden verwerkt. paysafecard transacties kunnen worden verwerkt in de volgende valuta:

ARS, AUD, BGN, CAD, CHF, CZK, DKK, EUR, GBP, HUF, MXN, NOK, NZD, PEN, PLN, RON, SEK, TRY, USD, UYU

Klik hier voor meer informatie over Munt codes.

X1-EN.png paymenttypedescription
XPath: /billing/payment/@type
Alpha (20) Deze waarde moet worden ingediend als "PAYSAFECARD".
X1-EN.png requesttypedescription
XPath: /@type
Alpha (20) De waarde in het verzoek moet "ORDER" zijn.
X1-EN.png returnurl
XPath: /merchant/returnurl
URL (2048) De URL waarnaar de klant wordt teruggestuurd na bevestiging van de betaling door paysafecard.
X1-EN.png sitereference
XPath: /operation/sitereference
Alfanumeriek
& underscore (50)
De site referentie heeft betrekking op uw individuele account die u bij de installatie hebt ontvangen. Als u uw site referentie niet kent, neem dan contact op met ons Support Team.
X3-EN.png orderreference
XPath: /merchant/orderreference
Alfanumeriek, inclusief symbolen (25)

 

Aanbevolen lengte 25 tekens of minder (exacte lengte afhankelijk van de wervende bank). Niet-naleving van deze eis kan ertoe leiden dat de tekst in de transactie wordt ingekort.

Uw unieke bestelreferentie die in het Trust Payments systeem kan worden opgeslagen.
X3-EN.png paysafecountryrestriction
XPath: /billing/payment/paysafe/countryrestriction
Alpha (2) Beperkt de verwerking van de betaling tot uitsluitend het opgegeven land (in iso2a-formaat).

bijv. "GB" voor Verenigd Koninkrijk.

Klik hier voor een volledige lijst van landcodes.

X3-EN.png paysafekyclevel
XPath: /billing/payment/paysafe/kyclevel
Alfa (6)

Specificeert het vereiste KYC-niveau voor de rekeninghouder "myPaysafe". Er zijn twee niveaus:

  • "SIMPLE" - De klant heeft het eerste registratieproces succesvol afgerond en zijn mobiele nummer en e-mailadres bevestigd.
  • "FULL" - Naast het bovenstaande heeft de klant ook een identificatiebewijs (bv. paspoort, rijbewijs) en een bewijs van adres (bv. rekening van een nutsbedrijf) verstrekt.
X3-EN.png paysafeminage
XPath: /billing/payment/paysafe/minage
Numeriek (3) Bepaalt de minimumleeftijd van de rekeninghouder "myPaysafe".

Als u bijvoorbeeld alleen 18-plussers wilt toelaten, vul dan in dit veld "18" in.

 

ORDER antwoordvoorbeeld

Python PHP Ruwe JSON Ruwe XML
{
u 'requestreference': u 'A0bxh87wt',
u 'version': u '1.00',
u 'responses': [{
u 'transactionreference': u '72-32-20002',
u 'paymenttypedescription': u 'PAYSAFECARD',
u 'settleduedate': u '2016-12-23',
u 'transactionstartedtimestamp': u '2016-12-23 15:35:40',
u 'errormessage': u 'Ok',
u 'accounttypedescription': u 'ECOM',
u 'errorcode': u '0',
u 'customerredirecturl': u 'https://www.paysafecard.com/etc',
u 'requesttypedescription': u 'ORDER',
u 'settlestatus': u '0',
u 'operatorname': u 'webservices@example.com',
u 'livestatus': u '0',
u 'paysafeminage': u '18',
u 'paysafekyclevel': u 'SIMPLE',
u 'paysafecountryrestriction': u 'DE',
u 'paysafeid': u '23842'
}]
}

 

Specificatie veld

  Veld Formaat Beschrijving
X4-EN.png accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) De geretourneerde waarde is "ECOM".
X4-EN.png customerredirecturl
XPath: /customer/redirecturl
URL (500) U moet de browser van de klant omleiden naar deze URL om verder te gaan met de betaling.
X4-EN.png errorcode
XPath: /error/code
Numeriek (1-5)

De foutcode (errorcode) moet worden gebruikt om te bepalen of het verzoek succesvol was of niet.

  • Als de foutcode "0" is, is de transactie geslaagd.
  • Als de foutcode niet "0" is, was de transactie niet succesvol.

Klik hier voor een volledige lijst van errorcode en berichtwaarden.

X4-EN.png errormessage
XPath: /error/message
Alfanumeriek (255) Dit is het bericht dat overeenkomt met de bovenstaande code.

Klik hier voor een volledige lijst van errorcode en berichtwaarden.

X4-EN.png livestatus
XPath: /live
Numeriek (1)
  • 0 - Transactie verwerkt met een testrekening.
  • 1 - Transactie verwerkt met een live rekening.
X4-EN.png operatorname
XPath: /merchant/operatorname
Alfanumeriek (255) De waarde van dit veld bevat de naam van de gebruiker die het verzoek heeft verwerkt.
X4-EN.png paymenttypedescription
XPath: /billing/payment/@type
Alpha (20) De geretourneerde waarde is "PAYSAFECARD".
X4-EN.png paysafeid
XPath: /paysafe/@id
Alfanumeriek (255) Een unieke id die door paysafecard aan de transactie is toegekend. U kunt deze id's opslaan voor toekomstige correspondentie met paysafecard.
X4-EN.png requesttypedescription
XPath: /@type
Alpha (20) De teruggezonden waarde is "ORDER".
X4-EN.png settleduedate
XPath: /settlement/settleduedate
Datum JJJJ-MM-DD De datum waarop de transactie zal worden afgewikkeld.
X4-EN.png settlestatus
XPath: /settlement/settlestatus
Numeriek (3)
  • "0" betekent dat er tot dusver geen problemen zijn gerezen die verhinderen dat afwikkeling plaatsvindt.
  • "3" geeft aan dat het verzoek niet succesvol was.
X4-EN.png transactionreference
XPath: /transactionreference
Alfanumeriek, inclusief
koppeltekens (25)
Een unieke referentie voor het verzoek, toegewezen door Trust Payments.

U moet deze referentie indienen in het AUTH verzoek dat volgt.

X4-EN.png transactionstartedtimestamp
XPath: /timestamp
Datum tijd JJJJ-MM-DD hh:mm:ss Het tijdstip waarop het verzoek is verwerkt.
X2-EN.png errordata
XPath: /error/data
Alfanumeriek (255)

Aanvullende informatie om te helpen bij het oplossen van de fout.

Wordt alleen geretourneerd als er een fout is opgetreden.

X2-EN.png paysafecountryrestriction
XPath: /billing/payment/paysafe/countryrestriction
Alpha (2) Beperkt de verwerking van de betaling tot uitsluitend het opgegeven land (in iso2a-formaat).

bijv. "GB" voor Verenigd Koninkrijk.

Klik hier voor een volledige lijst van landcodes.

Teruggestuurd indien ingediend in het ORDER verzoek.

X2-EN.png paysafekyclevel
XPath: /billing/payment/paysafe/kyclevel
Alfa (6)

Specificeert het vereiste KYC-niveau voor de rekeninghouder "myPaysafe". Er zijn twee niveaus:

  • "SIMPLE" - De klant heeft het eerste registratieproces succesvol afgerond en zijn mobiele nummer en e-mailadres bevestigd.
  • "FULL" - Naast het bovenstaande heeft de klant ook een identificatiebewijs (bv. paspoort, rijbewijs) en een bewijs van adres (bv. rekening van een nutsbedrijf) verstrekt.

Teruggestuurd indien ingediend in het ORDER verzoek.

X2-EN.png paysafeminage
XPath: /billing/payment/paysafe/minage
Numeriek (3)

De minimumleeftijd van de "myPaysafe" rekeninghouder, zoals gespecificeerd in de ORDER aanvraag.

Teruggestuurd indien ingediend in het ORDER verzoek.

 

2. Doorverwijzen naar paysafecard

Na het succesvol indienen van een ORDER verzoek, zal uw systeem een customerredirecturl in het antwoord. Uw systeem moet de klant omleiden naar deze URL, een pagina gehost door paysafecard, om de betaling te verwerken.

Bij het testen wordt u doorgestuurd naar paysafecard's zandbakpagina, die de pagina simuleert die aan uw klanten zal worden getoond (screenshot hieronder).

CP66-NL.png

De klant krijgt de keuze tussen:

  • De pincode op hun kaart invoeren (ze kunnen indien nodig meerdere pincodes invoeren).
  • Aanmelden bij hun "myPaysafe" account.

De klant kan de betaling uitvoeren door op de knop "Betalen" te klikken.

Als u bepaalde beperkingen opgeeft in het ORDER verzoek (bijv. een minimumleeftijd), kan de klant gedwongen worden om in te loggen op zijn "myPaysafe" account om zijn gegevens te verifiëren (bijv. om zijn leeftijd te controleren). Raadpleeg voor meer informatie paysafecard 's eigen bronnen (link naar externe site).

 

Indien succesvolle authenticatie

De browser van de klant wordt doorgestuurd naar de returnurl gespecificeerd in het ORDER verzoek.

  De betaling is pas voltooid als u het hieronder beschreven AUTH verzoek met succes hebt verwerkt.

U moet wachten tot de klant terugkeert van paysafecard naar de returnurl gehost op uw servers alvorens verder te gaan.

 

Als de klant annuleert

De klant kan annuleren door op het kruisje rechtsboven te klikken. Hierdoor wordt de browser van de klant omgeleid naar de cancelurl gespecificeerd in het ORDER verzoek. U kunt dan alternatieve betalingswijzen opgeven. Als de klant het opnieuw wil proberen met paysafecard, moet u opnieuw beginnen door een nieuw ORDER Verzoek in te dienen.

  Bij het testen krijgt u de sandbox te zien die door paysafecard ter beschikking wordt gesteld. Om een testtransactie te voltooien, moet u de instructies op het scherm volgen. Neem contact op met uw accountmanager voor testgegevens die u in de zandbak kunt invoeren.

 

3. Het verwerken van de authorisaties

  Als de klant wordt doorverwezen naar de cancelurl:

Stel uw klant alternatieve betaalmethoden voor zodat hij het opnieuw kan proberen.

  Als de klant wordt doorverwezen naar de returnurl:

Volg de onderstaande instructies.

 

AUTH verzoekvoorbeeld

Dit voorbeeld laat zien hoe een AUTH verzoek voor paysafecard wordt verwerkt.

Python PHP cURL Ruwe JSON Ruwe XML
#!/usr/bin/python
import securetrading

stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)

auth = {
"requesttypedescription": "AUTH",
"sitereference": "test_site12345",
"parenttransactionreference": "72-32-20002",
"paymenttypedescription": "PAYSAFECARD"
}

strequest = securetrading.Request()
strequest.update(auth)
stresponse = st.process(strequest) #stresponse contains the transaction response

Vervang <DOMAIN> met een ondersteund domein. Klik hier voor een volledige lijst.

 

Specificatie veld

  Veld Formaat Beschrijving
X1-EN.png parenttransactionreference
XPath: /operation/parenttransactionreference
Alfanumeriek
en koppeltekens (25)
Dien in het verzoek de transactionreference van de voorgaande ORDER.
X1-EN.png paymenttypedescription
XPath: /billing/payment/@type
Alpha (20) Deze waarde moet worden ingediend als "PAYSAFECARD".
X1-EN.png requesttypedescription
XPath: /@type
Alpha (20) De waarde in het verzoek moet "AUTH" zijn.
X1-EN.png sitereference
XPath: /operation/sitereference
Alfanumeriek
& underscore (50)
De site referentie heeft betrekking op uw individuele account die u bij de installatie hebt ontvangen. Als u uw site referentie niet kent, neem dan contact op met ons Support Team.

 

AUTH antwoordvoorbeeld

Hier is een voorbeeld van een AUTH antwoord voor paysafecard.

Python PHP Ruwe JSON Ruwe XML
{
u 'requestreference': u 'A0dcb11e6',
u 'version': u '1.00',
u 'responses': [{
u 'transactionreference': u '72-32-20004',
u 'merchantname': u 'Test Merchant',
u 'paymenttypedescription': u 'PAYSAFECARD',
u 'transactionstartedtimestamp': u '2016-12-23 15:36:31',
u 'errormessage': u 'Ok',
u 'parenttransactionreference': u '72-32-20003',
u 'accounttypedescription': u 'ECOM',
u 'errorcode': u '0',
u 'settleduedate': u '2017-05-30',
u 'currencyiso3a': u 'GBP',
u 'baseamount': u '2001',
u 'requesttypedescription': u 'AUTH',
u 'operatorname': u 'webservices@example.com',
u 'livestatus': u '0',
u 'settlestatus': u '0',
u 'paysafeminage': u '18',
u 'paysafekyclevel': u 'SIMPLE',
u 'paysafecountryrestriction': u 'DE',
u 'paysafeid': u '23842'
}]
}

 

Specificatie veld

  Veld Formaat Beschrijving
X4-EN.png accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) De geretourneerde waarde is "ECOM".
X4-EN.png baseamount
XPath: /billing/amount
Numeriek (11) Het bedrag van de transactie in basiseenheden, zonder komma's of decimalen, dus €10 wordt geretourneerd als 1000.
X4-EN.png currencyiso3a
XPath: /billing/amount/@currencycode
Alpha (3) De Munt waarin de transactie werd verwerkt (in ISO3A-formaat).
X4-EN.png errorcode
XPath: /error/code
Numeriek (1-5) De foutcode (errorcode) moet worden gebruikt om te bepalen of het verzoek succesvol was of niet.
  • Als de foutcode "0" is, is de transactie geslaagd.
  • Als de foutcode niet "0" is, was de transactie niet succesvol.

Klik hier voor een volledige lijst van errorcode en berichtwaarden.

X4-EN.png errormessage
XPath: /error/message
Alfanumeriek (255) Dit is het bericht dat overeenkomt met de bovenstaande code.

Klik hier voor een volledige lijst van errorcode en berichtwaarden.

X4-EN.png livestatus
XPath: /live
Numeriek (1)
  • 0 - Transactie verwerkt met een testrekening.
  • 1 - Transactie verwerkt met een live rekening.
X4-EN.png operatorname
XPath: /merchant/operatorname
Alfanumeriek (255) De waarde van dit veld bevat de naam van de gebruiker die het verzoek heeft verwerkt.
X4-EN.png parenttransactionreference
XPath: /operation/parenttransactionreference
Alfanumeriek
en koppeltekens (25)
De transactionreference van de voorgaande ORDER.
X4-EN.png paymenttypedescription
XPath: /billing/payment/@type
Alpha (20) De geretourneerde waarde is "PAYSAFECARD".
X4-EN.png paysafeid
XPath: /paysafe/@id
Alfanumeriek (255) Een unieke id die door paysafecard aan de transactie is toegekend. U kunt deze id's opslaan voor toekomstige correspondentie met paysafecard.
X4-EN.png requesttypedescription
XPath: /@type
Alpha (20) De geretourneerde waarde is "AUTH".
X4-EN.png settleduedate
XPath: /settlement/settleduedate
Datum JJJJ-MM-DD De datum waarop de transactie zal worden afgewikkeld.
X4-EN.png settlestatus
XPath: /settlement/settlestatus
Numeriek (3)
  • "100" betekent dat de middelen onmiddellijk worden vastgelegd.
  • "3" geeft aan dat het verzoek niet succesvol was.
X4-EN.png transactionreference
XPath: /transactionreference
Alfanumeriek, inclusief
koppeltekens (25)
Een unieke referentie voor de transactie, toegewezen door Trust Payments.
X4-EN.png transactionstartedtimestamp
XPath: /timestamp
Datum tijd JJJJ-MM-DD hh:mm:ss Het tijdstip waarop de transactie werd verwerkt.
X2-EN.png errordata
XPath: /error/data
Alfanumeriek (255)

Aanvullende informatie om te helpen bij het oplossen van de fout.

Wordt alleen geretourneerd als er een fout is opgetreden.

X2-EN.png merchantname
XPath: /merchant/merchantname
Alfanumeriek (255) Dit zijn gegevens die verband houden met de rekening die is gebruikt om de transactie te verwerken.

Als u deze velden wilt wijzigen, neem dan contact op met ons Support Team.

Hangt af van uw account configuratie.

X2-EN.png paysafecountryrestriction
XPath: /billing/payment/paysafe/countryrestriction
Alpha (2) Beperkt de verwerking van de betaling tot uitsluitend het opgegeven land (in iso2a-formaat).

bijv. "GB" voor Verenigd Koninkrijk.

Klik hier voor een volledige lijst van landcodes.

Teruggestuurd indien ingediend in het ORDER verzoek.

X2-EN.png paysafekyclevel
XPath: /billing/payment/paysafe/kyclevel
Alfa (6)

Specificeert het vereiste KYC-niveau voor de rekeninghouder "myPaysafe". Er zijn twee niveaus:

  • "SIMPLE" - De klant heeft het eerste registratieproces succesvol afgerond en zijn mobiele nummer en e-mailadres bevestigd.
  • "FULL" - Naast het bovenstaande heeft de klant ook een identificatiebewijs (bv. paspoort, rijbewijs) en een bewijs van adres (bv. rekening van een nutsbedrijf) verstrekt.

Teruggestuurd indien ingediend in het ORDER verzoek.

X2-EN.png paysafeminage
XPath: /billing/payment/paysafe/minage
Numeriek (3)

De minimumleeftijd van de "myPaysafe" rekeninghouder, zoals gespecificeerd in de ORDER aanvraag.

Teruggestuurd indien ingediend in het ORDER verzoek.

 

Meldingen

Voordat u begint met testen, raden wij u aan contact op te nemen met ons Support Team en te verzoeken dat op uw account regels worden ingeschakeld die URL-kennisgevingen naar uw systeem sturen wanneer een betaling is geautoriseerd.

 

De kennisgeving configureren

Wij raden aan ten minste de volgende velden op te nemen in URL-kennisgevingen die worden verzonden op autorisatie:

  • Basisbedrag (baseamount) (bijv. 10,50 pond is "1050")*.
  • Hoofdbedrag (mainamount) (bijv. 10,50 pond is "10,50")*.
  • Land facturatie (billingcountryiso2a)
  • Munt (currencyiso3a)
  • Foutcode (errorcode)
  • Live Status (livestatus)
  • Bestelreferentie (orderreference)
  • Betalingstype (paymenttypedescription)
  • Verzoektype (requesttypedescription)
  • Status betaling (settlestatus)
  • Site referentie (sitereference)
  • Transactiereferentie (transactionreference)
  • Tijdstempel start transactie (transactionstartedtimestamp)

*Kies uw voorkeursformaat.

 

Controleer de kennisgeving

U moet de inhoud van elke ontvangen kennisgeving controleren en dienovereenkomstig reageren door de in onze URL-kennisgevingen documentatie. In het bijzonder moet u kijken naar de settlestatus waarde:

  • Als de settlestatus "100" is, betekent dit dat de betaling is goedgekeurd en het geld op uw rekening is gestort.
  • Als alternatief, als de settlestatus "3" is, betekent dit dat er een fout is opgetreden en dat de betaling is geannuleerd. U kunt de errorcode om de oorzaak van de fout te bepalen.

 

Afwikkeling

Als de verzoeken succesvol waren, worden de fondsen onmiddellijk verrekend nadat de klant de betaling heeft voltooid. U kunt paysafecard transacties niet meer annuleren of anderszins bijwerken nadat u het AUTH verzoek heeft ingediend.

 

Payouts

Je kunt Payout verzoeken verwerken met de Webservices API om geld over te maken naar de "myPaysafe" rekening van de klant.

  U moet een paysafecard CFT Merchant Number gekoppeld hebben aan uw Trust Payments account. Als u niet zeker weet of uw handelaarsnummer dit ondersteunt, raden wij u aan contact op te nemen met paysafecard voor opheldering. Zorg er bovendien voor dat u de richtlijnen van paysafecard volgt voordat u verder gaat.

Er zijn twee methoden om de rekening van de klant in het verzoek te identificeren. U kunt ervoor kiezen een van beide in te dienen:

  • customeraccountnumber en customeraccountnumbertype (zoals in de onderstaande voorbeelden)
  • OF de billingemail

  Na een succesvolle Payout wordt het geld onmiddellijk overgemaakt naar de "myPaysafe" rekening van de klant. U kunt niet annuleren of anderszins paysafecard Payouts bijwerken na afwikkeling.

Raadpleeg de onderstaande voorbeelden en het veldschema om te leren hoe je een Payout verzoek naar Trust Payments opstelt en wat je in het antwoord kunt verwachten.

 

Payout verzoekvoorbeeld

Dit voorbeeld laat zien hoe een Payout verzoek voor paysafecard wordt verwerkt.

Python PHP cURL Ruwe JSON Ruwe XML
#!/usr/bin/python
import securetrading

stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)

auth = {
"requesttypedescription": "REFUND",
"sitereference": "test_site12345",
"accounttypedescription": "CFT",
"billingid": "000001",
"currencyiso3a": "GBP",
"baseamount": "2001",
"paymenttypedescription": "PAYSAFECARD",
"billingdob": "2012-01-26",
"billingfirstname": "Joe",
"billinglastname": "Bloggs",
"customeraccountnumbertype": "ACCOUNT",
"customeraccountnumber": "123456789012"
}

strequest = securetrading.Request()
strequest.update(auth)
stresponse = st.process(strequest) #stresponse contains the transaction response

Vervang <DOMAIN> met een ondersteund domein. Klik hier voor een volledige lijst.

 

Specificatie veld

  Veld Formaat Beschrijving
X1-EN.png accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) De waarde in het verzoek moet "CFT" zijn.
X1-EN.png baseamount
XPath: /billing/amount
Numeriek (11)

Het bedrag van de Payout in basiseenheden, zonder komma's of decimalen, dus €10 wordt ingediend als 1000. Deze waarde moet groter zijn dan nul.

X1-EN.png billingdob
XPath: /billing/dob
Datum JJJJ-MM-DD Geboortedatum van de klant.
X1-EN.png billingfirstname
XPath: /billing/name/first
Alfanumeriek, inclusief
symbolen (127)
Voornaam van de klant.
X1-EN.png billingid
XPath: /billing/@id
Alfanumeriek (100) Een door u opgegeven id, gebruikt om de klant te identificeren.

 U moet altijd een billingid:

  • Aan elke klant moet een unieke id worden toegekend.
  • Dit id moet opnieuw worden gebruikt door terugkerende klanten.
X1-EN.png billinglastname
XPath: /billing/name/last
Alfanumeriek, inclusief
symbolen (127)
Achternaam van de klant.
X1-EN.png currencyiso3a
XPath: /billing/amount/@currencycode
Alpha (3)

De Munt waarin de transactie zal worden verwerkt (in ISO3A-formaat).

Voor een lijst van Munt codes die worden ondersteund door paysafecard, zie de lijst bovenaan deze pagina.

X1-EN.png paymenttypedescription
XPath: /billing/payment/@type
Alpha (20) Deze waarde moet worden ingediend als "PAYSAFECARD".
X1-EN.png requesttypedescription
XPath: /@type
Alpha (20) De waarde in het verzoek moet "REFUND" zijn.
X1-EN.png sitereference
XPath: /operation/sitereference
Alfanumeriek
& underscore (50)
De site referentie heeft betrekking op uw individuele account die u bij de installatie hebt ontvangen. Als u uw site referentie niet kent, neem dan contact op met ons Support Team.
X2-EN.png billingemail
XPath: /billing/email
E-mail (255)

Dit moet het e-mailadres zijn dat de klant heeft gebruikt om zich te registreren voor "myPaysafe".

Vereist indien customeraccountnumber en customeraccountnumbertype niet ingediend.

X2-EN.png customeraccountnumber
XPath: /customer/accountnumber
Numeriek (12)

Id van de "myPaysafe" account van de klant.

Vereist indien billingemail niet ingediend.

X2-EN.png customeraccountnumbertype
XPath: /customer/accountnumber/@type
Alfa (7)

De waarde in het verzoek moet "ACCOUNT" zijn.

Vereist indien billingemail niet ingediend.

 

Payout antwoordvoorbeeld

Hier is een voorbeeld van een geslaagd Payout antwoord voor paysafecard.

Python PHP Ruwe JSON Ruwe XML
{
u 'requestreference': u 'A0dcb11e6',
u 'version': u '1.00',
u 'responses': [{
u 'requesttypedescription': u 'REFUND',
u 'acquirertransactionreference': u '1234-5678-9012-3456',
u 'baseamount': u '2001',
u 'currencyiso3a': u 'GBP',
u 'paymenttypedescription': u 'PAYSAFECARD',
u 'customeraccountnumbertype': u 'ACCOUNT',
u 'maskedcustomeraccountnumber': u '123456##9012',
u 'errorcode': u '0',
u 'errormessage': u 'Ok',
u 'livestatus': u '0',
u 'merchantname': u 'Test Merchant',
u 'merchantnumber': u '00000000',
u 'operatorname': u 'webservices@example.com',
u 'accounttypedescription': u 'CFT',
u 'paysafeid': u '23843',
u 'settleduedate': u '2022-02-08',
u 'settlestatus': u '100',
u 'transactionstartedtimestamp': u '2022-02-08 14:39:18',
u 'transactionreference': u '1-2-347'
}]
}

 

Specificatie veld

  Veld Formaat Beschrijving
X4-EN.png accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) De geretourneerde waarde is "CFT".
X4-EN.png acquirertransactionreference
XPath: /acquirertransactionreference
Alfanumeriek, inclusief symbolen (127) Unieke Transactiereferentie toegewezen door paysafecard.
X4-EN.png baseamount
XPath: /billing/amount
Numeriek (11) Het bedrag van de Payout in basiseenheden, zonder komma's of decimalen, dus €10 wordt geretourneerd als 1000.
X4-EN.png currencyiso3a
XPath: /billing/amount/@currencycode
Alpha (3) De Munt waarin de transactie werd verwerkt (in ISO3A-formaat).
X4-EN.png errorcode
XPath: /error/code
Numeriek (1-5) De foutcode (errorcode) moet worden gebruikt om te bepalen of het verzoek succesvol was of niet.
  • Als de foutcode "0" is, is de transactie geslaagd.
  • Als de foutcode niet "0" is, was de transactie niet succesvol.

Klik hier voor een volledige lijst van errorcode en berichtwaarden.

X4-EN.png errormessage
XPath: /error/message
Alfanumeriek (255) Dit is het bericht dat overeenkomt met de bovenstaande code.

Klik hier voor een volledige lijst van errorcode en berichtwaarden.

X4-EN.png livestatus
XPath: /live
Numeriek (1)
  • 0 - Transactie verwerkt met een testrekening.
  • 1 - Transactie verwerkt met een live rekening.
X4-EN.png operatorname
XPath: /merchant/operatorname
Alfanumeriek (255) De waarde van dit veld bevat de naam van de gebruiker die het verzoek heeft verwerkt.
X4-EN.png paymenttypedescription
XPath: /billing/payment/@type
Alpha (20) De geretourneerde waarde is "PAYSAFECARD".
X4-EN.png paysafeid
XPath: /paysafe/@id
Alfanumeriek (255) Een unieke id die door paysafecard aan de transactie is toegekend. U kunt deze id's opslaan voor toekomstige correspondentie met paysafecard.
X4-EN.png requesttypedescription
XPath: /@type
Alpha (20) De teruggezonden waarde is "REFUND".
X4-EN.png settleduedate
XPath: /settlement/settleduedate
Datum JJJJ-MM-DD De datum waarop de transactie zal worden afgewikkeld.
X4-EN.png settlestatus
XPath: /settlement/settlestatus
Numeriek (3)
  • "100" betekent dat de middelen onmiddellijk worden vastgelegd.
  • "3" geeft aan dat het verzoek niet succesvol was.
X4-EN.png transactionreference
XPath: /transactionreference
Alfanumeriek, inclusief
koppeltekens (25)
Een unieke referentie voor de transactie, toegewezen door Trust Payments.
X4-EN.png transactionstartedtimestamp
XPath: /timestamp
Datum tijd JJJJ-MM-DD hh:mm:ss Het tijdstip waarop de transactie werd verwerkt.
X2-EN.png customeraccountnumbertype
XPath: /customer/accountnumber/@type
Alfa (7)

De geretourneerde waarde is "ACCOUNT".

Wordt alleen geretourneerd indien ingediend in het verzoek.

X2-EN.png errordata
XPath: /error/data
Alfanumeriek (255)

Aanvullende informatie om te helpen bij het oplossen van de fout.

Wordt alleen geretourneerd als er een fout is opgetreden.

X2-EN.png maskedcustomeraccountnumber
XPath: /customer/accountnumber
Numeriek & # (20)

Gemaskeerde id van de "myPaysafe" account van de klant.

Wordt alleen geretourneerd indien ingediend in het verzoek.

X2-EN.png merchantname
XPath: /merchant/merchantname
Alfanumeriek (255) Dit zijn gegevens die verband houden met de rekening die is gebruikt om de transactie te verwerken.

Als u deze velden wilt wijzigen, neem dan contact op met ons Support Team.

Hangt af van uw account configuratie.

X2-EN.png merchantnumber
XPath: /merchant/merchantnumber
Alfanumeriek (32)

Het handelaarsnummer dat werd gebruikt om de transactie te verwerken. Verstrekt door de wervende bank.

Hangt af van uw account configuratie.

 

Aanvullende opmerkingen

Fraudepreventie

Fraude en dubbele controles

Fraude- en duplicaatcontroles worden niet uitgevoerd op paysafecard transacties.

 

Adres Verificatie Service (AVS) controles

AVS controles kunnen niet worden uitgevoerd op paysafecard transacties.

 

Geblokkeerde kaarten

paysafecards kunnen worden geblokkeerd om alle verdere aankopen op verzoek van de klant te voorkomen.

Klik hier voor meer informatie (link naar externe site).

 

Als de klant zijn PIN-code niet invoert

Na het uitvoeren van het verzoek ORDER en het ontvangen van een succesvol antwoord, heeft de klant 30 minuten om zijn betalingsgegevens in te voeren op de website paysafecard, waarna de betaling door paysafecard als "vervallen" wordt gemarkeerd en de klant opnieuw moet beginnen met een nieuwe ORDER.

 

Type rekening

Alleen "ECOM" (e-commerce) wordt ondersteund als rekeningtype voor paysafecard transacties. De klant moet bij de aankoop aanwezig zijn om zijn PIN-code in te voeren of om zich aan te melden op zijn rekening.

 

iframes

De paysafecard-gehoste pagina kan worden gehost in een iframe.

Sta altijd verticaal scrollen of dynamische grootte toe. Maximale hoogte van 840px.

De paysafecard-betaalpagina wordt automatisch geoptimaliseerd voor mobiele apparaten.

Als een klant een apparaat gebruikt met een resolutie met een kleinere breedte dan 600px, wordt automatisch een voor mobiele apparaten geoptimaliseerd betalingspaneel getoond. Dit is ook het geval als de ingesloten iframe een kleinere breedte heeft dan 600px.

Was dit artikel nuttig?
0 van de 0 vonden dit nuttig