PayPal-Python 项目技术文档

1. 安装指南

环境要求

• Python 2.6 或 2.7

安装方式

你可以通过以下几种方式安装 paypal-python 包：

1. 使用 pip 安装：

   pip install paypal
   

2. 使用 easy_install 安装：

   easy_install paypal
   

3. 手动安装：

   • 下载源码包并解压。
   • 进入 paypal-python 目录。
   • 运行以下命令进行安装：

     python setup.py install
     

2. 项目的使用说明

快速开始

1. 安装 nose 测试框架：

   pip install nose
   

2. 运行测试套件：

   nosetests tests/
   

3. 核心功能位于 paypal.interface 模块中。文档位于代码的 docstrings 和测试文件中。

4. 创建 paypal.interface.PayPalInterface 对象，并传递配置参数。可以参考 tests.interface_factory.get_interface_obj 中的示例。

5. 通过该接口访问 PayPal 服务。查看 paypal.interface 中已实现的方法。

3. 项目API使用文档

接口对象创建

from paypal.interface import PayPalInterface

# 创建 PayPalInterface 对象
paypal_interface = PayPalInterface(
    API_USERNAME='your_api_username',
    API_PASSWORD='your_api_password',
    API_SIGNATURE='your_api_signature',
    API_ENVIRONMENT='sandbox'  # 或 'live'
)

主要方法

• do_direct_payment(kwargs): 处理信用卡支付。
• set_express_checkout(kwargs): 设置 PayPal Express Checkout。
• get_express_checkout_details(kwargs): 获取 Express Checkout 详情。
• do_express_checkout_payment(kwargs): 完成 Express Checkout 支付。

示例

# 示例：使用 do_direct_payment 方法
response = paypal_interface.do_direct_payment(
    paymentaction='Sale',
    creditcardtype='Visa',
    acct='4111111111111111',
    expdate='112020',
    cvv2='123',
    firstname='John',
    lastname='Doe',
    street='123 Main St',
    city='San Jose',
    state='CA',
    zip='95131',
    countrycode='US',
    amt='10.00'
)

print(response)

4. 项目安装方式

通过 pip 安装

pip install paypal

通过 easy_install 安装

easy_install paypal

手动安装

1. 下载源码包并解压。
2. 进入 paypal-python 目录。
3. 运行以下命令进行安装：

   python setup.py install
   

5. 支持与帮助

如果你有任何问题或建议，可以在项目的 issue tracker 上提交问题。

6. 附加说明

沙盒账户设置

1. 创建沙盒账户，不要使用你的真实 PayPal 账户邮箱。
2. 登录沙盒。
3. 在“Test Accounts”中选择“Preconfigured”。
4. 创建一个“Seller”账户。
5. 不要更改“login email”。
6. 使用默认的数字密码，并将其保存以便后续使用。
7. 选择 Visa 作为信用卡。
8. 设置银行账户为“Yes”。
9. 向账户中存入 $1,000 的虚拟资金。
10. 创建账户。
11. 在“Test Accounts”页面中，点击“Enter Sandbox Test Site”。
12. 登录并接受商户服务中的“Website Payments Pro”的账单协议。

7. 许可证

该项目基于 Apache License 2.0 许可证发布。