|
Add / Modify a PayPal Direct Payment API Gateway
TelNex Technologies
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 Sub-Resellers and Customers.
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 OrderBox
Control Panel itself.
Account Sign-up and Settings
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
(for US Business PayPal accounts only)
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:
- Login to your PayPal account [must be a Business account] from
https://www.paypal.com.
- Click the Merchant Tools tab.
- From the Dropdown select Website
Payment Pro.
- On the bottom of the right column, under
Getting Started, click
on Submit Application.
- Complete the 2 page form.
- 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:
- Click the Merchant Tools tab.
- In the top right corner, click Accept Billing Agreement.
- Click Agree.
-
Allow TelNex Technologies's
PayPal API Name to make API calls on your account:
- Login to your PayPal
account from https://www.paypal.com.
- Click on Profile -> API Access -> API Access Authorization / Authorize API
Access / API Authorizations.
- Click on Add.
- Mention the API Account
Name as paypal_api1.myorderbox.com.
- Enable API Access for the following calls and click on 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 55 countries. The complete list of these countries
is available at
http://www.paypal.com/cgi-bin/webscr?cmd=_display-approved-signup-countries-outside.
Adding the PayPal Direct
Payment API Gateway into your Reseller account
This
consists of the following simple steps -
-
Login into your Reseller Control Panel from
http://storefront.telnex.com/reseller.
-
Click on the Settings -> Finance & Billing -> Payment Gateway ->
List / Add.
-
Click on the Add Payment Gateway button and then on the
Add a PayPal Direct Payment API Gateway link.
-
Enter the following details and Save your changes by clicking on 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.
IMPORTANT
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, 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:
Click here to know
more about the Payment Gateway Transaction types and Access Levels for your Customers and
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.
Click here to know
more about the Payment Gateway Transaction types and Access Levels for your Customers and
Sub-Resellers >>
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
across to you from our system, after every x number of days, until you either
Approve or Decline these payments.
Click here to
know how to Approve / Decline Payment Gateway transactions >>
-
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.
IMPORTANT
1.
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 on Tools -> Reload SuperSite
& PartnerSite Cache -> SuperSite Payment Preferences.
Click
here to know what is SuperSite >>
2. After you have setup the above, you
must
setup a PayPal Standard Checkout
Gateway as well, as per the Legal guidelines mentioned by PayPal.
Click here to
know how >>
|