用PHP開發(fā)Paypal支付接口.doc

PayPal 快速、安全而又方便，是跨國交易的首選在線付款方式?，F(xiàn)在PayPal可以和國內(nèi)大部分信用卡關(guān)聯(lián),可以實現(xiàn)國人的跨國交易收支。申請PayPal注冊網(wǎng)址：/paypal接口與其它接口有些不同，稍微復(fù)雜一點(diǎn)。 其實銀行接口也算是一個站點(diǎn)的插件。所謂paypal ipn（Instant Payment Notification），就是Paypal開發(fā)的一種能主動通知第三方賣家系統(tǒng)交易狀態(tài)的一種機(jī)制。IPN的原理很簡單，就是當(dāng)產(chǎn)生了一個交易之后， 交易狀態(tài)發(fā)生變化時，如用戶已經(jīng)付款、或者退款、撤銷時，Paypal利用常用的HTTP POST方式，將交易的一些變量提交給網(wǎng)站的某個頁面（稱之為IPN Handler），當(dāng)這個頁面接受到請求時候，將這些數(shù)據(jù)原封不動加上一個指示驗證的cmd=_notify-validate，POST回Paypal 的接口地址，如果數(shù)據(jù)正確，那么Paypal返回字符串VERIFIED，否則為INVALID，如果結(jié)果為VERIFIED，那么你的程序就可以使用這 些數(shù)據(jù)進(jìn)行操作。開設(shè)Sandbox帳號但代碼的調(diào)試是一件很痛苦的事情，因為作為第三方開發(fā)人員，不可能開兩個帳號，每次測試還要之間交 易一些錢，所以Paypal專門開發(fā)了Sandbox給開發(fā)人員進(jìn)行開發(fā)，首先到/ 注冊一個開發(fā)帳號，好了之后再進(jìn)入Sandbox建立測試用的Paypal虛擬帳號（至少應(yīng)該建立一個Business的和一個Personal的），這 種賬號注冊方法和Paypal的流程一樣，信息可以是假的，包括銀行帳號、信用卡（其實Paypal Sandbox會自動生成一些隨機(jī)的號碼）。接下來需要激活Paypal Sandbox的虛擬帳號，注意，這里不管你在Paypal Sanbox注冊時填什么郵件地址，有任何發(fā)送到虛擬帳號所填郵箱的郵件都存會在開發(fā)帳號的管理界面中的Email頁（導(dǎo)航欄上有）中。登錄 Sandbox的虛擬Paypal環(huán)境，還需要驗證虛擬帳號的銀行，這里可以隨便填，然后通過Add Funds來給賬戶充值（想填多少填多少 920-203 920-533 ）。然后，還需要激活I(lǐng)PN的選項，在Business的那個賬戶的Profile設(shè)置頁面中，點(diǎn)擊，然后點(diǎn) 擊Edit按鈕，打開IPN，這里如果你使用的是固定的IPN Handle，可以直接將地址填入。接下來，我們測試的時候，應(yīng)該將Paypal接口的地址設(shè)置為 /cgi-bin/webscr基本的流程當(dāng)客戶向您付款時，PayPal將向位于指定 URL (type=”hidden” name=”notify_url” value=” “)的服務(wù)器發(fā)送一個通知。此通知中將包括您的客戶的所有付款信息（例如，客戶名稱、金額），以及一段加密代碼。當(dāng)服務(wù)器收到通知時，它隨后會將該信息 （包括加密代碼）發(fā)送回安全的PayPal URL。PayPal將通過檢查加密字符串對交易進(jìn)行身份驗證。這種將 IPN 數(shù)據(jù)傳回PayPal的操作防止了“欺騙”，因此您可以確保 IPN 來自PayPal。在進(jìn)行驗證時，PayPal會將其合法性的確認(rèn)信息發(fā)送回您的服務(wù)器。提示：要啟用即時付款通知，您將需要輸入一個 URL，通過它您可以接收到來自您的用戶信息的通知。啟用了即時付款通知后，每次當(dāng)您接收付款時您的服務(wù)器都會收到一個通知，此通知將以隱藏的 “FORM POST”的方式發(fā)送到指定的 URL，并將包括所有付款信息。此頁面的底部列出了通知的 FORM 變量。每次收到來自PayPal的 IPN 時，您必須在實施訂單之前完成如下所述的通知確認(rèn)過程。確認(rèn)列出的信息將可確保交易合法。通知確認(rèn)IPN為了確保付款已進(jìn)入您的PayPal賬戶，您必須驗證 用作“receiver_email”的電子郵件地址是否已在您的PayPal賬戶中注冊并得到確認(rèn)。服務(wù)器收到即時付款通知后，您將需要通過構(gòu)建一個發(fā)送到PayPal的 HTTP POST 對其進(jìn)行確認(rèn)。您的 POST 應(yīng)發(fā)送到 /cgi-bin/webscr您必須完全按照收到表單變量時的原樣發(fā)送所有收到的表單變量。您還需要將一個值為 “_notify-validate”的名為“cmd”變量（例如，cmd=_notify-validate）附加到 POST 字符串。PayPal將回復(fù)該 POST，并在回復(fù)的正文中包含一個單詞“VERIFIED”或“INVALID”。當(dāng)您收到 VERIFIED 回復(fù)時，您需要在實施訂單之前執(zhí)行若干檢查： 確認(rèn)“payment_status”為“Completed”，因為系統(tǒng)也會 為其他結(jié)果（如“Pending”或“Failed”）發(fā)送 IPN。 檢查“txn_id”是否未重復(fù)，以防止欺詐者重復(fù)使用舊的已 完成的交易。 驗證“receiver_email”是已在您的PayPal賬戶中注冊的電子郵件地址，以防止將付款發(fā)送到欺詐者的賬 戶 。 檢查其他交易詳情（如物品號和價格），以確認(rèn)價格未改變完成了以上檢查后，您可以使用 IPN 數(shù)據(jù)更新您的數(shù)據(jù)庫，并處理購物。如果收到“無效” 通知，則應(yīng)將其視為可疑通知，并應(yīng)對其進(jìn)行調(diào)查。主要參數(shù)：向PayPal提交粘貼代碼時，應(yīng)包括以下 4 個隱藏變量及一張圖片，這就是說，您粘貼到PayPal的最短必需代碼應(yīng)如下：12345678 / _xclick 立即購買 /PayPal賬戶上的電子郵件地址 /物品名稱（或購物車名稱） /定義幣種以標(biāo)示貨幣變量 值可以為 USD、EUR、GBP、CAD、JPY。 /物品的價格（購物車中所有物品的總價格,因為是_Xclick模式）可用變量business 您的PayPal賬戶上的電子郵件地址quantity 物品數(shù)量。大于 1 時，會與金額相乘item_name 物品名稱（或購物車名稱）。必須是字母數(shù)字字符，最多為 127 個字符item_number 用于跟蹤付款的可選傳遞變量。必須是字母數(shù)字字符，最多為 127 個字符amount 物品的價格（購物車中所有物品的總價格）shipping 該物品的運(yùn)送成本shipping2 每增加一件物品所需的運(yùn)送成本handling 手續(xù)費(fèi)tax 基于交易的稅額。如果使用該變量，傳遞值將覆蓋所有用戶信息稅收設(shè)置（不管買家所在位置）。no_shipping 送貨地址。如果設(shè)為 1，則不會要求您的客戶提供送貨地址。該變量為可選項；如果省略或設(shè)為 0，將提示您的客戶輸入送貨地址cn 可選標(biāo)簽，會在提示欄上顯示（最多 40 個字符）no_note 為付款加入提示。如果設(shè)為 1，則不會提示您的客戶輸入提示。該變量為可選項；如果省略或設(shè)為 0，將提示您的客戶輸入提示。on0 第一選項欄名稱。最多 64 個字符os0 第一組選項值。最多 200 個字符。on0 必須定義，以便識別 os0。on1 第二選項欄名稱。最多 64 個字符os1 第二組選項值。最多 200 個字符。on1 必須定義，以便識別 os1。custom 決不會向您的客戶顯示的可選轉(zhuǎn)遞變量?？捎糜诟櫞尕沬nvoice 決不會向您的客戶顯示的可選轉(zhuǎn)遞變量?？捎糜诟欃~單號notify_url 僅與 IPN 一起使用。發(fā)送 IPN Form Post 的互聯(lián)網(wǎng) URLreturn 您的客戶完成付款后將返回的互聯(lián)網(wǎng) URLcancel_return 您的客戶取消付款后將返回的互聯(lián)網(wǎng) URLimage_url 您要用作圖標(biāo)的圖片的互聯(lián)網(wǎng) URL，圖片大小為 150 X 50 像素cs 設(shè)置您的付款頁面的背景色。如果設(shè)為 1，背景色將為黑色。該變量為可選項；如果省略或設(shè)為 0，背景色將為白色擴(kuò) 展變量PayPal 允許您粘貼擴(kuò)展變量，條件是將改變以下 cmd 值：到：通過上述 “cmd” 值修改，您還可使用以下變量：擴(kuò)展變量email 客戶的電子郵件地址first_name 客戶的名。必須是字母數(shù)字字符，最多為 32 個字符last_name 客戶的姓。必須是字母數(shù)字字符，最多為 64 個字符address1 客戶地址所在國家或地區(qū)。必須是字母數(shù)字字符，最多為 100 個字符address2 客戶地址第二行。必須是字母數(shù)字字符，最多為 100 個字符city 客戶地址所在城市。必須是字母數(shù)字字符，最多為 100 個字符state 客戶地址所在州。必須是正式的 2 個字母縮寫zip 客戶地址的郵政編碼night_phone_a 客戶夜間聯(lián)系電話號碼的區(qū)號night_phone_b 客戶夜間聯(lián)系電話號碼前三位day_phone_a 客戶白天聯(lián)系電話號碼的區(qū)號day_phone_b 客戶白天聯(lián)系電話號碼前三位提示：若要更改”用戶信息”中的默認(rèn)運(yùn)費(fèi)和手續(xù)費(fèi)設(shè)置，請轉(zhuǎn)至您的用戶信息，編輯您的運(yùn)費(fèi)計算，然 后點(diǎn)擊”允許采用基于交易的運(yùn)費(fèi)”復(fù)選框。將單個物品傳遞給PayPal如果您的第三方購物車可設(shè)置成向PayPal傳遞單個物品，有關(guān)物品的信息將加入買家和賣 家的記錄日志和系統(tǒng)通知中。要加入該物品的信息，您需要將 HTML 格式元素粘貼至PayPal購物車流程的新版本。該過程與 #1 節(jié)將總購物車數(shù)量傳遞給PayPal描述的非常相似，不同之處在于：將 cmd 變量設(shè)置到 _cart更換必要的 HTML 行與添加稱為 “upload” 的新變量在 和 標(biāo)簽之間新增以下行：定義物品明細(xì)對于以下各特定物品參數(shù)，定義與通過您的合作商購物車購買的各物品對應(yīng)的一組新值。將 “_x” 附加到變量名稱，其中 x 是物品號碼，從 1 開始，每加入一物品增加一。item_name_x （物品 #x 需要）購物車中物品 #x 的名稱。必須是字母數(shù)字字符，最多為 127 個字符item_number_x 與購物車中物品 #x 關(guān)聯(lián)的可選傳遞變量。必須是字母數(shù)字字符，最多為 127 個字符amount_x （物品 #x 需要）物品 #x 的價格shipping_x 運(yùn)送物品 #x 的第一件（數(shù)量 1）的成本shipping2_x 每增加一件運(yùn)送物品 #x（數(shù)量 2 或更多）所需的運(yùn)送成本handling_x 物品 #x 的處理成本on0_x 物品 #x 的第一選項欄名稱。最多 64 個字符os0_x 物品 #x 的第一組選項值。最多 200 個字符?！眔n0_x” 必須定義，以便識別 “os0_x”。on1_x 物品 #x 的第二選項欄名稱。最多 64 個字符os1_x 物品 #x 的第二組選項值。最多 200 個字符?！眔n1_x” 必須定義，以便識別 “os1_x”。為購物車中每件物品重復(fù)此設(shè)定為您的買家購物車中的各物品加入以上 表格中的一組必需的變量和任何選項變量。購物車中的第一物品必須用以 “_1 結(jié)束的參數(shù)定義，如 “item_name_1、”amount_1 等。同樣，第二物品應(yīng)用變量 “item_name_2、”amount_2 等命名。提示：”_x” 值必須以一為單位按序遞增，以便識別。如果從 item #1 跳到 item #3 而不定義 item #2，則第三個物品會被忽略。要指定幣種：所有貨幣變量（金額、運(yùn)費(fèi)、運(yùn)費(fèi) 2、手續(xù)費(fèi)、稅款）將以粘貼在付款上的 “currency_code” 變量指定的幣種顯示。因為其不是隨物品不同的，無需向變量名稱附加 “_x”。如果沒有粘貼 “currency_code” 變量，我們將假定所有貨幣變量值為美元。PayPay APIPayPal提供了多個API接口供開發(fā)者使 用。在使用API之前，你必須先申請一個高級個人賬戶或者企業(yè)賬戶，同時你必須獲取API 憑證供每次調(diào)用API 時使用。一旦你獲取了API憑證，您就可以調(diào)用相關(guān)的API接口了。目前，我們提供兩種API接口方 式，NVP和SOAP。一般來說我們推薦您使用 NVP 接口。? Name-Value Pair（NVP）接口 請求和響應(yīng)都是使用簡單的HTTP。該接口簡單易實現(xiàn)，適合于初級開發(fā)者和需要快速完成集成的人員；? SOAP接口 - 請求和響應(yīng)都是通過SOAP來完成。該接口適合于面向?qū)ο蠊こ痰拈_發(fā)；PayPal API：NVP（名稱/值對）接口通過NVP API接口， 您只需給PayPal發(fā)送一個HTTP請求，并通過“名稱=值”的形式指定請求參數(shù)，即可充分利用PayPal的API功能。NVP API 是 PayPal 的業(yè)務(wù)功能、風(fēng)險管理和業(yè)務(wù)邏輯的簡單接口。NVP API 最基本的使用方法是通過到 PayPal 服務(wù)器的 HTTPS 連接發(fā)送一個 NVP 字符串，然后處理響應(yīng)（也是一個 NVP 字符串）。執(zhí)行 NVP API 調(diào)用的基本步驟如下：? 為特定的 API 方法構(gòu)造一個請求參數(shù)字符串。? 通過 HTTPS 連接向 PayPal 服務(wù)器發(fā)送這個參數(shù)字符串。? 處理服務(wù)器響應(yīng)中的 NVP。每個NVP API請求字符串包含有API用戶名、API密碼、所要調(diào)用API的名稱及用來標(biāo)識交易的令牌，如： USER=&PWD=mypassword &METHOD=GetExpressCheckoutDetails&TOKEN=EC-23T233ZP3DFB.成功的應(yīng)答包含以下要素：ACK=Success ，以及一個用來標(biāo)識交易的唯一令牌。 ACK=Success&TIMESTAMP=date/timeOfResponse &CORRELATIONID=debuggingToken&VERSION=2.300000&BUILD=buildNumber &TOKEN=EC-3DJ78083ES565113B&EMAIL= &PAYERID=95HR9CM6D56Q2&PAYERSTATUS=verified &FIRSTNAME=John&LA