Express Checkout Shortcut (ECS)

  Laatst bijgewerkt: 

 

PayPal is een internationaal e-commerce bedrijf dat online betalingen en overschrijvingen mogelijk maakt.

Express Checkout Shortcut (ECS): Klanten klikken op de knop "PayPal Betalen" op uw website en worden omgeleid naar de servers van PayPal.

  Ondersteunde landen   Geen beperkingen voor landen van de klant.
  Ondersteunde munteenheden   AUD, CAD, EUR, GBP, JPY, USD
  Terugbetalingen

  Volledige en gedeeltelijke terugbetaling toegestaan.

  Terugboekingen

  Geschillen worden beheerd door PayPal.

  Zero-authorisation

  Niet ondersteund.

  Terugkerende betalingen

  Niet ondersteund.

  Voordelen van de uitvoering ECS

  • De klant hoeft zijn afleveradres niet in te typen. Hij kan de gegevens gebruiken die zijn opgeslagen op zijn PayPal account.
  • Het vereenvoudigen van de checkout-ervaring kan zowel uw online als mobiele conversie verhogen.
  • Hiermee kunt u leveringskosten toevoegen aan de transactie, die kunnen verschillen op basis van het leveringsadres dat de klant heeft geselecteerd op PayPal.

 

Procesoverzicht

Wat zal de klant zien?

  • Op uw winkelwagenpagina biedt uw website de klant de mogelijkheid om af te rekenen via PayPal.
  • De klant klikt op de knop en wordt doorgestuurd naar PayPal, waar hij zich aanmeldt met zijn PayPal-gegevens (hij kan zich bij PayPal registreren als hij nog geen rekening heeft).
  • De klant kiest op de website van PayPal het leveringsadres en de betalingswijze van zijn voorkeur.
  • De klant wordt teruggeleid naar uw website, waar u extra leveringskosten kunt toevoegen en een eindoverzicht met het totaalbedrag kunt weergeven.
  • De klant gaat akkoord met de betaling op uw website en krijgt een aankoopbevestiging te zien.

CW27-NL.png

Hoe werkt het achter de schermen?

  1. Initieer de klant
    • De klant gaat akkoord met een betaling via PayPal 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 paypaltoken en redirecturl.

  2. Doorverwijzen naar PayPal
    • De Merchant leidt de browser van de klant door naar de redirecturl, met inbegrip van de paypaltoken.
    • De klant meldt zich aan en gaat akkoord met de betaling via zijn PayPal-account.
    • Als dit lukt, wordt de browser van de klant omgeleid naar de returnurl.
    • Als de PayPal-bestelling 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. Bestelgegevens ophalen
    • Alleen als het bovenstaande is gelukt, dient de verkoper een ORDERDETAILS verzoek in om de transactiegegevens van PayPal op te halen.
    • Merchant ontvangt het antwoord ORDERDETAILS en gebruikt dit om een besteloverzicht weer te geven aan de klant.

  4. Verwerk de autorisatie
    • Als de klant akkoord gaat met de aankoop op je website, 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.

  5. Voltooiing van de betaling
    • Bij standaardgedrag is de transactie in behandeling en worden fondsen doorgaans binnen 24 uur vereffend.

    • Maar indien gewenst kunnen winkeliers hun instellingen zo configureren dat ze in plaats daarvan verzoeken om onmiddellijke betaling. Als alternatief kan afwikkeling tot 7 dagen worden uitgesteld.

    • Een URL-kennisgeving kan worden geconfigureerd om het systeem van de winkelier bij te werken zodra afwikkeling is voltooid. Klik hier voor meer informatie.

 

1. Initieer de klant

U moet de klant de mogelijkheid bieden om met PayPal af te rekenen.

  PayPal weergeven op uw kassa

PayPal biedt een knop die u aan uw website kunt toevoegen, samen met richtlijnen en hoe deze moet worden gebruikt.
Klik hier om de nieuwste officiële "PayPal Betalen"-knoppen te downloaden (link naar externe site).

CW32.png

De knop "PayPal Betalen" moet de klant rechtstreeks naar PayPal leiden, zonder afwijkingen of tussenstappen, en daarna terugkeren naar je website. De klant mag niet verplicht worden om zich voor de aankoop aan te melden bij een winkelaccount. Bovendien moet de knop

  • Wordt direct onder of naast elk van uw eigen kassa-knoppen geplaatst.
  • Boven de vouw worden geplaatst (zichtbaar zonder te hoeven scrollen).
  • Heb alternatieve tekst "Afrekenen met PayPal" voor gevallen waarin de afbeelding niet wordt geladen in de browser van de klant.

Deze richtlijnen zijn opgesteld door PayPal en kunnen worden gewijzigd.

Als de klant op de knop "PayPal Betalen" klikt, moet je systeem een ORDER -verzoek uitvoeren en het 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": "PAYPAL",
"returnurl": "https://yourwebsite.com",
"cancelurl": "https://yourwebsite.com",
"paypallocale": "GB",
"paypaladdressoverride": "1",
"paypalemail": "billing@email.com"
}

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. (De maximumlengte kan variëren, afhankelijk van uw wervende bank - Neem contact op met uw bank voor meer informatie)
X1-EN.png cancelurl
XPath: /merchant/cancelurl
URL (2048) De URL waar de klant naar terugkeert als hij de autorisatie op zijn PayPal-rekening annuleert.
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 door PayPal worden ondersteund, zie de lijst bovenaan deze pagina.

X2-EN.png customerprefixname
XPath: /customer/name/prefix
Alfanumeriek, inclusief symbolen (25)

Het voorvoegsel van de factuurnaam van de klant (bv. De heer, Juffrouw, Dr.).

Ten minste één van de velden met de naam van de klant moet worden ingediend als paypaladdressoverride is ingesteld op "0" of "1". Anders zijn deze velden facultatief.

customerfirstname
XPath: /customer/name/first
Alfanumeriek, inclusief symbolen (127)

De klant Voornaam facturatie.

Ten minste één van de velden met de naam van de klant moet worden ingediend als paypaladdressoverride is ingesteld op "0" of "1". Anders zijn deze velden facultatief.

customermiddlename
XPath: /customer/name/middle
Alfanumeriek, inclusief symbolen (127)

De middelste factureringsnaam of -namen van de klant.

Ten minste één van de velden met de naam van de klant moet worden ingediend als paypaladdressoverride is ingesteld op "0" of "1". Anders zijn deze velden facultatief.

customerlastname
XPath: /customer/name/last
Alfanumeriek, inclusief symbolen (127)

De klant Achternaam facturatie.

Ten minste één van de velden met de naam van de klant moet worden ingediend als paypaladdressoverride is ingesteld op "0" of "1". Anders zijn deze velden facultatief.

customersuffixname
XPath: /customer/name/suffix
Alfanumeriek, inclusief symbolen (25)

De achtervoegselnaam van de klant (bv. Bsc).

Ten minste één van de velden met de naam van de klant moet worden ingediend als paypaladdressoverride is ingesteld op "0" of "1". Anders zijn deze velden facultatief.

X2-EN.png customerpremise
XPath: /customer/premise
Alfanumeriek, inclusief symbolen (25)

De naam of het nummer van het huis van de klant.

Deze klantadresvelden zijn verplicht als paypaladdressoverride is ingesteld op "0" of "1". Anders zijn deze velden facultatief.

customertown
XPath: /customer/town
Alfanumeriek, inclusief symbolen (127)

De stad van de klant.

Deze klantadresvelden zijn verplicht als paypaladdressoverride is ingesteld op "0" of "1". Anders zijn deze velden facultatief.

customercountryiso2a
XPath: /customer/country
Alpha (2)

Het land van de klant. Dit moet in ISO2A-formaat zijn. Klik hier voor een volledige lijst van landcodes.

Deze klantadresvelden zijn verplicht als paypaladdressoverride is ingesteld op "0" of "1". Anders zijn deze velden facultatief.

X3-EN.png customerstreet
XPath: /customer/street
Alfanumeriek, inclusief symbolen (127) De straatnaam van de klant.
X2-EN.png customercounty
XPath: /customer/county
Alfanumeriek, inclusief symbolen (127)

De provincie van de klant. Voor adressen in de VS kan de staat in dit veld worden ingevuld. Geldige formaten:

  • Bij voorkeur: Toestandscode van twee tekens, bijv. "NY".
  • Volledige naam van de staat, bijv. "New York".

Vereist indien customercountryiso2a is een van de volgende: AR, BR, CA, CN, ID, IN, IT, JP, MX, TH, US

X3-EN.png customerpostcode
XPath: /customer/postcode
Alfanumeriek (25) De postcode of het postnummer van de klant.

Dit moet een geldige postcode zijn voor de customercountryiso2a ingediend.

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 kan worden opgeslagen op Trust Payments en het systeem van PayPal (dit is uw PayPal-factuur-ID).

Zorg ervoor dat de bestelreferentie uniek is voor elke bestelling.

X1-EN.png paymenttypedescription
XPath: /billing/payment/@type
Alpha (20) Deze waarde moet worden opgegeven als "PAYPAL".
X1-EN.png paypaladdressoverride
XPath: /billing/payment/paypaladdressoverride
Numeriek (1)

Hiermee kunt u het door de klant bij PayPal gekozen afleveradres overschrijven:

  • 0 - De klant krijgt de keuze tussen het op uw website ingevoerde afleveradres en de adressen op zijn PayPal account.
  • 1 - De klant gebruikt het op uw website ingevoerde leveringsadres.
  • 2 - De klant wordt niet gevraagd een leveringsadres te kiezen op PayPal's website (het meest geschikt voor online diensten en downloads).
X3-EN.png paypalemail
XPath: /billing/payment/paypalemail
E-mail (255) Het e-mailadres waarmee de klant zich aanmeldt bij PayPal. Maximaal 64 tekens toegestaan vóór het @-symbool.
X3-EN.png paypallocale
XPath: /billing/payment/locale
Alpha (2) De taal van de PayPal-inlogpagina.

  Klik hier voor een lijst van PayPal-locaties (link naar externe site).

X3-EN.png paypalmaxbaseamount
XPath: /billing/payment/paypalmaxbaseamount
Numeriek (11) Het verwachte maximale totaalbedrag van de complete bestelling, inclusief verzendkosten en belasting. PayPal gebruikt deze waarde om de financieringsbron van de koper te valideren. Moet in basiseenheden zijn. Meer informatie over dit veld vindt u in de specificatie van PayPal zelf.
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 een succesvolle autorisatie op zijn PayPal-rekening.
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.

 

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 'PAYPAL',
u 'settleduedate': u '2020-06-01',
u 'transactionstartedtimestamp': u '2020-06-01 15:35:40',
u 'errormessage': u 'Ok',
u 'accounttypedescription': u 'ECOM',
u 'errorcode': u '0',
u 'redirecturl': u 'https://webapp.securetrading.net/cgi-bin/webscr?token=72x32x20002&useraction=commit&cmd=_express-checkout&paypalemail=billing%40email.com',
u 'requesttypedescription': u 'ORDER',
u 'settlestatus': u '0',
u 'operatorname': u 'webservices@example.com',
u 'livestatus': u '0',
u 'paypaltoken': u '72x32x20002'
}]
}

 

Specificatie veld

  Veld Formaat Beschrijving
X4-EN.png accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) De geretourneerde waarde is "ECOM".
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.

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.

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 teruggezonden waarde is "PAYPAL".
X4-EN.png paypaltoken
XPath: /paypal/token
Alfanumeriek (255) Het token heeft betrekking op de sessie van de klant in het systeem van PayPal. U moet dit registreren, omdat u het dan kunt gebruiken in verband met eventuele relevante vragen aan PayPal.
X4-EN.png redirecturl
XPath: /paypal/redirecturl
URL (255) Stuur de browser van de klant door naar deze URL, zodat hij zich kan aanmelden bij zijn PayPal-rekening.
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.
X4-EN.png transactionstartedtimestamp
XPath: /timestamp
Datum tijd JJJJ-MM-DD hh:mm:ss Het tijdstip waarop het verzoek is verwerkt.

  Aanvullende opmerkingen over ORDER verzoeken

  • De naam van de klant, het adres van de klant, de stad en het land van de klant zijn vereist bij gebruik van paypaladdressoverride opties "0" of "1".
  • Wanneer PayPal een transactie weigert terwijl de klant zich op hun servers bevindt, verschijnt er een bericht op het scherm. De klant kan worden gevraagd het opnieuw te proberen of de betalingspoging te annuleren.
  • U kunt uw PayPal-rekening zo configureren dat de controle op dubbele factuur-ID's (waarden die zijn ingediend in de orderreference). Neem contact op met PayPal Support voor meer informatie.

 

2. Doorverwijzen naar PayPal

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

Bij het testen wordt onze gesimuleerde PayPal-inlogpagina (zoals hieronder getoond) getoond in plaats van een echte PayPal-inlogpagina.

Na het inloggen op hun PayPal-rekening heeft de klant de optie om door te gaan met de transactie of deze te annuleren. Bij het testen kunt u dit nabootsen door een van de onderstaande e-mails te gebruiken op ons test PayPal inlogscherm.

E-mailadres Scenario Resultaat
auth@auth.com De klant voert een succesvolle transactie uit. De browser van de klant wordt omgeleid naar de URL die is opgegeven in de returnurl die werd ingediend in het ORDER verzoek.
cancel@cancel.com De klant kiest ervoor om de transactie te annuleren. De browser van de klant wordt omgeleid naar de URL die is opgegeven in de cancelurl die werd ingediend in het ORDER verzoek.

  U moet wachten tot de klant terugkeert van de PayPal-loginpagina naar de returnurl gehost op uw servers alvorens een autorisatie te verwerken.

CW33-NL.png

 

3. Bestelgegevens ophalen

  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.

 

ORDERDETAILS verzoekvoorbeeld

Hier is een voorbeeld van een ORDERDETAILS verzoek. Dit verzoek haalt de adresgegevens op die de klant heeft ingevoerd op de servers van PayPal, en stuurt deze terug in een antwoord op ORDERDETAILS .

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)

orderdetails = {
"requesttypedescription": "ORDERDETAILS",
"sitereference": "test_site12345",
"parenttransactionreference": "72-32-20002"
}

strequest = securetrading.Request()
strequest.update(orderdetails)
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 de transactionreference van het voorgaande ORDER antwoord. Dit komt van de redirect van PayPal.
X1-EN.png requesttypedescription
XPath: /@type
Alpha (20) De waarde in het verzoek moet "ORDERDETAILS" 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.

 

ORDERDETAILS antwoord 

U moet de informatie in het antwoord op ORDERDETAILS gebruiken om de klant op uw website een pagina te tonen met een samenvatting van de bestelling. De klant kan deze pagina gebruiken om zijn bestelling te bekijken en te bevestigen dat hij wil doorgaan, in welk geval uw systeem een AUTH verzoek indient, zoals hieronder beschreven.

  Richtsnoeren voor beste praktijken

  • De klant moet de aankoop in twee of minder stappen kunnen voltooien nadat hij vanaf de PayPal-afrekenpagina's naar uw website is doorverwezen.
  • De klant mag niet worden verplicht om handmatig aanvullende informatie in te voeren op de beoordelingspagina die beschikbaar is via de PayPal API's.

Op de voornoemde bestelpagina moet de volgende informatie aan de klant worden gepresenteerd alvorens de aankoop te voltooien:

  • PayPal als geselecteerde betalingsmethode.
  • Afleveradres en e-mailadres van PayPal (te vinden in het antwoord op ORDERDETAILS).
  • Het totale door de klant te betalen bedrag, inclusief eventuele extra leveringskosten die aan het oorspronkelijke transactiebedrag worden toegevoegd (indien van toepassing). Zie hieronder voor meer informatie over leveringskosten.

  Over de verzendkosten

Zodra uw systeem het antwoord op ORDERDETAILS heeft ontvangen, zou u nu in het bezit moeten zijn van het leveringsadres van de klant (als u een fysiek product wilt verzenden). Op dit punt mag u een leveringskost toevoegen aan de transactiekost.

Ongeacht eventuele leveringskosten moet u de totale kosten aan de klant presenteren en hij moet akkoord gaan met dit eindbedrag voordat de betaling wordt verwerkt. Wij raden u aan de kosten van het product of de producten te scheiden van de leveringskosten, zodat de klant beter begrijpt hoe het bedrag is berekend.

Zodra de klant akkoord gaat met de betaling, kan uw systeem een AUTH verzoek verwerken met dit definitieve bedrag dat in het baseamount veld (zoals hieronder beschreven). Dit totale bedrag, inclusief eventuele extra leveringskosten, mag niet hoger zijn dan het paypalmaxbaseamount waarde (indien ingediend in het ORDER verzoek).

De extra kosten voor de levering worden door u bepaald. In het algemeen zijn er drie manieren om de leveringskosten te berekenen:

  1. Gratis levering - U kiest ervoor geen extra kosten toe te voegen aan de kosten van het product en uw bedrijf dekt de kosten van de levering.
  2. Vaste leveringsprijs - U kiest ervoor om aan elke bestelling dezelfde leveringskosten toe te voegen. Dit werkt het best als u ervoor zorgt dat de genoemde kosten dezelfde waarde hebben als de gemiddelde leveringskosten over al uw bestellingen.
  3. De exacte kosten in rekening brengen (met realtime tarieven) - Nu u het leveringsadres van de klant en de omvang en het gewicht van de levering hebt, kunt u contact opnemen met uw verzendpartner en de exacte leveringskosten berekenen en deze aan de klant presenteren voordat u de betaling afrondt.

Hier is een voorbeeld van een reactie op ORDERDETAILS :

Python PHP Ruwe JSON Ruwe XML
{
u 'requestreference': u 'A0dcb11e6',
u 'version': u '1.00',
u 'responses': [{
u 'transactionreference': u '72-32-20003',
u 'merchantname': u 'Test Merchant',
u 'billinglastname': u 'PAYPALLastName',
u 'transactionstartedtimestamp': u '2020-06-01 15:36:00',
u 'paypalpayerstatus': u 'verified',
u 'parenttransactionreference': u '72-32-20002',
u 'accounttypedescription': u 'ECOM',
u 'errorcode': u '0',
u 'settleduedate': u '2020-06-01',
u 'billingcountryiso2a': u 'GB',
u 'paypalpayerid': u 'e018408a43pid',
u 'paypaladdressstatus': u 'Confirmed',
u 'billingemail': u 'paypal.email@example.com',
u 'requesttypedescription': u 'ORDERDETAILS',
u 'errormessage': u 'Ok',
u 'billingfirstname': u 'Andru00e9',
u 'operatorname': u 'webservices@example.com',
u 'livestatus': u '0',
u 'settlestatus': u '0'
}]
}

 

Specificatie veld

De volgende tabel beschrijft de belangrijkste velden die in het geretourneerde antwoord moeten worden gecontroleerd:

  Veld Formaat Beschrijving
X4-EN.png accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) De geretourneerde waarde is "ECOM".
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, is de transactie niet geslaagd.

Klik hier voor een volledige lijst van errorcode en berichtwaarden.

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.

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.
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.

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 het voorgaande ORDER antwoord.
X4-EN.png paypaladdressstatus
XPath: /paypal/addressstatus
Alfa (25) De status van het adres bij PayPal. Ofwel "Confirmed" of "Unconfirmed".
X4-EN.png paypalpayerid
XPath: /billing/payment/payerid
Alfanumeriek (255) Unqiue PayPal klantennummer.
X4-EN.png paypalpayerstatus
XPath: /paypal/payerstatus
Alfa (25) De status van de betaler bij PayPal. Of "verified" of "unverified".
X4-EN.png requesttypedescription
XPath: /@type
Alpha (20) De teruggezonden waarde is "ORDERDETAILS".
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.
X4-EN.png transactionstartedtimestamp
XPath: /timestamp
Datum tijd JJJJ-MM-DD hh:mm:ss Het tijdstip waarop het verzoek is verwerkt.

  Aanvullende opmerkingen over ORDERDETAILS reacties

  • De teruggestuurde factuur- en klantgegevens kunnen afwijken van de gegevens die bij het oorspronkelijke verzoek op ORDER zijn verstrekt. Dit kan gebeuren wanneer de klant andere gegevens gebruikt wanneer hij inlogt op de servers van PayPal (en paypaladdressoverride is ingesteld op "0").
  • De teruggezonden PayPal-velden zijn gedefinieerd door PayPal. Deze zijn correct op het moment van schrijven, maar kunnen worden gewijzigd.

 

4. Het verwerken van de autorisatie

Nadat de klant heeft bevestigd dat hij wil doorgaan met de betaling, moet uw systeem een AUTH verzoek uitvoeren en het teruggestuurde antwoord interpreteren.

 

AUTH verzoekvoorbeeld

Hier is een voorbeeld van een PayPal AUTH verzoek. Merk op hoe de structuur lijkt op een standaard AUTH aanvraag, met uitzondering van de uitsluiting van de meeste betalings-, facturerings- en leveringsgegevens, omdat deze zijn overgenomen van de vorige verzoeken. Zorg ervoor dat de parenttransactionreference veld wordt ingediend, met daarin de unieke Transactiereferentie van het voorgaande ORDERDETAILS verzoek.

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-20003",
"paymenttypedescription": "PAYPAL",
"paypaladdressoverride": "1"
}

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 de transactionreference teruggestuurd in het voorgaande ORDERDETAILS antwoord.
X1-EN.png paymenttypedescription
XPath: /billing/payment/@type
Alpha (20) Deze waarde moet worden opgegeven als "PAYPAL".
X1-EN.png paypaladdressoverride
XPath: /billing/payment/paypaladdressoverride
Numeriek (1) Moet dezelfde waarde zijn als in het verzoek op ORDER .
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 volgt een voorbeeld van een PayPal AUTH antwoord. De structuur is vergelijkbaar met een standaard AUTH antwoord, behalve dat er extra PayPal-specifieke velden zijn opgenomen.

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 'PAYPAL',
u 'authcode': u '44782-D149613359266',
u 'transactionstartedtimestamp': u '2020-06-01 15:36:20',
u 'errormessage': u 'Ok',
u 'parenttransactionreference': u '72-32-20003',
u 'accounttypedescription': u 'ECOM',
u 'errorcode': u '0',
u 'settleduedate': u '2020-06-01',
u 'currencyiso3a': u 'GBP',
u 'baseamount': u '2001',
u 'acquirerresponsecode': u 'None',
u 'requesttypedescription': u 'AUTH',
u 'operatorname': u 'webservices@example.com',
u 'livestatus': u '0',
u 'settlestatus': u '0'
}]
}

 

Specificatie veld

   Veld Formaat Beschrijving
X4-EN.png accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) De geretourneerde waarde is "ECOM".
X4-EN.png acquirerresponsecode
XPath: /acquirerresponsecode
Alfanumeriek (255) Gebruikt door uw verwerver om het resultaat van het verzoek aan te geven.
X2-EN.png authcode
XPath: /authcode
Alfanumeriek (255)

De autorisatie code verstrekt door de uitgevende bank.

Wordt alleen geretourneerd als de transactie is toegestaan.

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).

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

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, is de transactie niet geslaagd.

Klik hier voor een volledige lijst van errorcode en berichtwaarden.

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.

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.
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.

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 het voorgaande ORDERDETAILS antwoord.
X4-EN.png paymenttypedescription
XPath: /billing/payment/@type
Alpha (20) De teruggezonden waarde is "PAYPAL".
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) Dit veld wordt gebruikt om de status van de transactie te bepalen. Klik hier voor meer informatie over de settlestatus veld en het afwikkeling proces voor PayPal.
X4-EN.png transactionreference
XPath: /transactionreference
Alfanumeriek, inclusief
koppeltekens (25)
Een unieke referentie voor het verzoek, toegewezen door Trust Payments.
X4-EN.png transactionstartedtimestamp
XPath: /timestamp
Datum tijd JJJJ-MM-DD hh:mm:ss Het tijdstip waarop het verzoek is verwerkt.

U kunt geen tokenisatie uitvoeren met PayPal.

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