添加PayPal購物車結賬功能詳解
2013-06-24 09:21:14 (8989)
將您的第三方購物車與PayPal的付款流程集成目前有兩種方法。第一種方法是傳遞購物車付款總額，而不是單個物品金額。第二種方法是將所選物品詳情傳遞給PayPal，而不是總購物車數量。提示：按下述步驟粘貼必需的變量到PayPal時，可能需要在您的網站上執行某些腳本。
如果願意，您可以累加整個購物車，將總數量傳遞給PayPal的 立即購買按鈕代碼（也就是說，您需要粘貼整個購物車的單一名稱及其物品總價款，與購買單件物品一樣）。
該方法有一個不足之處，您的買家將無法查看其購物車中的單個物品。此外，您不能修改我們的變量名稱，也不能添加您自己的變量名稱。
查閱以下信息後如有其他技術問題，請訪問我們的 開發者服務網頁。欲知有關“立即購買”按鈕代碼或以下變量的附加信息，請查看網站付款標準版集成指南 （PDF，4.6 MB，2008 年 3 月）。
必需的變量
向PayPal提交粘貼代碼時，應包括以下 4 個隱藏變量及一張圖片：
|
必需的變量
|
|
姓名
|
值
|
|
business
|
您的PayPal賬戶上的電子郵件地址
|
|
item_name
|
物品名稱（或購物車名稱）
|
|
currency_code
|
定義幣種以標示貨幣變量（金額、運送費、運送費 2、手續費、稅款）。值可以為 "USD"、"EUR"、"GBP"、"CAD"、"JPY"。
|
|
amount
|
物品的價格（購物車中所有物品的總價格）
|
|
image
|
按鈕圖片，您的買家按此按鈕開始PayPal付款程序。您可以將 src 更換為圖片 URL，以使用您自己的圖片
|
|
這就是說，您粘貼到PayPal的最短必需代碼應如下：
<form action="https://www.paypal.com/cgi-bin/webscr" method="post">
<input type="hidden" name="cmd" value="_xclick">
<input type="hidden" name="business" value="you@youremail.com">
<input type="hidden" name="item_name" value="Item Name">
<input type="hidden" name="currency_code" value="USD">
<input type="hidden" name="amount" value="0.00">
<input type="image" src="http://www.paypal.com/zh_XC/i/btn/x-click-but01.gif" name="submit" alt="請使用PayPal付款 —— 快捷、免費和安全的付款方式！">
</form>
|
|
PayPal 提供附加變量，用於自定義您的 Form Post。所有可用變量如下（變量名稱必須用小寫）：
|
可用變量
|
|
姓名
|
值
|
|
business
|
您的PayPal賬戶上的電子郵件地址
|
|
quantity
|
物品數量。大於 1 時，會與金額相乘
|
|
item_name
|
物品名稱（或購物車名稱）。必須是字母數字字符，最多為 127 個字符
|
|
item_number
|
用於跟蹤付款的可選傳遞變量。必須是字母數字字符，最多為 127 個字符
|
|
amount
|
物品的價格（購物車中所有物品的總價格）
|
|
shipping
|
該物品的運送成本
|
|
shipping2
|
每增加一件物品所需的運送成本
|
|
handling
|
手續費
|
|
tax
|
基於交易的稅額。如果使用該變量，傳遞值將覆蓋所有用戶信息稅收設置（不管買家所在位置）。
|
|
no_shipping
|
送貨地址。如果設為 "1"，則不會要求您的客戶提供送貨地址。該變量為可選項；如果省略或設為 "0"，將提示您的客戶輸入送貨地址
|
|
cn
|
可選標簽，會在提示欄上顯示（最多 40 個字符）
|
|
no_note
|
為付款加入提示。如果設為 "1"，則不會提示您的客戶輸入提示。該變量為可選項；如果省略或設為 "0"，將提示您的客戶輸入提示。
|
|
on0
|
第一選項欄名稱。最多 64 個字符
|
|
os0
|
第一組選項值。最多 200 個字符。"on0" 必須定義，以便識別 "os0"。
|
|
on1
|
第二選項欄名稱。最多 64 個字符
|
|
os1
|
第二組選項值。最多 200 個字符。"on1" 必須定義，以便識別 "os1"。
|
|
custom
|
決不會向您的客戶顯示的可選轉遞變量。可用於跟蹤存貨
|
|
invoice
|
決不會向您的客戶顯示的可選轉遞變量。可用於跟蹤賬單號
|
|
notify_url
|
僅與 IPN 一起使用。發送 IPN Form Post 的互聯網 URL
|
|
return
|
您的客戶完成付款後將返回的互聯網 URL
|
|
cancel_return
|
您的客戶取消付款後將返回的互聯網 URL
|
|
image_url
|
您要用作圖標的圖片的互聯網 URL，圖片大小為 150 X 50 像素
|
|
cs
|
設置您的付款頁麵的背景色。如果設為 "1"，背景色將為黑色。該變量為可選項；如果省略或設為 "0"，背景色將為白色
|
|
擴展變量
PayPal 允許您粘貼擴展變量，條件是將改變以下 "cmd" 值：
|
<input type="hidden" name="cmd" value="_xclick">
|
|
到：
<input type="hidden" name="cmd" value="_ext-enter">
<input type="hidden" name="redirect_cmd" value="_xclick">
|
|
通過上述 "cmd" 值修改，您還可使用以下變量：
|
擴展變量
|
|
姓名
|
值
|
|
email
|
客戶的電子郵件地址
|
|
first_name
|
客戶的名。必須是字母數字字符，最多為 32 個字符
|
|
last_name
|
客戶的姓。必須是字母數字字符，最多為 64 個字符
|
|
address1
|
客戶地址所在國家或地區。必須是字母數字字符，最多為 100 個字符
|
|
address2
|
客戶地址第二行。必須是字母數字字符，最多為 100 個字符
|
|
city
|
客戶地址所在城市。必須是字母數字字符，最多為 100 個字符
|
|
state
|
客戶地址所在州。必須是正式的 2 個字母縮寫
|
|
zip
|
客戶地址的郵政編碼
|
|
night_phone_a
|
客戶夜間聯係電話號碼的區號
|
|
night_phone_b
|
客戶夜間聯係電話號碼前三位
|
|
|
|
|
day_phone_a
|
客戶白天聯係電話號碼的區號
|
|
day_phone_b
|
客戶白天聯係電話號碼前三位
|
|
|
|
|
提示：若要更改“用戶信息”中的默認運費和手續費設置，請轉至您的用戶信息，編輯您的運費計算，然後點擊“允許采用基於交易的運費”複選框。
如果您的第三方購物車可設置成向PayPal傳遞單個物品，有關物品的信息將加入買家和賣家的記錄日誌和係統通知中。要加入該物品的信息，您需要將 HTML 格式元素粘貼至PayPal購物車流程的新版本。該過程與 #1 節“將總購物車數量傳遞給PayPal”描述的非常相似，不同之處在於：
-
將 "cmd" 變量設置到 "_cart"
更換必要的 HTML 行
|
<input type="hidden" name="cmd" value="_xclick">
|
|
與
|
<input type="hidden" name="cmd" value="_cart">
|
|
-
添加稱為 "upload" 的新變量
在 <表格> 和 </表格> 標簽之間新增以下行：
|
<input type="hidden" name="upload" value="1">
|
|
-
定義物品明細
對於以下各特定物品參數，定義與通過您的合作商購物車購買的各物品對應的一組新值。將 "_x" 附加到變量名稱，其中 x 是物品號碼，從 1 開始，每加入一物品增加一。
|
姓名
|
值
|
|
item_name_x
|
（物品 #x 需要）購物車中物品 #x 的名稱。必須是字母數字字符，最多為 127 個字符
|
|
item_number_x
|
與購物車中物品 #x 關聯的可選傳遞變量。必須是字母數字字符，最多為 127 個字符
|
|
amount_x
|
（物品 #x 需要）物品 #x 的價格
|
|
shipping_x
|
運送物品 #x 的第一件（數量 1）的成本
|
|
shipping2_x
|
每增加一件運送物品 #x（數量 2 或更多）所需的運送成本
|
|
handling_x
|
物品 #x 的處理成本
|
|
on0_x
|
物品 #x 的第一選項欄名稱。最多 64 個字符
|
|
os0_x
|
物品 #x 的第一組選項值。最多 200 個字符。"on0_x" 必須定義，以便識別 "os0_x"。
|
|
on1_x
|
物品 #x 的第二選項欄名稱。最多 64 個字符
|
|
os1_x
|
物品 #x 的第二組選項值。最多 200 個字符。"on1_x" 必須定義，以便識別 "os1_x"。
|
|
-
為購物車中每件物品重複此設定
為您的買家購物車中的各物品加入以上表格中的一組必需的變量和任何選項變量。購物車中的第一物品必須用以 "_1" 結束的參數定義，如 "item_name_1"、"amount_1" 等。同樣，第二物品應用變量 "item_name_2"、"amount_2" 等命名。提示："_x" 值必須以一為單位按序遞增，以便識別。如果從 item #1 跳到 item #3 而不定義 item #2，則第三個物品會被忽略。
要指定幣種：所有貨幣變量（金額、運費、運費 2、手續費、稅款）將以粘貼在付款上的 "currency_code" 變量指定的幣種顯示。因為其不是隨物品不同的，無需向變量名稱附加 "_x"。如果沒有粘貼 "currency_code" 變量，我們將假定所有貨幣變量值為美元。
查閱以下信息後如有其他技術問題，請訪問我們的開發者支持網頁。欲知有關購物車代碼或以下變量的其他信息，請查看網站付款標準版集成指南
本文版权：
http://www.ndfweb.cn/news-677.html
