PayPal Payments Standard and Ecommerce Templates
Once you have created your PayPal account, you need to setup the instant
payment notification. This is necessary so that sales are automatically
validated. To do this log into your PayPal account and click on
the "Profile" tab. Now click on the link Selling Options > Instant Payment
Notification preferences link. The URL that you want to enter is
the one to the file ppconfirm.php in your vsadmin directory. So
for instance it might be
After entering this URL, just click the checkbox to activate instant payment notification and you're all done.
You now just need to go to the Edit Payment Providers link on your store admin, chose Modify for PayPal and enter the email address that is associated with your PayPal account.
The Identity Token field is optional and is used if you want customers to be automatically returned to your store following payment through PayPal. To enable this feature go to Profile > Selling Options > Website Payment Preferences and set the following
- Auto Return - On
- Return URL - http://www.yourstoreurl.com/thanks.php
- Payment Data Transfer - On
Enter the Identity Token in your Ecommerce Templates payment provider admin page for PayPal Payments Standard as in the above example.
Do not set up any shipping through PayPal as that is handled by the store.
Testing with the PayPal sandbox
To use this feature, check the "Sandbox" box in the payment provider admin page for PayPal and then sign up for a developer account at https://developer.paypal.com/ so you can use their sandbox feature. You will need a separate account as both a buyer and seller so you may find it simpler to just put through a live transaction and then refund.
If you are using the Auto Return feature you will need to enter the PDT key as above or you will receive the message “Sorry there has been an error”. You will also not receive order confirmation. Godaddy hosting customers only may require this addition to vsadmin/includes.php
If in your admin orders page your PayPal payments are showing with a status of "Pending: unilateral" then you will need a verified Premier or Business account for PayPal IPN. The message of Pending: unilateral comes up when the account isn't verified. The solution is to check again that you have completed all the verification steps for your account and that it is a Premier or Business account.
If the shipping cost is not being passed on to PayPal even though
this is showing correctly in the cart then go to this URL when
logged in to your PayPal account . . .
Then check the setting of . . .
Click here to allow transaction-based shipping values to override the profile shipping settings listed above (if profile settings are enabled).
You will also need to add this parameter to vsadmin/includes.php
In the orders admin page you should see something like the following after a successful PayPal order.
The AVS column refers to whether the PayPal address is verified (Y) or unverified (N). The CVV column refers to whether the PayPal account is verified (Y) or not (N).
In the first example above payment was received from a non-verified address but a verified account. In the second example both the account and address are verified and in the third neither.
PayPal offer a range of extra parameters that some may find useful. The list is available here. So that you can include these without your changes being overwritten by updaters we set up a system in Version 6.1.4 where these can be added to your vsadmin/includes.php file.
For example, if you want to change the text for the "Return to Merchant" link, you'll see from PayPal guide that uses the "cbt" variable. The line you would add to vsadmin/includes.php for this example would be
$payprovextraparams1='<input type="hidden" name="cbt" value= "Your return message goes here">';
...where $payprovextraparams1 defines the payment provider (in your payment provider admin page you'll see the identifier for PayPal is 1 but this can be used for other processors too), cbt is the variable available from PayPal and the Value is the text you want to appear as the link customers click on to go back to your store following payment.
Please do read our guide here on credit card fraud.
That's all there is to it really - any comments on the set up can be posted on our Support Forum.