====== 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 ===== See: [[admin_menu/payments/payment_gateways/start#require_admin_approval|Require Admin Approval]] ==== Account Status ==== See: [[admin_menu/payments/payment_gateways/start#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]] ==== Recommended Path ==== 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/