当前位置: 代码迷 >> Paypal >> Paypal高速支付接口参数的含义
  详细解决方案

Paypal高速支付接口参数的含义

热度:10533   发布时间:2013-02-26 00:00:00.0
Paypal快速支付接口参数的含义

Paypal快速支付接口优化了支付流程,可以最大程度上进行风险控制,提高了安全性,可以尽可能减少商家无必要的损失!以下是快速支付接口整理。
一、SetExpressCheckout

请求
必选参数:


1.??? AMT格式为100.00
2.??? RETURNURL
3.??? CANCELURL
4.??? METHOD


可选参数


1.??? CURRENCYCODE,默认USD
2.??? EMAIL结账时输入的买家电子邮件。PayPal使用该值预填PayPal 登录页面的PayPal会员注册部分。
3.??? INVNUM您自己的唯一账单号或跟踪号。
4.??? NOSHIPPING值1表示在PayPal页面上不应显示任何送货地址字段。? 默认值:0
5.??? TOKEN一个时间戳标记,您凭此向PayPal表明自己正通过“快速结账”功能处理这笔付款。
6.??? LOCALECODE? “快速结账”过程中PayPal所显示页面的区域设置。CN默认US
7.??? PAGESTYLE设置与该按钮/链接相关的付款页面的“自定义付款页面样式”。
8.??? HDRIMG您希望在付款页面左上角显示的图片的URL。
9.??? PAYMENTACTION希望获取付款的方式:Sale,Authorization,Order
10.??? DESC客户所购物品的描述。
11.??? L_NAMEn物品名称
12.??? L_NUMBERn物品号
13.??? L_QTYn物品数量


响应


1.??? TOKEN如果您在SetExpressCheckout请求中设置该标记, 则响应中该标记的值与请求中的值相同。
注:
您从SetExpressCheckout收到成功响应后,请将SetExpressCheckout响应中的TOKEN作为名称/值对添加到以下URL,并将您客户的浏览器跳转至该URL:
https://www.paypal.com/cgi-bin/webscr?cmd=_express-checkout& token=value_from_SetExpressCheckoutResponse 要将客户的浏览器跳转至PayPal登录页面,PayPal建议您使用HTTPS响应302“对象已移动”,并将上面的URL作为HTTPS响应中的 Location标题的值。请确保使用启用了SSL的服务器,以防止由于混合了安全和不安全图片而使浏览器发出警告。
二、GetExpressCheckoutDetails

请求


必选参数


1.??? METHOD? API的名称:GetExpressCheckoutDetails
2.??? TOKEN时间戳标记,其值由SetExpressCheckout


响应


1.??? TOKEN
2.??? EMAIL付款人的电子邮件地址。
3.??? PAYERID唯一的PayPal客户账户识别号。
4.??? PAYERSTATUS 付款人的状态。有效值有: verified unverified
5.??? SALUTATION 付款人的称呼。
6.??? FIRSTNAME 付款人的名。
7.??? ...
三、DoExpressCheckoutPayment(付款)

请求


1.??? METHOD API的名称:DoExpressCheckoutPayment
2.??? TOKEN由SetExpressCheckout响应返回并通过GetExpressCheckoutDetails请求传递的时间戳标记值。
3.??? PAYMENTACTION Sale表示这是您正进行收款的最终销售。
4.??? PAYERID GetExpressCheckoutDetails响应返回的唯一PayPal客户账户识别号。
5.??? AMT 订单金额合计,包括运费、手续费和税金。
6.??? INVNUM您自己的账单号或跟踪号。
7.??? NOTIFYURL 您用来接收有关该交易的即时付款通知(IPN)的URL。
8.??? L_NAMEn 物品名称。
9.??? L_NUMBERn 物品号。


响应


1.??? TOKEN
2.??? TRANSACTIONID 付款的唯一交易号。
3.??? TRANSACTIONTYPE 交易的类型,可能的值:cart和express-checkout
4.??? PAYMENTTYPE 指示是即时付款还是延迟付款。none,echeck,instant
5.??? ORDERTIME 付款的时间/日期戳
6.??? AMT 收取的最终金额,包括您“商家用户信息”中的任何运费和税金。
7.??? CURRENCYCODE “PayPal支持的交易币种”中所列币种之一的三字符币种代码。
8.??? FEEAMT对交易收取的PayPal费用金额
9.??? SETTLEAMT 币种兑换后存入您PayPal账户中的金额。
10.??? TAXAMT 对交易收取的税金。
11.??? EXCHANGERATE 进行币种兑换时所用的汇率。只有以非主要币种结算时才适用。
12.??? PAYMENTSTATUS 付款的状态: Completed:付款已完成,资金已成功注入您的账户余额中。 Pending:付款待处理。有关详细信息,请参见PendingReason
13.??? PENDINGREASON 付款待处理的原因:
??? none:无待处理原因
??? address:付款待处理的原因是,客户未提供经确认的送货地址,而且您的“收款习惯设定”设为每笔付款均需手动接受或拒绝。若要更改习惯设定,请前往“用户信息”的“习惯设定”部分。
??? echeck:付款待处理的原因是:通过电子支票付款,而电子支票尚未结清。
??? intl:付款待处理的原因是:您持有非美国账户,且不具备提现功能。您必须在“账户信息”页面中手动接受或拒绝此笔付款。
??? multi-currency:所发送的币种没有余额,并且未将“收款习惯设定”设为自动兑换和接受付款。您必须手动接受或拒绝此付款。
??? verify:付款待处理的原因是:您尚未获得认证。您必须认证您的账户才能接受此付款。
??? other:付款待处理非上述原因所致。欲知更多信息,请联系PayPal客户服务。
14.??? REASONCODE撤销原因(TransactionType为reversal时):
??? none:无原因代码
??? chargeback:由于客户提出退单,因此撤销这笔交易。
??? guarantee:由于客户启动退款担保,因此撤销这笔交易。
??? buyer-complaint:由于客户对交易提出投诉,因此撤销这笔交易。
??? refund:由于您向客户退款,因此撤销这笔交易。
??? other:交易的撤销非上述原因所致。