Paypal

Paypal (New Integration)

Paypal is an online financial service that allows you to pay for items using a secure internet account.

PayPal transactions are by default set to be approved and deposited in one step, but we can split it up into a two-step process. That allows you to distinguish between approved payments and deposited payments and perform certain actions for each of them.

To enable the integration of PayPal into your online shop in our QENTA Checkout solutions you need to perform a new onboading process over the QENTA Portal. Contact our integration specialists for more information.

Payment Options

The new paypal integration offers 3 payment options:

One Time payment

Paypal will be initiated over QENTA with a specific amount and the consumer enters his credentials for this One Time payment. The amount will be deposited automatically after QENTA received the result of PayPal. Recurring on this specific payment is not allowed.

Order Creation With Amount

Paypal will be initiated over QENTA with a specific amount and the consumers enters his credentials for this payment. The amount will be deposited automatically after QENTA received the result of PayPal. Based on the QENTA Ordernumber, recurrings are allowed.

The parameter transactionIdentifier must be set to INITIAL if you want to flag it as a transaction you want to recur later.

Order Creation Without Amount

Paypal will be initiated over QENTA with a Zero amount and the consumers enters his credentials for this payment. In this case, the consumer gives permission for follow-up operations like recurrings. No payment was made for the initial transaction. Based on the QENTA Ordernumber, recurrings are allowed.

The parameter transactionIdentifier must be set to INITIAL if you want to flag it as a transaction you want to recur later.

Parameters

PayPal payment method can be initialized if the merchant sends PAYPAL for parameter paymentType.

Required Request Parameters

Table 1. Length Restrictions for Some Shopping Basket Data
Parameter Within fingerprint Data type Description

basketItem(n)ArticleNumber

Required if used

Alphanumeric with special characters, up to 128 characters.

Unique ID of article n in the shopping basket.

basketItem(n)Description

Required if used

Alphanumeric with special characters, up to 128 characters.

Product description of article n in the shopping basket.

Table 2. Length Restrictions for Some Shopping Basket Data
basketItem(n)ArticleNumber

Data

Value

Within fingerprint

Required if used

Data type

Alphanumeric with special characters, up to 128 characters.

Description

Unique ID of article n in the shopping basket.

basketItem(n)Description

Data

Value

Within fingerprint

Required if used

Data type

Alphanumeric with special characters, up to 128 characters.

Description

Product description of article n in the shopping basket.

State pending is only used if the parameter pendingUrl is set in combination with the parameter confirmUrl; otherwise, you’ll get a failure instead of a pending state.

Optional Request Parameters

Optional request parameters customerStatement and orderReference are more restricted about their length and allowed characters than usual.

Parameter basketItem to redeem Vouchers

If the consumer in your online shop redeems a voucher or coupon during the payment process, the optional request parameterbasketItem must be used. This parameter must contain the negative amount corresponding to the voucher or coupon value. For vouchers with a percentage discount, the percentage to be deducted must first be converted into an absolute value. The total basket amount displayed to the consumer in your online shop will then show both the voucher amount and the total basket amount reduced by the voucher amount.

Backend Operations

Although the shopping basket data parameters are in general optional, all parameters need to be set, except for basketItem(n)Description and basketItem(n)ImageUrl which remain optional and these two parameters are not part of the fingerprint.

If the parameter consumerShippingCountry is set, PayPal will display its own pages in the language of that country; otherwise, PayPal will use the language configured within the web browser of your consumer.

If no shipping address is entered e.g. only digital goods are sold and there is no shipping then the respective parameter is NOSHIPPING=1. If you want to prevent the consumer in your online shop from editing the shipping address then the respective parameter is ADDROVERRIDE=1.

Contact our integration specialists team for changes in a merchant configuration.

Button styling

Table 3. PayPal Button Styling
Color Shape Pill Shape Rectangular

Gold

Image
Image

Blue

Image
Image

Silver

Image
Image

White

Image
Image

Black

Image
Image
The design in the first row is the default one, contact our integration specialists team for change.

Order Flow Diagram

Two Step Transaction

Contact our integration specialists team to enable this workflow.
Image

To interpret this diagram, the successful completion of a NEW PAYMENT is assumed. Starting from the operation it’s possible to carry out different transaction-based operations.

For the explanation of the different status descriptions included in this diagram have a look at getOrderDetails.

All possible states of transaction for all specific acquirers can be found here.