Skip to content
Richard Blechinger edited this page Sep 18, 2018 · 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.

As of 2018, PayPal operates in 202 markets worldwide and has 237 million active, registered accounts. PayPal allows customers to send, receive, and hold funds in 25 currencies worldwide.

PayPal Configuration

To access the PayPal configuration page, select
Configuration / Basic settings / Additional settings / Wirecard

PayPal Configuration

Payment Action

PayPal payment via Wirecard Payment Processing Gateway may be performed in two different ways, i.e. with two different payment actions:

  1. Authorization: Payments for orders are not captured/invoiced but only authorized by the consumer and thus 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 created in Shopware order management will be marked with status "Reserved" (payment status).
  2. Purchase: Payments for orders are captured/invoiced automatically .
    • This payment action triggers the transaction type purchase for payment method PayPal.
    • The order created in Shopware order management will be marked with status "Completely paid" (payment status).

Send Basket

For the purpose of confirmation, PayPal supports shopping basket display during checkout. To enable this feature, select Yes in the [PayPal] Send basket dropdown field. For subshops Inherited can be selected to inherit this option from the main shop configuration.

Descriptor

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

Select Yes in the [PayPal] Descriptor dropdown field to send the descriptor with each request/response. For subshops Inherited can be selected to inherit this option from the main shop configuration.

  • If the descriptor is activated, the default descriptor text consists of the first 9 characters of the shop name and the order payment number.
  • To modify the descriptor, use the method getDescriptor in the file Components/Services/PaymentHandler.php.
    • Allowed characters: umlaut, 0-9,a-z,A-Z, , +, ,, -, .
    • Max. length: 27 characters
  • If the descriptor is set to No, PayPal generates a default entry for each purchase.

Send Additional Information

If this feature is activated, additional data will be sent for the purpose of fraud protection. This additional data includes billing/shipping address, shopping basket and descriptor.

Sending The Customers State

All PayPal transactions attempt to send the customers state whenever possible as this is required by PayPal. These can be configured under Basic Settings / Shop Settings / Countries. To see a list of supported state codes by the extension and PayPal, please refer to the PayPal documentation on the subject as well as the internal converter the extension uses.

All state codes should be defined according to the ISO 3166-2 standard.

Supported Post-Processing Operations

To access post-processing operations, go to Customer / Payments / Wirecard / Transactions to open the transaction table which lists all transactions:

Wirecard Transactions

Click the pencil (OpenIcon) on a transaction to open the order details. Select the Wirecard Tab for all available post-processing operations, e.g.:

Wirecard Order Tab

According to your "Payment Action" settings, there are different options for PayPal post-processing operation workflow:

Payment Action Authorization

  1. Cancel: Triggers transaction type "void-authorization". The payment will be canceled/voided and the corresponding order in Shopware order management will be updated to payment payment status "The process has been cancelled".
  2. Capture: Triggers transaction type "capture-authorization". The payment will be captured/invoiced and the corresponding order in Shopware order management will be updated to payment payment status "Completely Paid".
  3. Refund: Triggers transaction type "refund-capture". You can type an amount for partial refund. The payment/invoice will be refunded, and the corresponding order in Shopware order management will be updated to payment status "Re-crediting".
  4. Cancel / Refund: Triggers transaction type "refund-capture". The payment/invoice will be refunded, and the corresponding order in Shopware order management will be updated to payment status "Re-crediting".

Payment Action Purchase

  1. Refund: Triggers transaction type "refund-capture". You can type an amount for partial refund. The payment/invoice will be refunded, and the corresponding order in Shopware order management will be updated to payment status "Re-crediting".
  2. Cancel / Refund: Triggers transaction type "refund-capture". The payment/invoice will be refunded, and the corresponding order in Shopware order management will be updated to payment status "Re-crediting".

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

You can’t perform that action at this time.