Adding / Modifying a PayPal Direct Payment API Gateway

Whois.com Pte Ltd has directly integrated the PayPal API within our system, such that by mentioning a few details in your interface and your Business PayPal account, you can safely and securely collect money from your Customers and Sub-Resellers.

When your Customer/Sub-Reseller decides to pay you through this Payment Gateway, we send all the variables via an API Call to the PayPal Server, to get the transaction authenticated. All this while your Customer/Sub-Reseller continues to remain within their Control Panel itself.

Before you start

You will need to verify/perform the following before you start:

  • Verify that you have a Business PayPal account only. You cannot integrate a Personal PayPal account with our System.

  • Apply for Website Payment Pro account.

    You need to apply for Website Payment Pro account before you can make successful API calls to services such as DirectPayment.

    If you have already been approved for Pro, you also need to accept the Billing Agreement. This is sometimes overlooked by merchants who think they have already accepted this by applying for Pro, but it is indeed a separate step that must be completed after approval. To apply for Website Payment Pro, follow these steps:

    1. Login to your PayPal account [must be a Business account] from https://www.paypal.com.

    2. Click the Merchant Tools tab.

    3. From the dropdown menu, select Website Payment Pro.

    4. On the bottom of the right column, under Getting Started, click Submit Application.

    5. Complete the 2 page form.

    6. Click Go To My Account.

    At this point, your account will undergo an approval process by PayPal that generally takes 2-3 days. Once you have been approved for Website Payments Pro, login back into your PayPal account and complete these steps:

    1. Click the Merchant Tools tab.

    2. In the top right corner, click Accept Billing Agreement.

    3. Click Agree.

  • Allow Whois.com Pte Ltd's PayPal API Name to make API calls on your account:

    1. Login to your PayPal account from https://www.paypal.com.

    2. Point to Profile -> API Access and then click API Access Authorization / Authorize API Access / API Authorizations.

    3. Click Add.

    4. Mention the API Account Name as paypal_api1.myorderbox.com.

    5. Enable API Access for the following calls and click the Save button:

      • RefundTransaction

      • GetTransactionDetails

      • TransactionSearch

      • DoCapture

      • DoVoid

      • DoDirectPayment

      • DoAuthorization

  • Using PayPal Direct Payment API Gateway, you would be able to accept funds from only certain countries.

    Additional Information

    Complete list of these countries

 

Adding the PayPal Direct Payment API Gateway into your Reseller Account

This consists of the following simple steps:

  1. Login to your Reseller Control Panel. 1

  2. In the Menu, point to Settings -> Finance & Billing -> Payment Gateway and then click List / Add.

  3. Click the Add Payment Gateway button and then the Add a PayPal Direct Payment API Gateway link.

  4. Enter the following details and save your changes by clicking the Submit button:

    • Gateway Name: This Gateway Name would be shown to your Customers/Sub-Resellers, when they are about to make Payment. You can use something like Credit Card Payment or Visa/Master Card etc..

    • PayPal Account Username: The Username [e-mail address] you use to login into your PayPal Business account.

    • Currency: PayPal allows you to charge your Customers/Sub-Resellers in 16 different Currencies - US Dollar (USD), United Kingdom Pound (GBP), Euro (EUR), 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) and Singapore Dollar (SGD). Select the Currency from the drop-down menu.

      Note

      The Currency selected here should match the Currency that you have set within your PayPal account.

    • 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 a 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.

    • 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.

      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.

    • 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.

Note
  • 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. Hence, you would need to refresh the cache of your SuperSite once you have completed the above process. You can accomplish this from within your Control Panel itself by clicking Tools -> Reload SuperSite & PartnerSite Cache -> SuperSite Payment Preferences.

    Additional Information

    SuperSite

  • After you have setup the above, you must setup a PayPal Standard Checkout Gateway as well, as per the Legal guidelines mentioned by PayPal.

  1. 1. Login instructions