With PayPal Express Checkout, your customers can complete transactions in very few steps. It lets them also to use the billing and shipping information stored at PayPal for the checkout. With PayPal Express Checkout, payments by credit card or from a PayPal account are accepted.
In the Payment Method Information tab
- In the Payment Name field enter the name of your payment
- Set the Published radio button to Yes
- In dropdown Payment Method select the payment method PayPal
- In the top right toolbar, click Save. This step will load the configuration parameters of the payment method you just created.
- Go on the Configuration tab, and configure the payment method.
Configuration of PayPal Express Checkout
Select Express Checkout
- 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.
Get PayPal Sandbox Credentials
- Connect to the PayPal Developer Website
- Click on Applications on the horizontal bar
- And then on Sandbox Accounts on the left menu
- Click on the arrow next your Sandbox business account email address,
- and then click on the Profile link that appears below the email address.
This opens the Sandbox account details window.
- In the window Account details, click API credentials tab
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.
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:
- Create a folder in your safe path folder called paypal
- Install your certificate in that folder via FTP
- In your payment configuration, select the certificate
Do you have a business account?
If the merchant does not have yet a business account, set this option to Yes. With this option, the merchant can start accepting Express Checkout payments, and do not need to have a PayPal account.
More about Accelerated Boarding option.
Sandbox Merchant Email
When the parameter Do you have a business account? is set to Yes, enter the email address to start accepting Express Checkout payments.
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.
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
- 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
By default, Pending transactions are set to Confirmed by shopper.
The order in VirtueMart is set to this status, when the payment requrest for 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.
By default, Completed successful transactions are set to Confirmed.
The order is set to this status when PayPal informs VirtueMart that the transaction was completed successfully and the amount requested is in the merchant's account.
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.
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.
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.
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.
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.
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.
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
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
Discount per transaction
Percent of the total product amount
PayPal page header image
Log debug in file