|
变量名 |
可能的值 |
描述 |
长度 |
|
address_city |
客户地址中的市/县。 |
40 |
|
|
address_country |
客户地址中的国家或地区。 |
64 |
|
|
address_country_code |
两位ISO 3166国家或地区代码。 |
2 |
|
|
address_name |
用于地址的名称（在客户提供礼品地址时包含在内）。 |
128 |
|
|
address_state |
客户地址中的省/直辖市/自治区。 |
40 |
|
|
address_status |
Confirmed Unconfirmed |
客户提供的是已确认的地址。 客户提供的是未确认的地址。 |
|
|
address_street |
客户的街道地址。 |
200 |
|
|
address_zip |
客户地址中的邮政编码。 |
20 |
|
|
first_name |
客户的名。 |
64 |
|
|
last_name |
客户的姓。 |
64 |
|
|
payer_business_name |
客户的公司名称，如果客户代表企业。 |
127 |
|
|
payer_email |
客户的主要邮件地址。 使用该电子邮件提供所有信用记录。 |
127 |
|
|
payer_id |
唯一客户号。 |
13 |
|
|
payer_status |
verified unverified |
客户有已认证的PayPal账户。 客户有未认证的PayPal账户。 |
|
|
residence_country |
两位ISO 3166国家或地区代码。 |
2 |
|
变量名 |
描述 |
长度 |
|
business |
收款人（即商家）的电子邮件地址或账户号。 如果付款发送至主账户，则等于receiver_email，尤其指“网站付款”按钮HTML代码中传递的business变量的返回值。 |
127 |
|
item_name |
由您（商家）传递的物品名称。 如果不是由您传递，则由您的客户输入。 如果是购物车交易，PayPal 将附加物品号（例如， item_name1 、 item_name2 ）。 |
127 |
|
item_number |
您用于跟踪购买的传递变量。在付款完成时，它会传回给您。如果省略，则将没有变量传回给您。 |
127 |
|
quantity |
由您的客户输入或由您（商家）传递的数量。 如果是购物车交易，PayPal将附加物品号（例如，quantity1、quantity2）。 |
|
|
receiver_email |
收款人（即商家）的主要邮件地址。 如果付款不是发送到PayPal账户上的主要邮件地址，则receiver_email依旧是主要邮件地址。 |
127 |
|
receiver_id |
收款人（即商家）的唯一账户号。这与收款人的推荐号相同。 |
13 |
|
变量名 |
描述 |
长度 |
|
custom |
由您（商家）传递的自定义值。在任何情形下，都不会向您的客户显示这些传递变量。 |
255 |
|
invoice |
可供您用来识别此次购物的帐单号码的转递变量。 如果省略，则没有变量传回。 |
127 |
|
memo |
您的客户在PayPal网站付款提示栏中输入的备忘信息。 |
255 |
|
option_name1 |
选项1名称（由您申请）。 |
64 |
|
option_name2 |
选项2名称（由您申请）。 |
|
|
option_selection1 |
选项1选择（由客户输入）。 |
200 |
|
option_selection2 |
选项2选择（由客户输入）。 |
|
|
tax |
对付款收取的税费金额。 |
2 |
|
变量名 |
可能的值 |
描述 |
|
auth_id |
Transaction-specific |
授权识别号。 |
|
auth_exp |
Transaction-specific |
授权失效日期和时间。 |
|
auth_status |
Completed Pending Voided |
授权状态。 |
|
mc_gross_x |
Transaction-specific for multiple currencies |
所示金额所用币种为mc_currency ，其中x为购物车明细物品号。mc_gross_x总和应等于mc_gross。 |
|
mc_handling_x |
Transaction-specific for multiple currencies |
x代表购物车明细物品号。由于mc_handling变量中还包含handling_cart 整个购物车范围内的网站付款变量，因此mc_handling_x总和不一定等于mc_handling。 |
|
num_cart_items |
如果此交易是PayPal购物车交易，则为购物车中的物品数。 |
|
|
option_name1 |
PayPal将附加物品号，其中x代表购物车明细物品号（例如，option_name1、 option_name2）。 |
|
|
option_name2 |
PayPal将附加物品号，其中x代表购物车明细物品号（例如，option_name2、 option_name2）。 |
|
|
option_selection1_x |
PayPal将附加物品号（例如，option_selection1 、 option_selection2），其中x代表购物车明细物品号。 |
|
|
option_selection2_x |
PayPal将附加物品号，其中x代表购物车明细物品号（例 如，option_selection1、option_selection2）。 |
|
|
parent_txn_id |
在退款、撤销或取消撤销的情况下，该变量包含原定交易的txn_id，而txn_id包含新交 易的新识别号。 字符长度和限制：17。 |
|
|
payment_date |
PayPal生成的时间/日期戳记。 格式：“ 18:30:30 Jan 1, 2000 PST ”。 |
|
|
payment_status |
Canceled-Reversal Completed Denied Expired Failed In-Progress Partially-Refunded Pending Processed Refunded Reversed Voided |
Canceled-Reversal：这意味着已经取消了 撤销。例如，您在与客户的争议中获胜，先前撤销的交易资金已退回给您。 Completed：付款已完成，资金已成功增加到您的账户余额中。 Denied：您拒绝了付款。只有该款项此前因。PendingReason元素说明的可能 原因而待付时，才会发生此类情况。 Expired：这个授权已经过期，无法捕获。 Failed：付款失败。只有当付款来自于客户的银行账户时，才会发生此类情况。 In-Progress：这笔交易处于授权认证中。 Partially-Refunded：这笔交易被部分退款。 Pending：款项待付。请查看PendingReason了解更多信息。 Refunded：您退还了付款。 Reversed：付款由于扣款索偿或其他撤销类型而撤销。资金已从您的账户余额中扣除，并 已退还给买家。reason_code变量指明了撤销原因。 Processed：付款已被接受。 Voided：此授权无效。 |
|
payment_type |
echeck instant |
echeck：该款项通过电子支票支付。 instant：该项付款通过PayPal余额、信用卡或即时转帐支付。 |
|
pending_reason |
address authorization echeck intl multi-currency unilateral upgrade verify other |
只有在payment_status=Pending时，才会设置此变量。 address：款项待付，原因是客户未提供已确认的送货地址，而您的收款习惯设定设为允许 手动接受或拒绝每笔此类付款。若要更改习惯设定，请前往您的用户信息中的习惯设定部分。 authorization：您在SetExpressCheckoutRequest 上设置了<PaymentAction> Authorization</PaymentAction> ，而尚未获取资金。 echeck：款项待付，原因是其通过电子支票付款，而电子支票尚未结清。 intl：款项待付，原因是您持有非美国账户，且没有提现机制。您必须在账户信息中手动接受 或拒绝该笔付款。 multi-currency：您在发送的货币中没有余额，并且未将收款习惯设定设为自动兑 换和接受付款。您必须手动接受或拒绝该笔付款。 unilateral：款项待付，原因是付款的接收电子邮件地址尚未注册或确认。 upgrade：款项待付，原因是其通过信用卡付款，因此您必须将账户升级为企业账户或高级 账户状态，方可接收资金。upgrade也可能表示您已达到账户的月交易限额。 verify：款项待付，原因是您尚未经过认证。您必须先认证您的账户，才能接受该笔付款。 other：款项待付，原因非以上所列各项。若要了解更多信息，请与贝宝客户服务联系。 |
|
reason_code |
chargeback guarantee buyer-complaint refund other |
只有在payment_status = Reversed 或Refunded时，才会设置此变量。 chargeback：由于客户提出扣款索偿，因此撤销这笔交易。 guarantee：由于客户触发退款担保，因此撤销这笔交易。 buyer-complaint：由于客户就交易提出投诉，因此撤销这笔交易。 refund：由于您向客户退款，因此撤销这笔交易。 other：由于上述原因以外的其他原因，撤销这笔交易。 |
|
remaining_settle |
Transaction-specific |
可以捕获的剩余金额。 |
|
tax |
PayPal将附加物品号（例如，item_name1、item_name2 ）。只有对个别购物车物品收取特定税费时，才会在其中包含tax_x变量。由于可能对购物车中其他物品收取用户信息税费，因此tax_x的总和不一定等于 tax。 |
|
|
transaction_entity |
auth reauth order payment |
授权。 |
|
txn_id |
PayPal系统生成的唯一交易号。 字符长度和限制：17。 |
|
|
txn_type |
cart express_ checkout merch_pmt send_money virtual_ terminal web-accept |
cart：交易由客户通过“PayPal购物车”功能创 建。 send-money：交易由客户从PayPal网站上的付款选项卡中创建。 web-accept：交易由客户通过“立即购买”、“捐赠”或“竞拍”智能标识创建。 |
|
auth_amount |
Transaction-specific |
授权金额。 |
