Sign up

Paypal

Intro

PayPal ist eine Wallet, die ihren Verbrauchern die Option bietet, online zu bezahlen. Die Verbraucher können ihrer Wallet Finanzmittel zuführen oder mit ihrer zuvor konfigurierten Zahlungsart bezahlen.

Unsere Plattform bietet Ihnen die Möglichkeit, ganz einfach Zahlungen mit PayPal online anzunehmen. Wenn Ihre Verbraucher sich für PayPal entscheiden, werden sie zu ihrem PayPal Konto umgeleitet, um die Bestellung und die Zahlungsart zu bestätigen. Danach wickeln wir die Transaktion über PayPal ab, und PayPal gibt uns Feedback. Sie und der Verbraucher erhalten eine Bestätigung in Echtzeit, die den Status der Zahlung enthält.

Unsere Plattform verfügt über eine der weitreichendsten Integrationen mit PayPal, die es gibt, und ist mit der Express Checkout Schnittstelle von PayPal verbunden. Als Integrationsoptionen haben Sie die Wahl zwischen Express Checkout Shortcut (ECS) und Express Checkout Mark (ECM).

Überblick

Kategorie:
Payment Product-ID:
840
Wichtigste Vorteile
  • Bekämpfung von Betrug: Ermöglicht Ihnen die Verwendung von Nutzerdaten zur Betrugsbekämpfung
  • Einzelposten: Erlaubt Ihnen, Basket-Artikel in die Transaktion einzubeziehen
  • Direct Sale und Autorisierung/Datenerfassung
  • Re-Autorisierungen
  • Ungültige Autorisierungen
  • Gutschriften: Vollständige/teilweise Gutschriften auf Einzelerfassung; Vollständige Gutschriften auf Mehrfacherfassungen
  • Schutz des Verkäufers

Länder & Währungen

Unterstützte Länder

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 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"
}
}
Properties Hinweise

redirectPaymentMethodSpecificInput
     paymentProductId
     requiresApproval

paymentProductId: Der numerische Identifikator der Zahlungsart auf unserer Plattform. Diese ID finden Sie im Kapitel "Überblick". Dieses Property weist unserer Plattform an, Ihre Kunde direkt zum Paypal-Portal weiterzuleiten. Lassen Sie dieses Property weg, leitet unsere Plattform Ihre Kunden stattdessen zu der Hosted Checkout Page um. Dies erlaubt Ihren Kunden, diese oder eine andere Zahlungsmethode zu wählen, welche in Ihrem Konto aktiv ist.

requiresApproval: Auf „false“ setzen, da Sie Zahlungen über Direktverkauf verarbeiten müssen.

paymentProduct840SpecificInput.isShortcut

Legt fest, ob Sie Express Shortcut (true) oder Checkout Mark (false) nutzen.

hostedCheckoutSpecificInput.returnUrl

Die URL, an die wir Ihre Kunden weiterleiten, nachdem die Zahlung beendet ist.

Ausführliche Informationen über dieses Objekt und seine Eigenschaften finden Sie in unserer CreateHostedCheckoutAPI

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.
Paypal-flow.png

Testdaten

In unseren Testszenarios finden Sie Testdaten und detaillierte Instruktionen. 

Stellen Sie sicher, den korrekten Endpunkt anzusteuern und zurück zum Live-Endpunkt zu wechseln, sobald Sie Ihre Tests abgeschlossen haben

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.

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 us 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 us 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):

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

paypal-integration_1-ogone paypal-integration_2-ogone
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:

Field

Description

Mandatory

locale

Language to be displayed on PayPal page.

N

Order:

Field

Description

Mandatory

PurchaseType

Physical/digital. Inform if the goods are physical or digital (for digital goods no shipping address must be sent).

N

AmountOfMoney

Object containing amount and ISO currency code attributes.

Y

EmailAddress

Sent to paypal to pre-fill the login page for the customer.

N

ShippingAddress

Shipping address of the goods. It must not be sent in case for Express Checkout Shortcut and/or digital goods.

In order to have the transaction eligible for seller protection, some information must be sent in the shipping address:
- name.firstName or name.surname
- street
- city
- countryCode
- zip (some countries only)
- state (some countries only. Find the complete list of supported state codes by PayPal. Please note: when you send an incomplete or incorrect shipping address, PayPal might decline the transaction.)

For more information about seller protection, please contact PayPal.

N

AmountBreakdown

Used to display shopping basket. Please refer to Connect documentation for more information.

N

Items

Used to display shopping basket. Please refer to Connect documentation for more information.

N

RedirectPaymentMethodSpecificInput:

Field

Description

Mandatory

RequiresApproval

True/False. This field must be set to true when you request an authorization before capture. It is sent to false for direct sale.

N

PaymentProductId

Value: 840. This is the PaymentProductId for PayPal.

N

paymentProduct840SpecificInput:

isShortcut

True/False. This field must be set to true for PayPal Express Checkout Shortcut and to false for PayPal Express Checkout Mark.

N

Token

Value of the token in case of reference transaction.

N

Tokenize

True: When the merchant requests the creation of a billing agreement ID (for future reference transactions).

N

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

Was this page helpful?

Do you have any comments?

Thank you for your response.