Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/gtaylor/paypal-python

Unofficial implementation of the now-old PayPal NVP APIs in Python
https://github.com/gtaylor/paypal-python

Last synced: 13 days ago
JSON representation

Unofficial implementation of the now-old PayPal NVP APIs in Python

Awesome Lists containing this project

README 

        
PayPal-Python

=============



:Author: Pat Collins

:Maintainer: Greg Taylor

:License: Apache v2

:Status: Stable

:Maintained: Quasi-maintained, looking for new maintainer (file issue if interested)



This package implements Paypal's Website Payments Pro NVP API in Python.

This currently includes Direct Payments (Credit card payments without a PayPal

Account) and PayPal Express Checkout (Payment via a PayPal account).



This module is best used in conjunction with the

official PayPal `documentation`_. The stuff under

"Website Payments Pro and Express Checkout API Operations". in particular.



paypal-python does no real validation, doesn't hold hands, and is generally

only going to handle authentication, http-level stuff, and serializing

a list of keyword arguments passed to the API methods. You'll need to

read the official PayPal documentation for what key/values to pass.



.. _documentation: https://cms.paypal.com/us/cgi-bin/?cmd=_render-content&content_ID=developer/howto_api_reference



*NOTE: This module is not created by, endorsed by, or in any way affiliated

with PayPal.*



Requirements

------------



* Python 2.6 or 2.7



Installation

------------



Through pip::



    pip install paypal



or easy_install::



    easy_install paypal



or download the source, un-tar/un-zip it, cd into paypal-python, and::



    python setup.py install



Quick Start

-----------



To run test suite, do from within the paypal-python directory::



    pip install nose

    nosetests tests/



The meat is in paypal.interface. The docs are in the docstrings and tests.



* Create a paypal.interface.PayPalInterface object

* Pass it configuration kwargs (See tests.interface_factory.get_interface_obj

  for a good example of how this works).

* That interface is how you access PayPal. Take a look at the currently

  implemented methods in paypal.interface.



Support/Help

------------



If you have any problems, questions, or ideas, feel free to post on our

`issue tracker`_.



.. _issue tracker: http://github.com/gtaylor/paypal-python/issues



Addendum A

----------



Instructions for setting up a Sandbox Website Payments Pro account. More

detailed instructions can be found at [x.com](http://x.com) but this is what

worked for me.



1. Create Sandbox account. Don't use your live PayPal account email address.

2. Login to Sandbox

3. Test Accounts -> "Preconfigured" -- the manual process sucks.

4. Make a "Seller" account

5. Don't change "login email" at all -- it seems to truncate to 6 characters.

6. I took the numeric password they gave as default and copy/pasted it into a

   plain text document so I could use it later to make all my test account

   passwords the same.

7. I chose Visa as the credit card.

8. Bank Account = "Yes" -- This is needed for a Verified account, which is

   needed for Website Payments Pro.

9. Put $1,000 of fake $$ into the account. At one point I tried $5,000 but

   the test account I created wasn't Verified automatically? Not sure if the

   two are related.

10. No notes.

11. "Create Account"

12. When it takes you back to the "Test Accounts" screen, it should say

    "Business" and "Verified"

13. When you click on "API Credentials" you should see API credentials for the

    corresponding test account you just created. I copy/pasted them into the

    same text file used above.



The next step was the tricky part, at least for me. I was getting `10501`

errors which means the billing agreement wasn't agreed to. Apparently you need

to accept the fake billing agreement that comes along with the fake account you

just created, which semi-conveniently has come packaged with an automatically

created and verified fake bank account and business account "verified" status.

Why couldn't the billing agreement be automatically "agreed to" as well?



Back on the "Test Accounts" page, choose the account you just created and click

"Enter Sandbox Test Site." It should populate the fake email address, which

should be `[email protected]`. Use the copy/pasted password from

step #6 and paste it into the password field and login.



Now go under Merchant Services -> Website Payments Pro. In the right column

there should be a link to "agree" to the billing agreement. Click this link and

agree to the agreement. Now your API calls will work as expected.



LICENSE

-------



::



    Copyright 2009 Pat Collins 

    Copyright 2012 DUO Interactive, LLC 

    Copyright 2014 Greg Taylor



    Licensed under the Apache License, Version 2.0 (the "License");

    you may not use this file except in compliance with the License.

    You may obtain a copy of the License at



        http://www.apache.org/licenses/LICENSE-2.0



    Unless required by applicable law or agreed to in writing, software

    distributed under the License is distributed on an "AS IS" BASIS,

    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

    See the License for the specific language governing permissions and

    limitations under the License.