Paypal贝宝使用指南

　　网站专业版收款
　　---------------
　　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/webscr?cmd=_express-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）