PayPal Payment Pro

Written by Valérie Isaksen. Posted in Payment methods

PayPal Payment ProWith this PayPal Payment Pro, the merchant can accept credit cards on his website, without the customer knowing that PayPal is being used.

Sign In for PayPal Payment Pro

In the Payment Method Information tab

  1. In the Payment Name field enter the name of your payment
  2. Set the Published radio button to Yes
  3. In dropdown Payment Method select  the payment method PayPal
  4. In the top right toolbar, click Save. This step will load the configuration parameters of the payment method you just created.
  5. Go on the Configuration tab, and configure the payment method.

Upgrade your PayPal Business account to a Pro account

Before configuring the payment method in VirtueMart, you need to upgrade your PayPal Business account to a Business-Pro.

Configuration of PayPal Payment Pro

Basic Parameters

PayPal product

Select Credit Card

Shop Mode
  • Test your payment configuration by selecting Sandbox. In this mode, no real money is transferred
  • Once your payment configuration is tested switch your payment in production mode selecting the Production parameter

All the configuration settings are explained using the sandbox shop mode. But the settings are the same when the Shop mode in Production.

PayPal Credentials

Get PayPal Sandbox Credentials
  1. Connect to the PayPal Developer Website
  2. Click on Applications on the horizontal bar
  3. And then on Sandbox Accounts on the left menu
  4. Click on the arrow next your Sandbox business account email address,
    sandbox-arrow
  5. and then click on the Profile link that appears below the email address. 
    sandbox-profileThis opens the Sandbox account details window.
  6. In the window Account details, click API credentials tab
    api-credentials
Sandbox API Username

Copy/paste the Password from your PayPal Sandbox Account details, tab API credentials here

Sandbox API Password

Copy/paste the Password from your PayPal Sandbox Account details, tab API credentials here.

Authentication

You can select

  • Signature: with the signature from your PayPal Sandbox account, you can easily configure and test your payment.
  • Certificate:  you can also use a cetificate as the authentication mechanism.

This parameter is only displayed if your Shop Mode is in Sandbox

Sandbox API Signature

Copy/paste the Signature from your PayPal Sandbox Account details, tab API credentials here.

Sandbox API Certificate

To acquire your API Credentials using API Certificate as your authentication mechanism, follow the steps described by PayPal  Requesting an API Certificate.

And follow those steps:

  1. Create a folder in your safe path folder called paypal
  2. Install your certificate in that folder via FTP
  3. In your payment configuration, select the certificate

PayPal settings

Let buyers override their PayPal addresses?
  • Yes: The address specified in the Bill To Address is sent to PayPal, and overrides the PayPal member’s stored address. Buyers see the address sent and they cannot edit them. PayPal does not show addresses if they are invalid or omitted.
  • No: The buyer can edit his PayPal member’s stored address.

See Address Handling (U.S. Merchants Only)

Prompt buyers for a shipping address

Select if the buyer is prompted for a shipping address:

  • buyer is prompted to include a shipping address at PayPal
  • buyer is not asked for a shipping address at PayPal
  • buyer must provide a shipping addressat PayPal

See also Address Handling (U.S. Merchants Only)

Payment action
  • Direct Payment: Indicates that the transaction is payment on a final sale
  • Authorize and capture: Indicates that the transaction is an authorization for a final sale, which needs to be captured later. In this case, all orders will be set to the order status Pending transactions

Order status

Pending transactions

By default, Pending transactions are set to Confirmed by shopper.

The order in VirtueMart is set to this status, when the order has been received by PayPal, but the payment has not yet been processed.

Some examples of reasons of Pending transactions:

  • Your payment action is set to Authorize and capture, the payment is then in a Pending state until the merchant captures.
  • A PayPal Direct Payment transaction can go into a transitional pending state if the transaction is funded by an eCheque. 

The exact reason why a transaction is Pending, is logged in your order. Go to your order, and at the bottom of the order, all the transactions with PayPal are logged, and the pending reason is displayed.

Example of a pending order 

Successful transactions

By default, Successful transactions are set to Confirmed.

The order is set to this status when PayPal informs that transaction was successful and the money is in the merchant's account.

Cancel transactions

By default, Cancel transactions are set to Cancelled.

  • The order in VirtueMart is set to this status, when the order has been cancelled by PayPal. For example when a buyer cancels a payment.
  • If the merchant sets an order to this status:
    • if the funds have already been received, VirtueMart issues a refund to the PayPal account holder associated with a transaction.
    • if the funds have not  been received, VirtueMart voids the transaction to PayPal.
Capture Payment

By default, Capture Payment are set to Shipped.

This parameter is only valid, if the Payment action parameter is set to Authorization and Capture

  • If the payment is captured via the PayPal account, the order will be set to this status in VirtueMart
  • VirtueMart will capture the payment of the  previously created authorization, when the order is set to this status.
Refunded transactions

By default, Refunded transactions are set to Refund.

  • The order in VirtueMart is set to this status, when the transaction has been refunded from the merchant PayPal account.
  • If the merchant sets an order to this status, VirtueMart issues a refund to the PayPal account holder associated with a transaction.
Partial Refunded transactions

At the moment, partial refund can only be done via the merchant PayPal account.

It is recommended that you create a new order status for partial refund.

The order in VirtueMart is set to this status, when the transaction has been partially refunded from the merchant PayaPal account.

Optional Parameters

Restrictions

Countries

If you want this payment method to be visible only to customers in certain countries, select the countries from the drop-down list. Otherwise, leave blank.

Minimum Amount

If you want this payment method to appear only if a customer's order is above a certain amount, enter the minimum amount in the vendor currency here.

Maximum Amount

If you want this payment method to appear only if a customer's order is below a certain amount, enter the maximum amount in the vendor currency here.

Payment publish start
  • Do not select a date, if you want you payment method to be immedaitly available
  • If you want this payment method publication to start on a specific date, click on the calendar icon.
Payment publish end
  • Do not select a date, if you want you payment method to always be listed.
  • If you want this payment method publication to end on a specific date, click on the calendar icon.

Currencies

Payment Currency

This option is usefull if your Default Vendor Currency is not a currency supported by PayPal.

  • Use the Default Vendor Currency if it is a currency supported by PayPal
  • Otherwise select another currency

Email Currency

This option is useful if your Default Vendor Currency is not a currency supported by PayPal.

If the Payment Currency is set to another currency than the Default Vendor Currency, you can select in which currency the email, and invoice will be sent. Select:

  • Vendor Currency
  • Payment Currency

Discounts

Discount per transaction

TODO

Percent of the total product amount

TODO

Tax

TODO

Layout

Logo Image

todo

PayPal page header image

TODO

Debug