Configuring PayPal Direct Payment Plug-in
PayPal Direct Payment is a part of the PayPal Website Payments Pro solution. Thus, to use PayPal Direct Payment, you need to sign for a business account at PayPal and apply for PayPal Website Payments Pro.
In spite of the fact that originally Direct Payment API is not a standalone product and is required to be used together with Express Checkout as part of the Website Payments Pro solution, the PayPal Direct Payment plug-in implemented in HSPcomplete can be configured and used independently from the Express Checkout plug-in.
Note: PayPal Direct Payment solution currently supports the US dollars (USD) only.
PayPal Direct Payment API offers you direct credit card payment processing through PayPal. To pay with a credit card, your customer never leaves your website, as PayPal processes the payment behind the scene:
- On your website, a customer chooses to pay with a credit card and enters a credit card number and other details.
- A customer reviews an order.
- When your customer clicks 'Pay' to place an order, the plug-in calls the PayPal API to request a payment, and a payment transaction is initiated. A customer does not see this step. PayPal does not send your customer a receipt for a payment.
- Your customer is transferred to the next page of your store - order confirmation page.
To use the PayPal API with the plug-in, you will need to obtain and upload a merchant certificate file. You can get the test certificate (Sandbox API) immediately, and obtaining the Live certificate (to use the plug-in API in live mode) takes some time because your application is to be approved by PayPal in this case.
To obtain the certificate:
- Log in to your PayPal account.
- Click the Profile subtab.
- Click the API Access link in the Account Information column.
- Click Request API Certificate.
- Click Download on the API Certificate page.
PayPal will notify you by e-mail to let you know if you qualify for a Live Certificate.If you have requested a Sandbox Certificate, you can download it immediately from the API Certificate page.
To configure the PayPal Direct Payment plug-in:
- Click the Edit button on the plug-in screen. Fill the form that appears:
- Enter the PayPal API URL into the Direct Payment API URL field (default is https://api-aa.paypal.com/2.0/).
- Enter your PayPal API Account Name as it was specified during your application for new API Certificate (live) into the User field.
- Enter your PayPal API Account password as it was specified during your application for new API Certificate (live) into the Password field.
- Merchant certificate. Uploaded from PayPal API Certificate (live). Specify the certificate file location on your local computer or click the Browse button and locate the file.
- Select at least one credit card type to be accepted by the plug-in from the Available credit card types menu. To select a credit card type to accept with the plug-in, click on a card type name and then click the >> button to move a card type to the Supported Card Types menu. To select several card types in series, hold down SHIFT, and then click the first and last card types of the group. To select several card types that are nonadjacent in the list, hold down CTRL, and click a credit card type.
- If you want the plug-in to automatically check transactions status, you can enable this feature by checking the Enable PayPal API box. In this case, the following fields will become enabled and you must fill these fields:
GetTransactionDetails API URL - Enter the URL to be used by the plug-in to send transaction status requests to PayPal (default is https://api.paypal.com/2.0/).
Check Status period - You can set the frequency (in hours) for payments status polling, i.e., periodical automated plug-in requesting the payment gateway for transactions processing results. This is the plug-in feature that allows you to monitor payments processing on the payment gateway side with the pre-set frequency.
Note that if you enter the zero value, the plug-in will not check transaction status at all.
- To check the integration with PayPal API, you enable the test mode when transactions processing is just emulated and no real money is sent anywhere. To use the test mode, you must upload the Sandbox API certificate. To switch the plug-in in the test mode, check the Test mode box. In this case, the following fields will become enabled and you must fill these fields:
Direct Payment API URL - Enter the testing PayPal API URL into this field (default is https://api-aa.sandbox.paypal.com/2.0/
GetTransactionDetails API URL - Enter the Direct Payment API URL to be used by the plug-in to send transaction status requests to PayPal in the test mode (default is https://api.sandbox.paypal.com/2.0/).
Test User - Enter your PayPal API Account Name as it was specified during your application for Sandbox API Certificate.
- Test Password - Enter your PayPal API Account password as it was specified during your application for Sandbox API Certificate into the field.
- Test Merchant certificate. Uploaded from PayPal API Sandbox Certificate. Specify the certificate file location on your local computer or click the Browse button and locate the file.
- Key in the Button title. For example, this could be the name of payment system. This title will be displayed directly on the button for online-payment at HSPstore, on the final stage of subscription registration, when a customer selects how to pay for the services ordered.
- You can add both the short and the detailed description. Quick description of a payment method will be displayed below the button. The Long description of a payment method will be displayed in a separate section entitled Pay Online.
- Click the Update button.
Please send us your feedback on this help page