PayPal is een internationaal e-commerce bedrijf dat online betalingen en overschrijvingen mogelijk maakt.
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. |
Procesoverzicht
Configuratie
-
Volg de stappen in onze gids PayPal om deze betaalmethode in te schakelen.
- Zodra u het bovenstaande hebt voltooid, moet u uw POST wijzigen in Payment Pages zoals nodig:
Naam van het veld Vereist tijdens betaalsessie
(hetzij opgenomen in POST door handelaar of ingevoerd door klant op Payment Pages)
Vereist in POST Beschrijving customerprefixname Conditioneel Geen Deze leveringsvelden zijn verplicht wanneer paypaladdressoverride 0 of 1 is.
U moet ten minste één van de velden met de naam van de klant opgeven.
Ten minste één van de klantnaamvelden is vereist wanneer paypaladdressoverride 0 of 1 is.
customerfirstname Conditioneel Geen customermiddlename Conditioneel Geen customerlastname Conditioneel Geen customersuffixname Conditioneel Geen customerpremise Conditioneel Geen customertown Conditioneel Geen customercountryiso2a Conditioneel Geen customerpostcode Conditioneel Geen customercounty Conditioneel Geen Het voor het leveringsadres ingevoerde district.
Dit wordt weergegeven als "State code (bijv. NY)" op pagina's met US locale en "County" op andere configuraties.
Voor Amerikaanse adressen wordt de staat in dit veld ingevuld.
Geldige formaten:
- Voorkeur: Staatcode van twee tekens, bijvoorbeeld "NY".
- Volledige naam van de staat (geen afkortingen), bijvoorbeeld "New York".
Vereist indien customercountryiso2a een van de volgende is: AR, BR, CA, CN, ID, IN, IT, JP, MX, TH, US
orderreference Geen Geen Als u het veld bestelreferentie opgeeft, wordt de waarde van dit veld verzonden naar PayPal als factuurnummer. PayPal controleert op dubbele factuurnummers, dus zorg ervoor dat elke bestelreferentie die in de POST wordt opgegeven, uniek is voor elke transactie. Opmerking: U kunt uw PayPal account configureren om de controle op dubbele factuur-id's uit te schakelen. Neem contact op met PayPal Support voor meer informatie.
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.
paypaladdressoverride Geen Geen Standaard selecteert de klant zijn leveringsadres uit zijn PayPal account. Als alternatief kan de klant het op uw website ingevoerde adres gebruiken. Dit gedrag wordt geregeld door het sturen van het paypaladdressoverride veld in de initiële POST naar de Payment Pages te sturen: - 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).
paypallocaleiso2a Geen Geen Gebruik dit veld om de inhoud van de PayPal kassa te lokaliseren. Voor een volledige lijst van ondersteunde waarden die in dit veld kunnen worden opgegeven (bijv. paypallocaleiso2a=GB voor het VK), raadpleeg PayPal 's documentatie (link naar externe site). ruleidentifier Geen Geen Als uw POST naar de Payment Pages al alle door de betaalmethode vereiste velden bevat, kunt u het afrekenproces voor de klant stroomlijnen door ook ruleidentifier=STR-14 in te dienen.
Hierdoor kan de browser van de klant onmiddellijk naar de door de betaalmethode gehoste pagina's gaan om de transactie te voltooien. (Wij noemen dit Journey C)
Om ervoor te zorgen dat de klant het leveringsadres dat is opgegeven op Payment Pages niet kan wijzigen, moeten de bovenstaande velden worden toegevoegd aan de aangewezen velden voor de beveiliging van uw aanvraagsite.
PayPal ondersteunt geen iframe integratie.
Meldingen
Zodra een betaling is goedgekeurd, worden de middelen op een later tijdstip verrekend, zoals bepaald door PayPal.
De afwikkeling kennisgeving mag niet onmiddellijk na de verwerking van de betaling worden verzonden.
In het onwaarschijnlijke geval dat de betaling na 7 dagen nog steeds in behandeling is afwikkeling (settlestatus "10"), wordt dit ingepland voor onderzoek en nemen wij contact met u op met nadere informatie.
U kunt uw site referentie(s) zo laten configureren dat PayPal transacties onmiddellijk worden afgewikkeld.
Neem contact op met ons Support Team voor meer informatie.
Voordat u begint met testen, raden wij u aan contact op te nemen met ons Support Team en te verzoeken dat regels worden ingeschakeld op uw account, die URL-kennisgevingen naar uw systeem sturen in de volgende scenario's:
- Wanneer een betaling is goedgekeurd.
- Als de fondsen vereffend zijn.
Configuratie van de autorisatie melding
Wij raden u aan ten minste de volgende velden op te nemen in uw autorisatie kennisgeving:
- Auth code (authcode)
- Basisbedrag (baseamount) (b.v. €10,50 is "1050")*.
- Hoofdbedrag (mainamount) (b.v. €10,50 is "10.50")*
- Land facturatie (billingcountryiso2a)
- Munt (currencyiso3a)
- Foutcode (errorcode)
- Live Status (livestatus)
- Referentie bestelling (orderreference)
- Betalingstype (paymenttypedescription)
- PayPal E-mail (paypalemail)
- PayPal Payer Id (paypalpayerid)
- Verzoektype (requesttypedescription)
- Status betaling (settlestatus)
- Site referentie (sitereference)
- Transactiereferentie (transactionreference)
- Tijdstempel start transactie (transactionstartedtimestamp)
*Kies uw voorkeursformaat.
Configuratie van de afwikkeling melding
Wij raden u aan de volgende velden op te nemen in uw afwikkeling kennisgeving:
- Status betaling (settlestatus)
- Site referentie (sitereference)
- Transactiereferentie (transactionreference)
Controleer de kennisgeving
U moet de inhoud van elke ontvangen kennisgeving controleren en dienovereenkomstig reageren door de procedures te volgen die in onze URL-kennisgevingen documentatie. In het bijzonder moet u kijken naar de bijgewerkte settlestatus waarde:
- Op autorisatie: Als de settlestatus "0", "1" of "10" is, is de betaling geautoriseerd en hoeft u op dit moment geen verdere actie te ondernemen. Waarden van "2" of "3" geven echter aan dat de fondsen niet gepland voor vereffening (respectievelijk opgeschort en geannuleerd).
- Op afwikkeling: Als de settlestatus is bijgewerkt tot "100", betekent dit dat het geld is vereffend. Als dit is bijgewerkt tot "3", is er een probleem geweest en is de betaling geannuleerd.
Test
U moet uw oplossing testen voordat u live betalingen kunt gaan verwerken. Testtransacties worden verwerkt via uw test site referentie.
Bij het uitvoeren van testtransacties wordt uw browser doorgestuurd naar onze gesimuleerde PayPal afrekenpagina. Volg de instructies op het scherm om een betaling te voltooien, waarna u wordt teruggeleid naar de Payment Pages.
Terugbetalingen
Na het verwerken van een betaling is het mogelijk om de klant terug te betalen via MyST.
Om ervoor te zorgen dat onze gegevens gesynchroniseerd blijven met PayPal, raden wij u ten zeerste aan alleen terugbetalingen uit te voeren via Trust Payments. Voer geen terugbetalingen rechtstreeks uit via uw PayPal admin portal.
Standaard PayPal-terugbetalingen worden onmiddellijk verrekend (settlestatus "100"). Onder bepaalde, door PayPal gedefinieerde voorwaarden kunnen terugbetalingen echter worden ingesteld op settlestatus "10" ("settling"), wat een tussenstap is voorafgaand aan afwikkeling.
Als een PayPal-terugbetaling op uw rekening in settlestatus "10" staat, is het aan te raden dat je dit navraagt bij ons Support Team, voor het geval er verdere acties moeten worden ondernomen om afwikkeling te garanderen.
Vereisten
- U kunt een betaling niet terugbetalen totdat de AUTH is vereffend (settlestatus is "100").
- U kunt geen groter bedrag terugbetalen dan oorspronkelijk werd verrekend.