Paypal

Länder & Währungen

Unterstützte Länder

• Afghanistan
• Albanien
• Algerien
• Samoa Amerikanisch
• Andorra
• Angola
• Anguilla
• Antigua und Barbuda
• Argentinien
• Armenien
• Aruba
• Australien
• Osterreich
• Aserbaidschan
• Bahamas
• Bahrain
• Bangladesch
• Barbados
• Belarus
• Belgien
• Belize
• Benin
• Bermuda
• Bhutan
• Bolivien
• Bonaire Bonaire Saba Saba Sint Eustatius Sint Eustatius
• Bosnien und Herzegowina
• Botswana
• Brasilien
• Brunei
• Bulgarien
• Burkina Faso
• Burundi
• Kambodscha
• Kamerun
• Kanada
• Kap Verde
• Cayman Islands
• Zentralafrikanische Republik
• Tschad
• Chile
• China Volksrepublik
• Kolumbien
• Komoren
• Kongo Demokratische Republik
• Kongo Republik
• Cookinseln
• Costa Rica
• Kroatien
• Zypern Republik
• Tschechien
• Danemark
• Dschibuti
• Dominikanische Republik
• Dominica
• Ecuador
• Agypten
• El Salvador
• Eswatini
• Äquatorialguinea
• Eritrea
• Estland
• Athiopien
• Falklandinseln
• Faroer
• Fidschi
• Finnland
• Frankreich
• Franzosisch-Guayana
• Franzosisch-Polynesien
• Gabun
• Gambia
• Georgien
• Deutschland
• Ghana
• Gibraltar
• Griechenland
• Gronland
• Grenada
• Guadeloupe
• Guam
• Guatemala
• Guinea-a
• Haiti
• Honduras
• Hongkong
• Ungarn
• Island
• Indien
• Indonesien
• Irak
• Irland
• Israel
• Italien
• Elfenbeinküste
• Jamaika
• Japan
• Jordanien
• Kasachstan
• Kenia
• Kiribati
• Kuwait
• Kirgisistan
• Laos
• Lettland
• Libanon
• Lesotho
• Liberia
• Libyen
• Liechtenstein
• Litauen
• Luxemburg
• Macau
• Nordmazedonien
• Madagaskar
• Malawi
• Malaysia
• Malediven
• Mali
• Malta
• Marshallinseln
• Martinique
• Mauretanien
• Mauritius
• Mexiko
• Mikronesien Foderierte Staaten
• Moldau Republik
• Monaco
• Mongolei
• Montenegro
• Marokko
• Mosambik
• Myanmar
• Namibia
• Nauru
• Nepal
• Niederlandische Antillen
• Niederlande
• Neukaledonien
• Neuseeland
• Nicaragua
• Nigeria
• Niger
• Niue
• Norfolkinsel
• Marianen Nordliche
• Norwegen
• Oman
• Pakistan
• Palau
• Panama
• Papua-Neuguinea
• Paraguay
• Peru
• Philippinen
• Polen
• Portugal
• Puerto Rico
• Katar
• Reunion
• Rumänien
• Russland Russland
• Ruanda
• St. Helena, Ascension und Tristan da Cunha
• Saint Kitts Nevis
• Saint Lucia
• Saint-Pierre und Miquelon
• Saint Vincent Grenadinen
• Samoa
• San Marino
• Sao Tome und Principe
• Saudi-Arabien
• Senegal
• Serbien
• Seychellen
• Sierra Leone
• Singapur
• Slowakei
• Slowenien
• Salomonen
• Somalia
• Sudafrika
• Korea Sud
• Spanien
• Sri Lanka
• Sudan
• Suriname
• Schweden
• Schweiz
• Taiwan
• Tadschikistan
• Tansania
• Thailand
• Togo
• Tonga
• Trinidad und Tobago
• Tunesien
• Turkmenistan
• Turksinseln und Caicosinseln
• Tuvalu
• Uganda
• Ukraine Ukraine
• Vereinigte Arabische Emirate
• Vereinigtes Konigreich
• Vereinigte Staaten
• Uruguay
• Usbekistan
• Vanuatu
• Vatikanstadt
• Venezuela
• Vietnam
• Jungferninseln Britische
• Jungferninseln Amerikanische
• Jemen
• Sambia
• Simbabwe

Unterstützte Währungen

• Australischer Dollar
• Brasilianischer Real
• Kanadischer Dollar
• Tschechische Krone
• Dänische Krone
• Euro
• Hongkong-Dollar
• Ungarischer Forint
• Israelischer Neuer Schekel
• Japanischer Yen
• Malaysischer Ringgit
• Mexikanischer Peso
• Neuer Taiwan-Dollar
• Neuseeland-Dollar
• Norwegische Krone
• Philippinischer Peso
• Polnischer Złoty
• Britisches Pfund
• Russischer Rubel
• Singapur-Dollar
• Schwedische Krone
• Schweizer Franken
• Thailändischer Baht
• US-Dollar

Integration

Leiten Sie Ihre Kunden zum Paypal-Portal über unsere Hosted Checkout Page weiter. Einen allgemeinen Überblick finden Sie im Kapitel "Zahlungsablauf".

Unsere Plattform erlaubt sowohl den Express Checkout Mark als auch Express Checkout Shortcut Modus. Je nach dem gewählten Modus gibt es Unterschiede:

• Express Checkout Mark
• Express Checkout Shortcut

Express Checkout Mark mode

Fügen Sie die folgenden Properties einer CreateHostedCheckout-Standardanfrage hinzu:

{
   "order": {
      "amountOfMoney": {
         "currencyCode": "EUR",
         "amount": 1000
      }
   },
   "hostedCheckoutSpecificInput": {
      "returnUrl": "https://yourReturnURL.com"
   },
   "redirectPaymentMethodSpecificInput": {
      "paymentProduct840SpecificInput": {
         "isShortcut": false
      },
      "PaymentProductId": "840"
   }
}

Express Checkout Shortcut mode

Fügen Sie die folgenden Properties einer CreateHostedCheckout-Standardanfrage hinzu:

{
   "order": {
      "amountOfMoney": {
         "currencyCode": "EUR",
         "amount": 1000
      }
   },
   "hostedCheckoutSpecificInput": {
      "returnUrl": "https://yourReturnURL.com"
   },
   "redirectPaymentMethodSpecificInput": {
      "paymentProduct840SpecificInput": {
         "isShortcut": true
      },
      "PaymentProductId": "840"
   }
}

Zahlungsablauf

1. Ihre Kunden geben in Ihrem Shop eine Bestellung auf und wählen PayPal.
2. Sie senden eine dieser CreateHostedCheckout Anfragen (Express Checkout Mark oder Express Checkout Shortcut) an unsere Plattform.
3. Sie leiten Ihre Kunden über die redirectUrl zum PayPal Portal. Sie bestätigen die Bestellung mit ihren Login-Anmeldedaten (E-Mail-Adresse und Passwort).
4. Wir erhalten das Ergebnis der Transaktion.
5. Wir leiten Ihren Kunden um zu Ihrer returnUrl.
6. Sie fragen das Ergebnis der Transaktion via GetPayment bei unserer Plattform an oder Sie erhalten das Ergebnis via Webhooks.
7. Wenn die Transaktion erfolgreich verlaufen ist, können Sie die Güter / Dienstleistungen ausliefern.

Testdaten

In unseren Testszenarios finden Sie Testdaten und detaillierte Instruktionen. 

Zusätzliche Informationen

To offer this payment method to your customers, make sure to

• Sign an acquiring contract with PayPal and activate the payment method in your PSPID. We are happy to assist you.
• Create PayPal test / live accounts and link them to our platform.
• Set up your PayPal account.
• Configure the payment method in your PSPID. 

Contact us to ensure this.

Contact your account manager to ensure this.

Integration: PayPal Express Checkout

There are 2 integrations of PayPal Express Checkout:

• Express Checkout Shortcut (ECS)
• Express Checkout Mark (ECM)

For each integration the transactions can be processed in:

• Direct Sale
• Authorization + Data Capture

Express Checkout Shortcut

The ECS integration allows faster checkout as the additional data, like shipping address, can be provided by the PayPal account.
When the consumer wants to pay with ECS he is immediately redirected to PayPal where he can review his order. (For better user experience it is recommended to send the line item details) Once reviewed, the consumer can either complete the purchase or he can return to the merchant for final confirmation of the order. This option can be configured by the merchant. Contact your account manager to ensure this.
In the ECS flow, it is requested by PayPal not to send them a shipping address. Note that when you receive the address back in the response, the street and house number will never be in separate fields as we receive them back in the same field from PayPal.
You must ensure you inform PAYONE E-Payment if the goods to be delivered are digital or physical goods. This will determine the need for shipping.

Express Checkout Mark

The ECM integration is the standard PayPal checkout flow. The checkout is done on the merchant website and the consumer can choose PayPal in the merchant payment methods options. The consumer is redirected to the PayPal review page for final review.
In the ECM flow, the merchant can also request for the consumer to be redirected to its confirmation page after review on PayPal side.  This option can be configured by the merchant. Contact your account manager to ensure this.
The merchant must ensure the shipping address is sent for physical goods. This address will be provided and displayed on PayPal side. The consumer cannot change his address on PayPal side. He is notified to go back to the merchant website if he desires to change the delivery address. Make sure the consumer can change his shipping address when reviewing its order on the PayPal review page.

Here is a recap of the flows for ECM/and ECS with a review or without a review page. (The difference between ECS and ECM flows is that for ECS the shipping information are presented by PayPal whereas for ECM it is the merchant who sends the shipping information):

Direct Sale

For direct sales transactions, the merchant must send the parameter RequiresApproval at False. The default operation is direct sale.

Separated authorization and data captures

Authorizations are made during the checkout process. The parameter to be sent is RequiresApproval-True. Please be aware that only successful captures are covered by PayPal Seller Protection (not the successful authorization). It is therefore important not to send the goods until the funds are successfully captured.
The captures can be full or partial. In case the merchant sends a request for last partial captures and there is still an authorization amount remaining, PAYONE E-Payment will automatically request PayPal to void (cancel) the remaining authorized amount.

Maintenance operations

Cancellation

The authorization can be cancelled. The cancellation can be full or partial.
Cancellation can be requested via the Merchant Portal or CancelPayment

Refunds

A refund can be processed following a direct sale or a capture.
PAYONE E-Payment supports full refund or partial refund on full captures but not partial refunds on multiple captures (this will be supported in the future).
The refund amount cannot exceed the original authorized amount. Multiple refunds can be made as long as the cumulative refunded amount does not exceed the original transaction value.
Refunds must be issued within 60 days of the original transaction.

Line items

The content of the shopping basket can be provided in the line items to PayPal. This way each product is shown on the PayPal review page with its own name, price, quantity and description.

Reference transactions

Reference Transaction allows the merchants to have recurring payments through PayPal. If you want to use this feature please contact PayPal. Each merchant must get approved individually for reference transactions by PayPal Underwriting.

Below steps are needed to change your account configuration on PayPal:

1. After log in, go to “Profile”.
2. Click “Payment Receiving Preferences” link under “Selling Preferences”.
3. Select “No, allow multiple payments per invoice ID”.

Billing Agreement

The buyer can sign up for recurring payments as part of the Express Checkout flow.
Buyers must set up a Billing Agreement (hosted on PayPal) first before merchant can charge consumers. PayPal will need to make sure that the buyer specifically agrees to the reference transaction in the purchase flow and that this is also reflected in the website terms and conditions for the provision of service.

The buyer must log in to PayPal once to agree, but after that PayPal login is not required. This agreement is represented as a billing agreement between the merchant and the buyer, which is maintained by PayPal. The buyer can agree during the Express Checkout flow. This Billing Agreement ID is stored in our database, which is send to PayPal automatically whenever a new recurring payment is made on an order. The billing agreement ID does not have a time frame; it is approved until canceled by the buyer.

In order to have a billing agreement ID created, the parameter tokenize = true must be sent in the redirectPaymentMethodSpecificInput. The billing agreement ID can be created at the same time as a financial transaction or it can be created alone for future usage (in this case the amount of transaction must be equal to 0). A token will be sent back to the merchant.
For future reference transactions, the token must be provided in order for PAYONE to send the correct billing agreement ID to PayPal.

Create Hosted Checkout for PayPal

Here is the information that can be sent in the Create Hosted Checkout for PayPal:

HostedCheckoutSpecificInput:

Order:

RedirectPaymentMethodSpecificInput:

PayPal Fraud Prevention

User account status

The status of the PayPal account can be either verified or unverified. It becomes verified only after the user has validated the funding source that is attached to the PayPal account. On first PayPal registration consumer has status unverified.
Possible values

• Verified
• Unverified

How to get verified

To become verified, the user must:

• Confirm the email address.
• Add a credit card or bank account to the PayPal account.
• Link and confirm the CC/bank account by either confirming the deposits made by PayPal or a random code posted on the statement

Address status

Status of the customer's address. A status of Confirmed means that a buyer‟s credit card billing and shipping addresses are the same. PayPal maintains a history of transactions shipped to any given address - when the address shows continual use with no issues raised by the buyer for non-receipt of items it will be rated confirmed.

Most unconfirmed addresses are not fraudulent, and sellers usually won’t experience problems with them. When you do ship to an unconfirmed address, PayPal encourages you to be alert and minimize risk by following their Security Tips for Sellers.

Possible values

• Confirmed
• Unconfirmed
• None (consumer has never had goods shipped to his address)

PayerID

The unique identifier of a PayPal account and will never change in the life cycle of a PayPal account. It is a unique 13 alphanumerical character’s value (e.g. RZJF8EE021L5P).

Account ID

The field AccountID is the username with which the PayPal account holder has registered at PayPal. This can be used with black- or whitelist as well as for velocity checks.

Possible values

• Email address

PayPal Seller protection

With PayPal Seller Protection, you might be covered in the event of an unauthorised payment, an item not received dispute, chargeback, or reversal, as long as the transaction in question meets PayPal's eligibility requirements. You will receive this information in the field RedirectPaymentMethodSpecificOutput.PaymentProduct840SpecificOutput.ProtectionEligibility:

• Eligible
• Ineligible

You should contact PayPal for any further questions about Seller Protection and eligibility requirements.

Your liability

PayPal’s policy outlines that a merchant is both liable and responsible for all PayPal disputes, claims and chargeback’s. Please click here for the most up to date information on dispute handling and resolution. Please click here for PayPal’s comprehensive guide on chargebacks.

PayPal logos and branding

For ECS flow, the “Checkout with PayPal button” can be located on the basket page or on the product page as there is no need for checkout on merchant side. The merchant must ensure that it is also optimized for mobile websites.

PayPal local buttons for shortcut: please check with your contact on PayPal.

For ECM flow, the PayPal logo is presented together with the other payment methods offered by the merchant.

PayPal logos: https://www.paypal.com/buttons/?locale.x=en_C2