【收藏】paypal的即时付款通知参数列表对照(PDT)

使用Opencart接入PayPal支付时,老是返回各种错误代码,网上搜到这篇文章,可以找到部分原因和解决方法,包括后台订单状态解释和翻译,收藏一下备用。

以下是原文:

发送查询后,paypal会返回一串格式化信息,通常有以下信息

IPN和PDT变量:买家信息

变量名

可能的值

描述

长度

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

 

IPN和PDT变量:基本信息

变量名

描述

长度

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

 

IPN和PDT变量:高级及自定义信息

变量名

描述

长度

custom

由您(商家)传递的自定义值。在任何情形下,都不会向您的客户显示这些传递变量。

255

invoice

可供您用来识别此次购物的帐单号码的转递变量。
如果省略,则没有变量传回。

127

memo

您的客户在PayPal网站付款提示栏中输入的备忘信息。

255

option_name1

选项1名称(由您申请)。

64

option_name2

选项2名称(由您申请)。

option_selection1

选项1选择(由客户输入)。

200

option_selection2

选项2选择(由客户输入)。

tax

对付款收取的税费金额。

2

 

IPN和PDT变量:购物车信息

变量名

可能的值

描述

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

授权金额。

来源:文章部分内容来自网络,由智能家居指南网整理发布,侵删!

发表评论