Paypal付款按钮变量列表

变量cmd的值

cmd的值说明
_xclick表示该按钮为“立即购买”或“捐赠”按钮。
_xclick_subscription表示该按钮为“订阅”按钮。
_cart表示为“购物车”相关按钮。
s_x-click表示该按钮为加密按钮。

用于IPN的变量:notify_url

 

变量名说明必填/选填字段长度
notify_url用于接受PayPal发送的关于即时付款通知的交易信息的URL,必须是有效的URL。选填255

表单变量:物品信息

变量名说明必填/选填字段长度
amount购物价格或金额,不包括运费、手续费或税费。如果在“立即购买”或者“捐赠”交易情况下省略,则由客户在购买时填写此值。
•   立即“购买”或者“捐赠”交易情况下是选填。
•   “购物车”交易情况下是必填。
请参考本行说明 
item_name物品描述。如果在“立即购买”或者“捐赠”交易情况下省略,则客户将看到一个可以选择输入物品名称的栏目。
•  立即“购买”或者“捐赠”交易情况下是选填。
•  “购物车”交易情况下是必填。
请参考本行说明127
item_number可用于跟踪购买或捐赠的传递变量,在付款完成时传回给您。如果在“立即购买”或者“捐赠”交易情况下省略,则将没有变量传回给您。选填127
quantity物品数量。将金额、运费和税费乘以数量将得出付款总额。如果这是购物车交易,PayPal将附加物品数量(例如,quantity1、quantity2)。
提示:数量的值必须是正整数,不允许为空、零或负数。
选填 
undefined_quantity如果设置为1,则允许买家修改数量。
提示:这个变量只允许在“立即购买”或者“捐赠”交易情况下使用。购物车交易不允许使用。
选填1
on0第一选项栏名称,如果省略,则将没有变量传回给您。选填64
on1第二选项栏名称,如果省略,则将没有变量传回给您。选填64
os0第一组选项值。如果此选项通过文本框或单选按钮选中,则每个值均应不超过64个字符。如果该值由客户通过文本框输入,则上限为200个字符。如果省略,则不会传回给您任何变量。
提示:必须对on0进行定义,才能识别os0。
选填
请参考本行说明
64or200
os1第二组选项值。如果此选项通过文本框或单选按钮选中,则每个值均应不超过64个字符。如果该值由客户通过文本框输入,则上限为200个字符。如果省略,则不会传回给您任何变量。
提示:必须对on1进行定义,才能识别os1。
选填
请参考本行说明
64or200

表单变量:显示信息

名字说明必填/选填字段长度
add添加一个物品到PayPal购物车。
若“add”和“display”两个变量同时设置,则只显示当前购物车信息。
必填1
cancel_return指在付款取消的情况下,客户浏览器返回到的URL。例如,您的网站上显示“付款已取消”页面的URL。如果省略,则用户将被带到PayPal网站。选填 
cbt设置“PayPal付款完成”页面上的“继续”按钮的文本。
提示:return 变量也需要被设置。
选填60
cn提示栏上的标签。该值不保存,而且不会出现在任何给您的通告中。如果省略,则将没有变量传回给您。选填40
cpp_header_image将您选择的图片设置为显示在付款页面的左上角。该图片的最大尺寸为750像素宽、90像素高。有效的字符集为URL安全字符。由于图片不存储在我们的数据库上,所以cpp_header_image变量没有字符限制。建议您只提供存储在安全(https)服务器上的图片。选填无限制
cpp_headerback_color为付款页面标题设置背景色。有效的字符集为6字符HTML十六进制ASCII代码。此变量不区分大小写。选填 
cpp_headerborder_color设置付款页面标题四周的边框颜色。边框是位于标题空间四周,粗细为2像素的方框,方框最大尺寸为750像素宽、90像素高。有效的字符集为6字符HTML十六进制ASCII代码。此变量不区分大小写。选填 
cpp_payflow_color为付款页面的标题以下区域设置背景色。有效的字符集为6字符HTML十六进制ASCII代码。此变量不区分大小写。
提示:不允许使用与贝宝错误信息相冲突的背景色,默认颜色为白色。
选填 
cs设置您的付款页面的背景色。如果设为“1”,背景色将为黑色。如果省略或设为“0”,背景色则为白色。选填 
display显示当前PayPal购物车的物品信息。
若“add”和“display”两个变量同时设置,则只显示当前购物车信息。
选填1
image_url您希望在PayPal付款页面左上角的用作标识的150×50像素图片的URL。必须是有效的URL。
如果省略,则客户看到的是您的商家名称(如果您有企业账户)或您的电子邮件地址(如果您有高级账户)。
选填 
no_note为付款加入说明。如果省略或设为“0”,则会提示您的客户输入说明。如果设为“1”,则不会提示您的客户输入说明。选填1
no_shipping买家的送货地址。
省略或设为0=提示客户输入收货地址。
1=不要求客户提供收货地址。
2=客户必须提供收货地址。
选填1
page_style为与此按钮/链接相关的付款页面设置“自定义付款页面的样式”。
page_style的值与添加或编辑页面样式时您选择的页面样式名称相同。
page_style变量的最大长度为30个字符。
有效的字符集只能为小写7位字母数字ASCII字符,加下划线。不能包含空格。
如果您希望按钮/链接始终引用您设置为首选的样式,请将该变量设置为“primary”。
如果您希望该按钮/链接始终引用默认的贝宝页面样式,请将该变量设置为“paypal”。
选填30
return指完成付款后客户的浏览器返回到的URL 。例如,在您的站点上显示“感谢您的付款”的页面的URL。 如果省略,则您的买家将被带到PayPal 网站。选填 
rm付款完成后的返回URL的行为(“返回方法”)。
提示:rm变量只有在return变量被设置后才能生效。
如果省略或为0,则GET方法用于没有启用即时付款通知的所有购物车交易,而POST方法用于所有其他交易。
如果为1并设置了return,则客户的浏览器由GET方法返回至返回URL,并且不提交任何交易变量。
如果为2并设置了return,则客户的浏览器由POST方法返回至返回URL,同时将所有可用交易变量发送至该URL。
选填 

表单变量 : 交易信息

 

名字说明必填 / 选填字段长度
address_override如果设置为1,通过预填充栏传送的地址将会覆盖用户的已存储地址。用户可以看到传送的地址,但是无法进行编辑。
如果地址无效(例如,缺少必需的栏,包括国家或地区)或者没有包括地址,则不会显示地址。
选填1
currency_code付款货币。定义币种以标示货币变量(amount 、shipping 、shipping2 、handling 、tax)
如果省略,则所有货币字段将解释为美元。
选填 
custom永远不会向您的客户显示的传递变量。
如果省略,则不会传回给您任何变量。
选填256
handling手续费。并非根据数量而定。无论所购物品数量多少,均收取相同手续费。
如果省略,则不收取手续费。
选填 
invoice您可以用于识别此次购物的帐单号码的传递变量。
如果省略,则不会传回给您任何变量。
选填127
redirect_cmd只有在cmd 的值为“_ext-enter”,即账户注册的预填充时才有效。
redirect_cmd的唯一有效值是_xclick。
选填40
shipping在您启用了特定于物品的运费时,运送此物品的成本。如果使用了shipping而未定义shipping2,则无论所购物品数量多少,都将收取该固定金额。
提示:如果您使用的是基于物品的运费,请确保选中您的用户信息中的覆盖复选框。
如果省略,并启用了基于用户信息的运费,则将向您的客户收取您的用户信息中定义的金额或百分比。
选填 
shipping2每增加一件物品所需的运送成本。
如果省略,并启用了基于用户信息的运费,则将向您的客户收取您的用户信息中定义的金额或百分比。
选填 
tax基于交易的税费覆盖变量。将该变量设置为您希望应用于交易的固定税额,而不论买家所处的位置。
如果存在,该值将覆盖可能已在您的用户信息中设定的任何税费设置。
如果省略,则适用用户信息税费设置(如有)。
选填 
tax_cart整个购物车的税费,而不是单个物品的税额。选填 

表单变量:购物车特有

 

名字必填/选填说明允许的值
amount必填物品的价格(购物车中所有物品的总价格)。任何有效货币金额
business必填您PayPal账户上的电子邮件地址。您PayPal账户上的
电子邮件地址
handling_cart选填对整个购物车收取的单笔手续费。
如果在多个“添加到购物车”按钮中使用handling_cart,将使用第一件物品的handling_cart值。
任何有效货币金额
item_name必填物品名称(或购物车名称)。 
paymentaction选填指明交易是否是稍后在Paypal官网上通过PayPal授权与捕获进行捕获的授权。 
upload必填上传第三方购物车。1

表单变量:第三方购物车中单个物品的变量

 

名字说明必填/选填字段长度
amount_x物品x的价格。必填 
handling_x物品x的手续费。选填 
item_name_x购物车中的物品x的名称,必须为字母数字字符。必填127
item_number_x可用于跟踪购买或捐赠的传递变量,在付款完成时传回给您, 如果省略,则将没有变量传回给您。选填127
on0_x物品x的第一选项栏名称。选填64
on1_x物品x的第二选项栏名称。选填64
os0_x物品x的第一组选项值。
必须对on0_x 进行定义,才能识别os0_x。
选填200
os1_x物品x的第二组选项值。
必须对on1_x进行定义,才能识别os1_x。
选填200
quantity_x物品x的数量。quantity_x的值必须是正整数,
不允许为空、零或负数。
选填 
shipping_x运送物品x的第一件(数量1)的成本。选填 
shipping2_x每增加一件运送物品x(数量2或更多)所需的运送成本。选填 
tax_x物品x的税额。选填 

 

表单变量:网站付款的预填充变量

 

变量名说明要求字段长度
address1街道(第1栏,共2栏)。字母
数字字符
100
address2街道(第2栏,共2栏)。字母
数字字符
100
city市/县。字母
数字字符
40
country设置运送和开单国家或地区。请查看附录6,以了解允许的国家或地区代码。字母2
email客户的电子邮件地址。字母
数字字符
127
first_name名。字母32
last_name姓。字母32
lc定义买家所在的国家,详细情况请参考“国家或地区ISO3166代码” 。字母2
night_phone_a美国电话号码的区号,或非美国电话号码的国家或地区代码。它会预填充买家的家庭电话。数字3
night_phone_b美国电话号码的3位数前缀,或非美国电话号码的完整电话号码(不包括国家或地区代码)。它会预填充买家的家庭电话。数字3
night_phone_c美国电话号码的4位数电话号码。它会预填充买家的家庭电话。数字4
state省/直辖市/自治区。必须为两个字符
的正式缩写
2
zip邮编。数字32

表单变量 : 账户注册的预填充变量

 

变量名说明要求字段长度
business_address1客户所在的街道。字母
数字字符
128
business_address2客户所在的街道。字母
数字字符
128
business_city客户所在的市/县。字母
数字字符
128
business_state客户所在的省/直辖市/自治区。必须为两个字符的正式缩写2
business_country客户所在的国家。字母2
business_cs_email客户的email地址。字母
数字字符
128
business_cs_phone_a客户的客服电话所在的美国电话号码的区号,或非美国电话号码的国家或地区代码。数字3
business_cs_phone_b客户的客服电话所在的美国电话号码的3位数前缀,或非美国电话号码的完整电话号码(不包括国家或地区代码)。它会预填充买家的家庭电话。数字3
business_cs_phone_c客户的客服电话所在的美国电话号码的4位数电话号码。它会预填充买家的家庭电话。数字4
business_url客户网站的URL。字母
数字字符
必须是有效的
128
night_phone_b美国电话号码的3位数前缀,或非美国电话号码的完整电话号码(不包括国家或地区代码)。它会预填充买家的家庭电话。数字3
business_night_phone_a客户所在的美国电话号码的区号,或非美国电话号码的国家或地区代码。它会预填充买家的家庭电话。数字3
business_night_phone_b客户所在的美国电话号码的3位数前缀,或非美国电话号码的完整电话号码(不包括国家或地区代码)。它会预填充买家的家庭电话。数字3
business_night_phone_c客户所在的美国电话号码的4位数电话号码。它会预填充买家的家庭电话。数字4

相关文章

已有 8 条评论
  1. doudou

    os0 选项,选项里边对应的内容怎么传递不同的价格呢。。。

    doudou 回复
  2. 人体润滑剂

    人等级一上去,就容易缺经验。

    人体润滑剂 回复
  3. 仿真阳具

    人等级一上去,就容易缺经验。

    仿真阳具 回复
  4. 冈本

    正所谓:“一马奔腾,射雕引弓,天地都在我心中!”

    冈本 回复
  5. 虾米

    你用这东西干嘛?{smile:12}{smile:12}{smile:12}

    虾米 回复
    1. 枫叶红秋雨

      @虾米

      @虾米
      肯定有用。没用要他干啥

      枫叶红秋雨 回复
  6. myswty.com

    看了一圈,你的留言由我和垃圾评论组成!

    myswty.com 回复
  7. forherandforhim

    forherandforhim Bridal Gown Bridal Party Special Occasion Garment 和

    forherandforhim 回复
发表新评论