Paypal

Paypal (New Integration)

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

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

To separate the transaction flow into authorization and capture, get in contact with the integration specialists. Look at the order flow diagram of the payment method for closer 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.

To flag transactions for later recur the parameter transactionIdentifier must be set to INITIAL

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.

To flag transactions for later recur the parameter transactionIdentifier must be set to INITIAL

Parameters

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

Required Request Parameters

Parameters of consumer billing data and shopping basket data are required for PayPal Seller Protection. If any billing parameter is in use, consumerBillingPhone/consumerBillingMobilePhone and consumerBillingCountry become mandatory!
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, a failure will get 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 the 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 the 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 the 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. To prevent the consumer in the 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.