ps:轉自我自己的簡書
這兩天在研究如何在專案中整合PayPal的iOS SDK 但是百度到的資料很少,研究了兩天拿出來和大家分享下,共同討論共同成長。
這裡以PayPal的官方demo為例,sdk和demo地址在這裡:paypal
- 安裝流程建議使用CocoaPods,喜歡配置依賴庫的小夥伴自行百度
準備事項
- 預先善其事,必先利其器
首先你得註冊個paypal賬號,連賬號都沒有誰給你錢啊
- 登入paypal開發者網站。 點這裡
- 右上角看到了沒有,不上圖了。有賬號的登入,沒賬號的註冊。
- 在上面的 DASHBOARD 頁面下,找到 Creat APP ,點它!建立一個阿啪啪出來。
- 我們來到建立阿啪啪的頁面,這裡需要輸入一個阿啪啪名字以及選擇一個賬戶,名字沒問題,可是這個賬戶怎麼來的?這個稍後說,選上就行了。名字填好後,點選Creat App。
- 來到我們的阿啪啪頁面,這裡是檢視你的應用資訊的地方。右上角分別對應著你的應用的測試模式和真實交易模式,點選切換會看到不同的API CREDENTIALS 內容,分別是在測試模式和真實交易模式下不同的Account、Client ID和Secret。這裡掏出小本本,記下測試模式下的Client ID,之後會用到。
- 接下來,選擇右邊的Sandbox下Accounts選項。Sandbox就是測試環境,其中包含了你的賬戶資訊、通知訊息、交易記錄等等。。(其實我不知道後面那三個幹嘛的,因為沒用到)。 而在現在所看到的Accounts中,你會看到兩個賬號,第一個就是測試模式下,你的商家賬號。在你的阿啪啪中產生的所有虛擬交易,其金額都會流入到這個賬號下。而第二個,不用說你也猜到,就是在虛擬交易中扮演顧客的賬號。右上角可以新增賬號,具體玩法自行摸索,這裡不多說了。
- 輕輕的點下你的商家賬號。彈出的框選擇Profile。展示的是這個賬號的Account Details,第一個就是你的賬號基本資訊,包括你的郵箱、密碼、電話號、賬號型別、狀態和城市。
- 上面的標籤隨便看看就好。其中的 Funding 包含了你的虛擬商家賬號的信用卡資訊和 Balance 我的理解就是paypal餘額。此時Balance 後面應該是沒有餘額的。
- 同樣的,點開顧客賬號的Profile。展示的是你的顧客的賬戶資訊。此時我建議點選Change password修改一個好記的交易密碼。不改的話就是你建立賬號時候的密碼,我猜的。同樣的, Funding 包含了你的虛擬商家賬號的信用卡資訊和 Balance,此時Balance 後面的數字應該是$9999.9。
準備工作基本上是完成了,下面看看如何進行虛擬支付
- 現在我當做你已經把paypal的sdk pod到你的專案中去了。
- 正如所有sdk一樣,一定要做的是事情是什麼??沒錯,就是匯入標頭檔案!!!
- 然後,來到AppDelegate.m檔案的didFinishLaunchingWithOptions
[PayPalMobile initializeWithClientIdsForEnvironments:@{PayPalEnvironmentProduction : @"你的真實交易模式ClientID",PayPalEnvironmentSandbox : @"你的測試模式ClientID"}];
複製程式碼
- 填好你的測試模式ClientID後我們繼續
簡單交代下整合paypal的支付流程:
- 配置paypal SDK連線環境如:測試環境、真實環境
- 配置paypal一些引數如:商家名字、地址選項、商家隱私政策和使用者協議網址等
- 配置支付相關如:訂單總額、貨幣型別和訂單描述等
- 提交訂單,通過代理回撥支付狀態
老司機要開車了,請坐穩
簡單說下原理,paypal的支付並不喚起客戶端,也就是說並不要求使用者安裝 paypal APP,支付的流程產生在paypal的sdk中已經封裝好的VC中。你要做的就是設定引數和彈出paypal的VC以及處理後續的回撥。
天才紙尿褲,我是第一步:
-
首先,我建議你要有一個訂單處理類。你的生成訂單VC傳進訂單總額(有需要的話傳進商品陣列)給訂單處理類,這個類會提供block完成後續的操作如:訂單VC彈出PayPal的VC,支付完成後訂單VCdismiss掉paypal的VC以及使用者取消付款訂單VC處理事情等等。
-
現在就簡單點,先讓訂單VC把所有的事都幹了。
- 配置支付環境
[PayPalMobile preconnectWithEnvironment:PayPalEnvironmentSandbox];
複製程式碼
- 以下是環境說明
/// 真實交易環境-也就是上架之後的環境
extern NSString * _Nonnull const PayPalEnvironmentProduction;
/// 模擬環境-也就是沙盒環境
extern NSString * _Nonnull const PayPalEnvironmentSandbox;
/// 無網路連線環境-具體用處,咳咳,自行摸索
extern NSString * _Nonnull const PayPalEnvironmentNoNetwork;
複製程式碼
第二步:paypal配置
首先讓你的訂單VC有一個屬性
@property(nonatomic, strong) PayPalConfiguration *payPalConfig;
複製程式碼
然後配置它
//是否接受信用卡
_payPalConfig.acceptCreditCards = NO;
//商家名稱
_payPalConfig.merchantName = @"商家名";
//商家隱私協議網址和使用者授權網址-說實話這個沒用到
_payPalConfig.merchantPrivacyPolicyURL = [NSURL URLWithString:@"https://www.paypal.com/webapps/mpp/ua/privacy-full"];
_payPalConfig.merchantUserAgreementURL = [NSURL URLWithString:@"https://www.paypal.com/webapps/mpp/ua/useragreement-full"];
//設定地址選項-在支付頁面可選擇賬戶地址資訊
typedef NS_ENUM(NSInteger, PayPalShippingAddressOption) {
//不展示地址資訊
PayPalShippingAddressOptionNone = 0,
//這個沒試過,自行查閱
PayPalShippingAddressOptionProvided = 1,
//paypal賬號下的地址資訊
PayPalShippingAddressOptionPayPal = 2,
//全選
PayPalShippingAddressOptionBoth = 3,
};
//paypal賬號下的地址資訊
_payPalConfig.payPalShippingAddressOption = PayPalShippingAddressOptionPayPal;
//配置語言環境
_payPalConfig.languageOrLocale = [NSLocale preferredLanguages][0];
複製程式碼
第三步:配置支付相關資訊
- 這裡只寫下簡單版,如果想要把訂單中所有商品資訊新增進去自行檢視官方demo吧,很簡單的
PayPalPayment *payment = [[PayPalPayment alloc] init];
//訂單總額
payment.amount = [NSDecimalNumber decimalNumberWithString:@"100"];
//貨幣型別-RMB是沒用的
payment.currencyCode = @"USD";
//訂單描述
payment.shortDescription = @"Hipster clothing";
複製程式碼
第四步:提交訂單-最重要也是最簡單的一步
//生成paypal控制器,並模態出來(push也行)
//將之前生成的訂單資訊和paypal配置傳進來,並設定訂單VC為代理
PayPalPaymentViewController *paymentViewController = [[PayPalPaymentViewController alloc] initWithPayment:payment configuration:self.payPalConfig delegate:self];
//模態展示
[self presentViewController:paymentViewController animated:YES completion:nil];
複製程式碼
之後就是顧客賬戶上場了
-
找到你的顧客賬號,記著不是商家賬號。拿到郵箱和密碼。郵箱是上面顯示的buyer的郵箱。密碼如果修改過就是修改後的密碼,沒改過應該就是註冊時填的登陸密碼。
-
在付款頁面登陸你的賬號。登陸成功之後,你會看到你即將支付的訂單總額,你的賬號名字以及你的paypal支付方式選項,預設是餘額Balance支付。如果你開通了信用卡支付,可選擇信用卡。
-
最後,毫不猶豫的點下那個藍色的Pay
-
不出意外都會支付成功的
最後:監測訂單狀態
- 你的訂單VC要遵從 PayPalPaymentDelegate 協議
- 實現協議的方法如下:
//訂單支付完成後回撥此方法
- (void)payPalPaymentViewController:(PayPalPaymentViewController *)paymentViewController didCompletePayment:(PayPalPayment *)completedPayment {
NSLog(@"PayPal Payment Success!");
}
//使用者取消支付回撥此方法
- (void)payPalPaymentDidCancel:(PayPalPaymentViewController *)paymentViewController {
NSLog(@"PayPal Payment Canceled");
}
複製程式碼
到這裡支付流程就完成了,但是你可能還需要向伺服器傳送一些東西,讓伺服器驗證本次訂單有效性
//回撥的 PayPalPayment 的 confirmation 屬性包含此次訂單的狀態資訊包括校驗碼,伺服器可已通過該校驗碼驗證交易真實性。
//返回資料 - id所對應的就是校驗碼。
{
client = {
environment = sandbox;
"paypal_sdk_version" = "2.14.2";
platform = iOS;
"product_name" = "PayPal iOS SDK";
};
response = {
"create_time" = "2016-05-12T03:25:49Z";
id = "PAY-6BG56850AF923584SK4Z7PNQ";
intent = sale;
state = approved;
};
"response_type" = payment;
}
複製程式碼
最後的最後:
有小夥伴在關心之前在阿啪啪中產生的交易怎麼知道呢?
來到paypal開發者網站,登陸後向左看。選擇Sandbox中的Notification選擇。這裡就是所有的交易通知,包括商家賬戶和顧客賬戶。