Skip to content
claufruh edited this page Jun 7, 2019 · 9 revisions

PayPal is a global e-commerce business, processing internet payments and money transfers. It is a wallet payment method that allows consumers to make and receive payments without having to share their financial information.

PayPal Configuration

  1. Navigate to Merchant Tools / Site Preferences / Custom Preferences.

  2. Select Wirecard Payment Gateway settings for PayPal: PayPal Site preferences

Send Descriptor

The descriptor is the text representing an order on the consumer's bank statement issued by PayPal. It provides information for the consumer, as it associates a specific debit on the consumer's account with the respective purchase in your shop.

  • If the descriptor is set to No, PayPal generates a default entry for each purchase.

  • If the descriptor is set to Yes, the default descriptor text consists of the first 9 characters of the shop name (as configured in the General Settings) and the order number.

  • To modify the descriptor, check the script: int_wirecard_core/cartridge/scripts/paymentgateway/transaction/entity/Descriptor.js.

    • Allowed characters: umlaut, 0-9, a-z, A-Z, , +, ,, -, .
    • Max. length: 27 characters

Set this feature to Yes to send the descriptor with each request/response.

Send Additional Information

If this feature is set to Yes, additional data will be sent for the purpose of fraud protection. This additional data includes billing/shipping address, the consumer's IP address and the device fingerprint.

Shopping Basket

As a service for the consumers, PayPal supports the display of the shopping basket's content during checkout. To enable this feature, set the Shopping Basket to Yes.

Payment Action

PayPal payment can be performed with two different payment actions:

1. Authorization: Payments for orders are not captured/invoiced but only authorized by the consumer, and therefore only reserved. For debit, you have to confirm/capture the amount manually.

  • This payment action triggers the transaction type authorization for payment method PayPal.
  • The order custom attribute paymentGatewayOrderState of the created order will be labeled as Authorized.

2. Purchase: Payments for orders are captured/invoiced automatically.

  • This payment action triggers the transaction type purchase for payment method PayPal.
  • The order custom attribute paymentGatewayOrderState of the created order will be labeled as Processing.

Supported Post-Processing Operations

To access post-processing operations, go to Merchant Tools / Wirecard Payment Gateway / Transaction Table to open the transaction table, which lists all successful transactions: Wirecard Transaction Table

Click a Transaction ID to open the transaction detail view. It shows all available post-processing operations, e.g.:

Wirecard Payment Gateway Transactiondetails

Depending on your Payment Action settings, there are different options for the PayPal post-processing operation workflow:

Payment Action Authorization

1. Cancel: Triggers transaction type void-authorization. The payment will be canceled/voided, and the corresponding custom order attribute paymentGatewayOrderState will be updated to status Canceled.

2. Capture: Triggers transaction type capture-authorization. The payment will be captured/invoiced, and the corresponding custom order attribute paymentGatewayOrderState will be updated to status Processing.

3. Refund: Triggers transaction type refund-capture. The payment/invoice will be refunded, and the corresponding custom order attribute paymentGatewayOrderState will be updated to status Refunded.

Payment Action Purchase

1. Refund: Triggers transaction type refund-debit. The payment/invoice will be refunded, and the corresponding custom order attribute paymentGatewayOrderState will be updated to status Refunded.

You also have the option of partial Refund/Capture. Partial Refund/Capture is possible until the payment has been refunded/captured in full.


Please be aware that stock management is not included in the post-processing operations triggered in the Wirecard cartridge but only in Salesforce order management.

You can’t perform that action at this time.