Adding / Modifying a PayPal Direct Payment API Gateway
Dominion Domains allows quick integration of the PayPal Website Payment Pro (PayPal Direct Payment API) payment gateway, within the system. By mentioning a few details in the interface and your Business PayPal account, you can safely and securely collect money from your Customers and Sub-Resellers.
The advantage of using this payment gateway is that your Customers/Sub-Resellers do not get redirected to some Payment Gateway website, when they add funds to their account or pay you online. The system simply collects all Credit Card details from your Customers/Sub-Resellers over SSL and sends all the variables via an API Call to the PayPal Server, to get the transaction authenticated.
Before you Start
Ensure that you have a Business PayPal account only. You can not integrate a Personal PayPal account with the system.
Login to your Business PayPal account. 1
Click the Merchant Services tab.
Click the Learn more link under the PayPal Payments Pro section.
Click the Get Started! button.
Complete the process to activate this Gateway.
At this point, your account will undergo an approval process by PayPal, that generally takes 2-3 days. Once your application to activate Website Payments Pro has been approved, you need to accept the Billing Agreement (Anchor: billing):
Login to your Business PayPal account. 2
Click the Merchant Services tab.
In the top right corner, click Accept Billing Agreement.
Login to your Business PayPal account. 3
Click the Profile link under the My Account tab.
Click the API Access link under the Account Information section.
Click the Request API Credentials link.
Select the Request API signature radio button and click the Agree and Submit button.Note
Do not click the Request API certificate radio button instead.
If you have created an API Certificate, you need to remove it by clicking the Remove button. Confirm the deletion by clicking the Remove button again.
Click the Done button to complete the process
Authorize your API Username to make API calls through your Reseller Account (Anchor: apikey)
Login to your Business PayPal account. 4
Click the Profile link under My Account.
Click the Add or edit API permissions link.
Click the Add New Permission button.
Click the Configure a custom API authorisation. link.
In the textbox besides Partner API Username mention the API Username you created in the above-mentioned instructions.
Click the checkbox besides the following calls and click the Submit button:
Click the Give Permission button.
Login to your Reseller Control Panel. 5
In the Menu, point to Settings -> Finance & Billing -> Payment Gateway and then click List / Add.
Click the Add a Gateway link.
Click the Add a PayPal Direct Payment API Gateway link.
Enter the following details and save your changes by clicking the Submit button:
Gateway Name: This represents the name that would be displayed to your Customers/Sub-Resellers, choose to pay online and choose from the available payment gateways that you have configured.
Credit Card Payment
PayPal Username: The Username (typically email address) you use to login into your PayPal Business account.
API Username: This is the same API Username you generated in the above-mentioned instructions.
API Password: This is the same API Password you generated in the above-mentioned instructions.
API Signature: This is the same Signature you generated in the above-mentioned instructions.
Currency: PayPal allows you to charge your Customers/Sub-Resellers in 22 different Currencies. Select the Currency from the drop-down menu:
US Dollar (USD)
United Kingdom Pound (GBP)
Canadian Dollar (CAD)
Japanese Yen (JPY)
Australian Dollar (AUD)
Swiss Franc (CHF)
Czech Koruna (CZK)
Danish Krone (DKK)
Hong Kong Dollar (HKD)
Hungarian Forint (HUF)
Norwegian Kroner (NOK)
New Zealand Dollar (NZD)
Polish Zloty (PLN)
Swedish Krona (SEK)
Singapore Dollar (SGD)
Mexican Pesos (MXN)
Brazilian Real (BRL)
Malaysian Ringgits (MYR)
Philippine Pesos (PHP)
Taiwan New Dollars (TWD)
Thai Baht (THB)
The Currency selected here should match the Currency that you have set within your PayPal account.Additional Information
Currency Exchange Rate: If your Selling Currency differs from USD, we will have to convert the Order Value to the PayPal Currency before we send your Customer/Sub-Reseller to PayPal. For this purpose the system needs an exchange rate between the two.
You may choose to maintain this exchange rate yourselves or let us maintain it for you. We download FOREX rates on a daily basis from a recognized source and update exchange rates for you. If however you wish to update the rates yourselves then you may do so by selecting the I would like to Maintain the currency exchange rate myself checkbox and entering your own conversion rates.
Select the types of CREDIT CARDS that your merchant account supports: You need to select the types of Credit Card that are supported by your PayPal Account. The credit card types available are - Visa, MasterCard, American Express and Discover. You can also decide the sequence in which you want your Customers / Sub-Resellers to view these Card types on the payment page.
Payment Gateway Access Level for Customers and Sub-Resellers: Select appropriate Access Levels for your Customers / Sub-Resellers.Additional Information
Deciding whether a Sub-Reseller and Customer is Credited with the Gross Amount or Net: PayPal deducts a fee per transaction. There are two types of Transactions that can pass through your PayPal integration - Invoice/Debit Note Payment and Add Funds.Additional Information
In case of an Add Funds Transaction, you have the option of crediting your Customers/Sub-Resellers with the Net Amount that PayPal credits you with, or choose to credit them with the Gross funds and bear the charges yourselves.
Send me a Reminder if a transaction is pending for more than x days: In case you have not yet accepted a payment sent to you via the PayPal Payment Gateway, you can get e-mail reminders sent to you daily after x number of days from the payment date, until you either Approve or Decline these payments.Additional Information
Display Position: If you plan on adding Multiple Gateways you can select the position in which you wish to display this Gateway on your Payment Page.
PayPal's Legal mandate requires you to continue using the PayPal Standard Checkout Gateway.Additional Information
The SuperSite contains information about the various Payment options you offer to your Customers and also presents these options at the time of purchasing Products and Services. This data is downloaded to your SuperSite from your Control Panel and cached (stored) on the SuperSite Server. The cache of your SuperSite will be reloaded automatically, once you have completed the above process. This way, the updated details will be downloaded to your SuperSite from your Control Panel.Additional Information
- 1. Paypal account Login to Apply for the Website Payment Pro Payment Gateway
- 2. Paypal account Login for Accepting the Billing Agreement
- 3. Paypal account Login for Generating API Credentials
- 4. Paypal account Login for Authorizing your API Username to make API calls through your Reseller Account
- 5. Login instructions for Adding PayPal Direct Payment API Gateway in your Reseller Account