### PayPal 名值对 (Name-Value Pair) API 开发指南及参考
#### 概述
本文档主要介绍了 PayPal 名值对 (Name-Value Pair, NVP) API 的使用方法及其技术细节，帮助开发者理解如何利用该 API 实现与 PayPal 服务的集成。此 API 提供了一种简单、灵活的方式来发送和接收数据，适用于需要处理在线支付的应用程序。
#### 目标受众
本指南主要面向希望通过使用 PayPal 的 NVP API 来集成支付功能的软件开发者和技术人员。无论你是初学者还是有经验的开发者，都可以从中获得必要的信息和支持来完成集成工作。
#### 修订历史
- **2008年6月**：发布第一版。
#### PayPal NVP API 概览
##### 引入 PayPal NVP API
PayPal NVP API 是一个用于与 PayPal 交互的标准接口，它允许用户通过发送和接收简单的名值对参数来执行各种操作，如查询交易详情、创建付款、退款等。
##### 与 PayPal API 集成的基本步骤
1. **创建 Web 应用**：开发一个可以处理 HTTP 请求的 Web 应用。
2. **获取 API 凭证**：从 PayPal 获取必要的凭证信息（例如 API 用户名、密码、签名）。
3. **创建并发送请求**：
- 使用 POST 方法构建包含必要参数的请求。
- 发送请求到 PayPal 的 API 服务器。
4. **解释响应**：根据响应中的数据来处理业务逻辑或显示给用户。
5. **将应用上线**：
- 设置 PayPal 商家账户。
- 在商家账户中设置 API 凭证。
- 修改代码以适应生产环境。
##### 技术细节
- **请求-响应模型**：所有的交互都是基于请求-响应模型，即客户端发送请求给 PayPal，然后 PayPal 返回响应。
- **请求格式**：请求通常以 URL 编码的形式发送，并且通过 POST 方法提交到指定的 API 服务器端点。
- **响应格式**：响应也是由一系列名值对组成的字符串，可以通过解析这些名值对来获取交易结果或错误信息。
- **使用 HTTPS 发送请求**：为了确保数据的安全性，所有的请求都应使用 HTTPS 协议进行加密传输。
- **API 服务器**：PayPal 提供了不同的 API 服务器用于不同的安全验证方式，例如 API 签名验证和 API 证书验证。
#### 第一章：PayPal NVP API 概览
##### 介绍 PayPal NVP API
PayPal NVP API 是一个强大的工具，用于简化与 PayPal 服务的集成过程。通过使用这个 API，开发者可以轻松地处理诸如支付、退款、订阅管理等常见支付场景。
##### 与 PayPal API 集成
集成 PayPal NVP API 的关键在于正确地构建请求和解析响应。以下是一些基本步骤：
1. **创建 Web 应用**：选择一个支持处理 HTTP 请求的框架或语言来创建 Web 应用。
2. **获取 API 凭证**：访问 PayPal 开发者门户，为你的应用注册并获取必要的 API 凭证。
3. **创建并发送请求**：
- 构建包含必要参数的 POST 请求。
- 将请求发送到正确的 API 服务器端点。
4. **解释响应**：响应是包含名值对的字符串，需要通过编程方式解析这些数据来确定交易状态或错误情况。
5. **应用上线准备**：
- 如果是商业用途，需要设置 PayPal 商家账户。
- 在商家账户中配置 API 凭证。
- 根据生产环境的要求调整代码逻辑。
##### 技术细节
- **请求-响应模型**：所有的交互都遵循请求-响应模型。客户端向 PayPal 服务器发送请求，服务器处理请求后返回响应。
- **请求格式**：请求通常包含一系列名值对，使用 URL 编码格式并通过 POST 方法发送。
- **响应格式**：响应也是一系列名值对组成的字符串，可以使用标准的字符串解析技术来处理。
- **使用 HTTPS**：为了保障通信安全，所有与 PayPal 服务器的交互都必须通过 HTTPS 进行。
- **API 服务器**：
- **API 签名验证服务器**：使用 API 签名验证时，请求会被发送到特定的服务器地址。
- **API 证书验证服务器**：当使用证书验证时，会有不同的服务器地址。
#### 第二章：授权与能力集
在本章节中，我们将进一步探讨如何使用 PayPal NVP API 来管理授权和能力集，这包括但不限于如何处理用户的授权、设置支付限制以及管理支付选项等功能。这部分内容对于实现更高级的支付流程非常关键。
以上内容概述了 PayPal NVP API 的基本原理和使用方法，对于希望利用 PayPal 的强大支付功能的开发者来说，这是一份宝贵的资源。通过遵循本文档提供的指南，开发者可以快速掌握如何利用 PayPal NVP API 来增强其应用程序的功能性和用户体验。
