paypal的即時付款通知參數列表(PDT)


其中主要參數是 tx=x9E67578X9184704L , 這是此次交易的標志ID,可以利用腳本來依照此ID獲取當前交易的信息,發送查詢后,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

授權金額。

 

 

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM