PayPal快速结帐NVPAPI开发指南.pdf

《PayPal快速结帐NVPAPI开发指南.pdf》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、PayPal快速结账NVPAPI开发指南1PayPal快速结账NVPAPI开发指南概览以下列出了本文件中用到的专门术语的英文缩写和全称ECExpressCheckoutNVPName-ValuePairIPNInstantPaymentNotificationAPIApplicationProgrammingInterfacePayPalNVPAPI简介PayPalNVPAPI是简单的编程接口，允许您（商家）使用PayPal的业务功能来执行以下操作：使用“快速结账”功能在您的网站上接受PayPal结账。使用“直接付款”功能向信用卡

2、收费。捕获先前通过“快速结账”、“直接付款”或“网站付款标准版”授权的付款。重新授权或作废以前的授权。使用“集中付款”功能向一位或多位收款人付款。发放全额退款或多笔部分退款。使用开始日期或其他条件搜索交易。查看特定交易的明细。PayPalNVPAPI能够简化向网络应用程序添加PayPal的过程。您构建NVP字符串并使用HTTPS将其发布到PayPal服务器。然后PayPal发回一个NVP格式的响应。NVP格式NVP是指定字符串中的名称和值的一种方法。NVP是表示URI规范中的查询的非正式名称。NVP字符串附加到URL上。N

3、VP字符串符合以下准则：名称和值用等号(=)分隔。例如：FIRSTNAME=Robert名称/值对用与号(&)分隔。例如：FIRSTNAME=Robert&MIDDLENAME=Herbert&LASTNAME=MooreNVP字符串中每个字段的值已经过URL编码。2PayPal快速结账NVPAPI开发指南请求格式每个NVP请求都由必需的和可选的参数及其值组成。参数名称不区分大小写。本文档中的示例使用大写参数名称，并将参数分为必需的安全参数和正文参数。USER=apiUsername&PWD=apiPassword&SIGNAT

4、URE=apiSignature&SUBJECT=optiona&ThirdPartyEmailAddress&VERSION=84.0以下参数始终是必需的：必需的安全参数USERPWDSIGNATUREVERSION注意：示例采用如下方式显示必需的安全参数：[requiredSecurityParameters]正文参数&METHOD=methodName&otherRequiredAndOptionalParametersAPI凭证必需的安全参数：API凭证参数值定义USER必需您的PayPalAPI用户名。PWD必需您的PayP

5、alAPI密码。SIGNATURE可选您的PayPalAPI签名字符串。如果您使用API证书，请勿包括该参数。重要信息：您必须在实施过程中保护USER、PWD和SIGNATURE的值。可考虑将这些值存储在安全的位置（而不是存储在Web服务器的文档根目录），并设置文件权限，以便只有执行您的电子商务应用程序的系统用户才能够访问。要访问PayPalAPI，您需要可标明您身份的API凭证（API签名或API证书）。获取API的方法请参照文档。在运行于PayPalSandbox测试环境的示例程序中使用以下示例API签名和密码。注意：如果使用示例

6、代码，则该签名已存在于代码中的配置文件中（文件名类似Constants.*）。本节描述PayPalNVPAPI所用技术的细节。响应格式ACK=Success&TIMESTAMP=date/timeOfResponse&CORRELATIONID=debug成功响应字段gingToken&VERSION=84.0&BUILD=buildNumber[successResponseFields]&NAME1=value1&NAME2=value2&NAME3=value3API响应字段3PayPal快速结账NVPAPI开发指南每个响应都包

7、含ACK字段。如果ACK字段的值是Success或SuccessWithWarning，您就应处理API响应字段。对于成功的响应，您可忽略BUILD字段之前的所有字段（包括BUILD字段）。重要字段在BUILD字段之后开始。有关每种方法可能的成功响应字段，请参阅附录A“NVPAPI方法和字段参考”。如何处理这些字段取决于您调用的特定API方法，例如为用户填写表格、更新数据库，等等。错误响应如果ACK值为Error或Warning，就不会返回API响应字段。错误响应具有以下一般格式。ACK=Error&TIMESTAMP=date/ti

8、meOfResponse&可能返回多CORRELATIONID=debuggingToken&VERSION=84.0&个错误。每BUILD=buildNumber&L_ERRORCODE0=errorCode&组错误都