PayPal

Paypal payments can be processed with Saferpay without much effort. This chapter describes what needs to be considered in this regard.

General requirements

The handling of PayPal payments with Saferpay requires:

• A corresponding license and thus a valid identification with a username and password for the Saferpay system.

• Availability of at least one active Saferpay terminal via which payment can be carried out and availability of the associated Saferpay TerminalId.

• A valid PayPal merchant account.

Technical requirements

The general integration of PayPal can only be done via the Payment Page and requires the following things to be noted:

• PayPal requires the Payment.OrderId to be unique. Saferpay however does not limit the use of the OrderId in any way. If you use PayPal, you have to make sure, that your system submits unique OrderIds for every PayPal-transaction, otherwise you will get an error-message during the authorization.

PayPal does not support the iFrame Integration!Saferpay will break out of the IFrame, if necessary.

• Unlike normal transactions, PayPal refunds always have the status CAPTURED, thus executing the money right away.

• The notification URLs, inside theNotification conatiner are mandatory, in order to avoid missing payment successes. See the Payment Page process for further information.

Supported features

Feature	Support
Capture/Cancel	✅
Multipart Captures	✅
Secure Card Data (Needs Attention)	✅
Refunds	✅
Recurring Payments (Needs Attention)	✅
3D Secure	❌
Dynamic Currency Conversion (DCC)	❌
Mail Phone Order	❌
Testing	✅
Omni-Channel	❌
PayPal Seller Protection	✅
Express Checkout	✅

PayPal refunds do not need to be captured and will always report a Transaction.Status: "CAPTURED".

Activation

To enable Paypal processing on your Saferpay Terminal, there are two steps, that need to be done

#1 - Activation on your Saferpay Terminal

First and foremost, PayPal needs to be activated on your desired terminal.

For that, please inform our customer service about the terminalId(s) you want PayPal to be activated on, your PayPal merchant account ID and the desired currencies.

#2 - Granting permission to Saferpay

Once step #1 has been done, you have to grant Saferpay the permission to perform actions (e.g. transactions of any kind) on your PayPal account.

For that, please log into the Saferpay Backoffice and navigate to Settings > Payment Means & Terminals. There, please select the terminal on which Paypal has been activated on. If there were multiple terminals, this configuration has to be repeated on all of them.

Scroll down, until you find PayPal and click on Configure.

The activation status window will open up. Since no activation has been performed, you will be asked to finalize it now. In order to do so, please click on Connect a PayPal account.

You will be redirected to PayPal, where you'll be asked to log in with your merchant account and grant the necessary permissions for Saferpay, including PayPal Vault.

All done, PayPal has now been activated.

Checking the activation status

Depending on your PayPal account and its settings, some PayPal features may not be available, or there may have been an issue, during the activation.

You can check the current status, by clicking on Configure again.

Saferpay will show you an overview about the activation and availability of certain PayPal features, like PayPal Vault.

Error response in case of missing permissions

Saferpay will return the following error-message, if PayPal ha snot been set up correctly:

{
    "ResponseHeader": {
        "SpecVersion": "[CURRENT SPECVERSION]",
        "RequestId": "[YOUR REQUESTID]"
    },
    "Behavior": "ABORT",
    "ErrorName": "TRANSACTION_DECLINED",
    "ErrorMessage": "Transaction declined by acquirer",
    "TransactionId": "[TransactionId]",
    "ErrorDetail":[
        "Check that PayPal was setup as described in the Saferpay integration guide for the PayPal payment method."
    ],
    "ProcessorName": "PayPal",
    "ProcessorResult": "invalid_request",
    "ProcessorMessage": "No permission to set target_client_id",
    "OrderId": "[YOUR ORDERID]"
}

Capture and the solvency of the customer

Unlike credit cards, that give the merchant a certain guarantee for the authorized money, PayPal reserves the right to deny the payout of a transaction, if the solvency of the account holder changes negatively after the authorization.

Therefore Saferpay claims the money directly, once the Capture of the transaction has been successfully executed. If the money cannot be claimed, the capture then returns an error. We generally recommend to execute the Capture as soon as possible, to avoid any issues.

PayPal Seller Protection

The PayPal Seller Protection protects eligible transactions from chargebacks, reversals and their associated fees! Precondition to profit from the Seller Protection is to send the delivery address of your customer over our API. The delivery address (http://saferpay.github.io/jsonapi/#Payment_v1_PaymentPage_Initialize - Container DeliveryAddress) needs to be the same as the Billing Address. The SellerProtectionStatus can have three results in your request: Eligible Partially Eligible Not Eligible Please check this link how to integrate the Seller Protection: http://saferpay.github.io/jsonapi/#Payment_v1_PaymentPage_Assert After clicking the link, please scroll a little bit down until the Point "PaymentMeans", click on "Object" and on PayPal.

More information about the PayPal Seller Protection you will find on the PayPal Documentation here.

Express Checkout

Saferpay offers a way to implement a so called "Express Checkout", which allows the merchant to gather every important information about the payer -like addresses etc.- from the payment gateway, without the need of capturing this data yourself.

The payer could go through a guest-checkout, pays his order and everything needed for the merchant is returned at the end.

This minimizes user-interaction, makes the checkout sleek and fast, which increases the user-satisfaction.

Please refer to this chapter, in order to know, how you integrate an Express Checkout.

PayPal Vault

PayPal Vault is a way to save a PayPal account for Recurring Payments. It works via the normal Saferpay Secure Card Data Tokenization, either via the Payment Page, or the Standalone registration.

Please make sure, that Vault has been successfully activated on your account.

Standalone Registration

With the Standalone registration, you need to specify, that you want to register a PayPal account, by setting the Type parameter to "PAYPAL", The rest of the flow remains the same.

Example of Alias Insert Request

Request

{
  "RegisterAlias": {
    "IdGenerator": "RANDOM_UNIQUE"
  },
  "Type": "PAYPAL",
  "LanguageCode": "en",
  "RequestHeader": {
    "SpecVersion": "[CURRENT_SPEC_VERSION]",
    "CustomerId": "[YOUR_CUSTOMER_ID]",
    "RequestId": "5f543be575b3f3ecff3214257ac6978a",
    "RetryIndicator": 0,
    "ClientInfo": {
      "ShopInfo": "My Shop",
      "OsInfo": "Windows Server 2013"
    }
  },
  "ReturnUrl": {
    "Url": "https://www.myshop.com/return"
  },
  "Notification":{
    "NotifyUrl": "https://www.myshop.com/notify"
  }
}

Response

Testing

Please refer to this chapter, if you want to test PayPal.