User Tools

Site Tools


Sidebar

admin_menu:payments:payment_gateways:cc_paypal_pro:start

CC - Paypal Pro [S]

In order to use PayPal Pro, your server must meet certain minimum requirements, and you must have a Paypal Pro account with Payapl.

Configure

When you click Configure the settings below will be displayed:

Require Admin Approval

Account Status

Paypal API Username

Your API Username, which is automatically generated by Paypal when you apply for a digital certificat to use the PayPal Web Services API. You can see this value on https://www.paypal.com in your profile under API Access > API Certificate Information

Paypal API Password

Your API Password, which you specify when you apply for a digital certificate to use the PayPal Web Services API.

Paypal API Signature

This feature added in Geo 4.1.0

The API signature issued by PayPal. To ensure security for your customers and your business, an API Signature issued by PayPal is required for use of the PayPal Web Services API. To obtain a PayPal Web Services API username, password, and signature, you must first create a Business or Premier account and apply online at https://www.paypal.com

You can choose to use the API Signature, or the API Certificate File, but not both. If you fill in this setting, leave Path to certificate blank, and visa versa.

Path to certificate

The FULL path (including the file name) to your PayPal-issued digital certificate. To ensure security for your customers and your business, a public certificate and private key issued by PayPal are required for use of the PayPal Web Services API. The certificate file is in PEM format and contains both your private key and your public certificate. To obtain a PayPal Web Services API username, password, and digital certificate, you must first create a Business or Premier account and apply online at https://www.paypal.com

For convenience, a directory is already set aside for your PayPal-issued digital certificate. After placing the certificate in the recommended directory listed to the right, copy and paste the file path in the text box above and make sure the name of the file at the end of the file path matches the name of your PayPal-issued digital certificate.

Paypal Currency Codes

PayPal-Supported Currencies and their Maximum Transaction Amounts:

  • AUD Australian Dollar 12,500 AUD
  • CAD Canadian Dollar 12,500 CAD
  • EUR Euro 8,000 EUR
  • GBP Pound Sterling 5,500 GBP
  • JPY Japanese Yen 1,000,000 JPY
  • USD U.S. Dollar 10,000 USD

You must manually set any

Character Set

Select which charset to use. A character set is a computer representation of all the individual possible letterforms or word symbols of a language. Listed are PayPal-Supported character sets:

  • ISO 8859-1 - West European languages (Latin-1) ISO 8859-1 is currently the most widely used.
  • US ASCII - This set of 128 English characters were established by ANSI X3.4-1986 and is slowly being phased out due to it's limitations to the English language.
  • UTF-8 - Unicode Transformation Format-8. It is an octet (8-bit) lossless encoding of Unicode characters.

User Registration Requirements

There are certain requirements for user's fields needed to use the PayPal Pro website. Lucky for you, the new Listing Cart will collect this data on the checkout page, so if you don't collect this data when a user registers, it should still work. See below for a list of required user fields:

  • First Name
  • Last Name
  • Street Address
  • City
  • State/Province (Sub-Region will need to be set up as states/provinces in order to use this gateway)
  • Country (Main Regions will need to be set up as countries, with the proper "country codes" as specified below, in order to use this gateway)
  • Zip/Postal Code

User Country Codes

In your Regions, you will need to configure them as Countries using the following country codes in order to use this gateway. Note that you only need 1 of these regions to work, and the regions you do specify must be in this list.

Anguilla AI Ecuador EC Japan JP Singapore SG
Argentina AR Finland FI Luxembourg LU South Korea KR
Australia AU France FR Malaysia MY Spain ES
Austria AT Germany DE Mexico MX Spain ES
Belgium BE Greece GR Monaco MC Spain ES
Brazil BR Hong Kong HK Netherlands NL Turkey TR
Canada CA Iceland IS Switzerland CH United Kingdom GB
Chile CL India IN Thailand TH United States US
China CN Ireland IE Taiwan TW Uruguay UY
Costa Rica CR Israel IL New Zealand NZ
Denmark DK Italy IT Norway NO Venezuela VE
Dominican Republic DO Jamaica JM Portugal PT

Server Setup Procedures (Server Requirements)

The following is required on your server to be able to use PayPal Pro. Note that at the bottom of info when you click "Configure" for PayPal Pro will have tests for each of these requirements to see if your server meets them. If they do not, you will need to contact your host about enabling them.

PHP Extensions

If you are unsure how to install any of these extensions, see your server administrator.

  • PHP Perl Compatible Regular Expressions extension for PHP 4.3.0+ and higher
  • PHP cURL extension for PHP 4.3.0+ and higher with SSL support
  • PHP OpenSSL extension for PHP 4.3.0+ and higher (for digital certificate transcoding)

PEAR Libraries

If you are unsure how to install any of these packages, see your server administrator.

  • Main PEAR Library
  • PEAR Net_URL
  • PEAR Net_Socket
  • PEAR HTTP_Request
  • PEAR Log

Debug FAQ's

I'm seeing errors from the gateway. What do they mean? If you see an error generated when trying to use this gateway you can check what the error means against the API documentation provided by Paypal here:

https://developer.paypal.com/webapps/developer/docs/classic/api/errorcodes/
admin_menu/payments/payment_gateways/cc_paypal_pro/start.txt · Last modified: 2014/09/25 16:55 (external edit)