PAYPAL －－集成API接口教程

网站专业版收款

---------------

PayPal网站专业版收款(快速支付)可以让您的客户更快捷、更安全地完成付款。客户可以选择存放在PayPal账户中的配送地址等信息返回给您的网站，这样他们就不需要在您的网站上重复录入，大大节省购物时间；同时，该解决方案是基于API的，每次API调用都需要进行身份认证，所以更加安全。



在整个支付流程中，共需调用三个API接口，流程示意图如下：







实现Express Checkout 共分四步：

◆ 创建带有Express Checkout按钮的购物车页面

当您的客户挑选好商品并被引导到购物车页面时，您即可将Express Checkout按钮添加到购物车页面，如下图红框所示，您也可以将PayPal作为一个支付可选项与其他支付方式并排：





关于PayPal图标位置编排的说明请参考这里。









◆ 引导客户登录到PayPal授权付款

客户点击购物车页面上的Express Checkout按钮后，你必须调用第一个API函数：SetExpressCheckout。调用该函数时可以设置很多参数，但是以下三个参数是必须的：

-- OrderTotal：订单总价，此价格可以是一个订单的估计值；

-- ReturnURL：客户确认相关信息后返回到您网站继续完成付款动作的网址；

-- CancelURL：客户由于不能通过PayPal付款或者取消PayPal付款而返回到您网站的网址，建议设置为带有PayPal Express Checkout按钮的购物车页面或支付页面；该函数将返回一个参数token。此token用于跟踪整个付款过程，在此后两个API函数调用中都必须带上此token。获取token后，重定向客户的网页到PayPal网站，以便客户进行登录并选择付款方式和配送信息；

-- 重定向客户到：https://www.paypal.com/cgi-bin/w ... checkout&token= mytoken

-- 用您从PayPal中获取的token替换上面的mytoken ；



你的客户登录PayPal并选择一个配送地址及付款方式，如下图所示：









注：所有参数可以参考文档



参数参考文挡





◆获取**并确认订单



客户确认配送地址等信息以后，PayPal将引导他们回到您的网站，该返回的地址由函数SetExpressCheckout中所带的参数ReturnURL决定。此时，您即可以通过调用第二个API函数GetExpressCheckoutDetails获取客户的相关信息，并将其显示在订单确认页面上，如下图所示：









当PayPal将您的客户重定向回由ReturnURL指定的网址后，PayPal将在ReturnURL后面附加两个变量：token及PayerID(客户PayPal账户加密后的HASH码)。



• 若ReturnURL没有带参数，如： https://www.myshop.com/checkout

则返回的URL为：

https://www.myshop.com/checkout ?token= EC-0W8920957N684880R&PayerID=TEJ9UFMQHWZRF



• 若ReturnURL已经带有参数，如：https://www.myshop.com/checkout?cart_id=1234

则返回的URL为：

https://www.myshop.com/checkout?cart_id=1234 &token=EC-0W8920957N684880R

&PayerID=TEJ9UFMQHWZRF



当您接收到从PayPal到ReturnURL的POS后，提取出token的值，并将其作为第二个API函数GetExpressCheckoutDetails的参数，该函数的目的就是为了从PayPal处获取客户的相关信息，如配送信息等。该函数返回的内容主要包括：

• PayerID：加密后的客户的PayPal账号，这个值在调用第三个API函数DoExpressCheckoutPayment是必须的；

• Payer：客户的email地址；

• FirstName：客户的名；

• LastName：客户的姓；

• Address：客户的配送地址，该地址是在PayPal中选择或者新增的；

• AddressStatus：客户配送地址的标志。如果该值为Confirmed，则表明该配送地址是经过PayPal认证过的；



将您从PayPal处接收到的客户的姓名及配送信息显示给客户看，以便客户进行确认，在这里你也可以让用户选择配送方式或做一些相应的广告。







◆ 完成付款

客户对订单确认后，即可点击最后付款按钮完成付款动作。这个付款按钮实际上就是通过调用最后一个API函数DoExpressCheckoutPayment完成付款动作。在调用该函数后，PayPal将立即返回一个付款状态，您可以将付款细节及付款状态显示给客户看，如下图所示：







如果付款不成功，您也应该显示类似信息。







▲▲▲相关文档及开发包下载地址：▲▲▲

• Express Checkout Integration Guide(PDF ，HTML)

• Name-Value Pair API Developer Guide and Reference(PDF ，HTML)

• Sandbox User Guide (PDF ，HTML)

[本帖最后由 fancuihui 于 2009-3-13 12:25 编辑]