前文
前段时间在空暇时间写了GoogleMaps的使用指南,刚写完的一段时间,发现并没有人阅读,所以不太想写第二篇,觉得帮助意义不大,最近看到有几个同行给我发私信和评论问我一些相关问题,这才有写这篇文章的想法,我觉得一些东西,单单是自己知道,是没有价值的,技术的价值体现在分享的过程中,你分享的越多,价值自然而然就体现出来了,大家都在你的文章中有所收获,就是值得的。
- 废话不多说,下面步入正文
关于Stripe
在没有做公司海外项目之前,还没有听说过Stripe,所以做了一下简单了解,其实就是一种信用卡支付方式的集成,相当于一个虚拟的信用卡卡包,里面装有用户的信用卡,然后在支付的时候,会让用户选择自己的信用卡进行支付,很便捷,支持的信用卡种类很多。详细了解请移步点击进入Stripe官网
集成Stripe
关于集成,之前在说GoogleMaps的时候就有过相关阐述,我觉得CocoaPods是相对来说方便,并且安全系数相对较低的一种集成方式,如果用CocoaPods方式集成,尤其要注意相关用法。本文也只说明CocoaPods集成方式,对于其他方式,Stripe官网有指出点击进入,因为是第一次集成Stripe,踩了一些坑,在这说明一下,Stripe的GitHub中有给出每次更新的内容,但是当我下载完的时候对比官方文档中少了几个必须类,很是苦恼,之后才发现自己通过CocoaPods导入的并非最新版本,不过没关系,只需要pod update一下就可以更新到最新版本,有点大惊小怪。
Stripe业务逻辑
在我现在做的项目中业务逻辑很简单,在此说明一下,方便读者理解。
- 在新建用户的同时,后台这边根据一些用户信息比如独一无二的user_id类似字段去Stripe服务器申请一个用户的Stripe标识,在拿到Stripe标识之后相当于这个用户已经在Stripe服务器上有了记录。
- 在用户进行第一次付款的时候,app会通过请求server数据进行判定当前用户是否有绑定的信用卡或者默认的付款方式,如果判定用户是第一次付款,先进行添加信用卡操作。
- 用户可以自己在信用卡管理界面进行增加和删除行用卡操作。
Stripe具体操作实践--添加卡片
因为Stripe的操作难度并不复杂所以我觉得分开讲更容易理解,这是添加信用卡片的代码
- (IBAction)addCardAction:(id)sender {
_addCardBtn.userInteractionEnabled = NO;
STPCardParams *cardParams = [[STPCardParams alloc]init];
cardParams.number = _paymentTextField.cardParams.number;
cardParams.expMonth = _paymentTextField.cardParams.expMonth;
cardParams.expYear = _paymentTextField.cardParams.expYear;
cardParams.cvc = _paymentTextField.cardParams.cvc;
[SVProgressHUD showWithStatus:[NSString stringWithFormat:@"%@···",NSLocalizedString(@"cardGroupAddCardProgressKey", nil)]];
[[STPAPIClient sharedClient] createTokenWithCard:cardParams completion:^(STPToken * _Nullable token, NSError * _Nullable error) {
_addCardBtn.userInteractionEnabled = YES;
if (error) {
[SVProgressHUD dismiss];
NSLog(@"%@",[error description]);
[self.view makeToast:NSLocalizedString(@"addCardInfoErrorKey", nil) duration:1 position:CSToastPositionCenter];
} else {
NSLog(@"添加成功 tokenId:%@ cardId:%@",token.tokenId,token.card.cardId
);
[self stripePayActionWithTokenid:token.tokenId];
}
}];
}
代码中出现了STPCardParams和STPAPIClient类,这两个类简单说明一下,前者是手机信用卡信息的一个类,包括信用卡的安全码,卡号,日期之类的信息,服务器返回给前端的数据是一个json数据,要转model赋值给STPCardParams对象,STPAPIClient类是Stripe中的API类,一些和Stripe Server的交互都是从这个类里面调度,一些基本的操作大多是这样,前端添加一张卡片,在填写好卡片信息之后,根据API给出的提示填写好param提交,会从Stripe server那里得到一个tokenId,这个tokenId要传回给自己的server,然后公司的server会拿着这个tokenId去执行对应的操作,所以真正的一些付款和添加卡片的操作都是服务器完成的,前端只是做一下调度。
Stripe具体操作实践--付款
Stripe付款分为两种,第一种是普通的付款行为,另外一种是集成ApplePay,
分开讲一下,其实两种的原理是相同的。
普通的付款流程
- (void)paymentActionWithCardId:(NSString *)cardId{
[SVProgressHUD showWithStatus:[NSString stringWithFormat:@"%@···",NSLocalizedString(@"cardGroupPayingKey", nil)]];
NSDictionary *param;
if ([_paySource isEqualToString:@"topupbalance"]) {
param = [NSDictionary dictionaryWithObjectsAndKeys:@"3",@"paysrc",@"3",@"type",cardId,@"card_id",_total_fee,@"total_fee", nil];
} else {
param = [NSDictionary dictionaryWithObjectsAndKeys:@"3",@"paysrc",@"1",@"type",cardId,@"card_id", nil];
}
NSString *url = [NSString stringWithFormat:@"%@deposit",REQUEST_HOST];
[JJBaseRequestHelper requestWithRequestMethod:@"post" isShowDialogView:YES parameters:param urlName:url formData:nil success:^(id ResponseObject) {
[SVProgressHUD dismiss];
if ([[[[[ResponseObject objectForKey:@"data"] objectForKey:@"param"] objectForKey:@"stripe"]description] isEqualToString:@"ok"]) {
NSLog(@"success");
[self.navigationController.view makeToast:NSLocalizedString(@"cardGroupPaymentSuccessKey", nil) duration:1 position:CSToastPositionCenter];
dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(1 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
if ([_paySource isEqualToString:@"topupbalance"]) {
[self topupBalanceSuccessAction];
} else {
[self paymentDepositSuccessAction];
}
});
}
} failure:^(NSString *Message) {
[SVProgressHUD dismiss];
[self.navigationController.view makeToast:NSLocalizedString(@"cardGroupPaymentFailedKey", nil) duration:1 position:CSToastPositionCenter];
}];
}
这段代码看起来很简单,不需要多说吧,只是从信用卡列表中选择了一个信用卡对象,然后拿到卡的CardId就可以传回给公司的服务器进行付款了,很简单。
ApplePay付款方式
//这个代理方法指的是支付过程中会进行调用
- (void)paymentAuthorizationViewController:(PKPaymentAuthorizationViewController *)controller
didAuthorizePayment:(PKPayment *)payment
completion:(void (^)(PKPaymentAuthorizationStatus status))completion
{
NSLog(@"%@",payment);
[[STPAPIClient sharedClient] createTokenWithPayment:payment completion:^(STPToken * _Nullable token, NSError * _Nullable error) {
NSLog(@"error = %@",error);
NSLog(@"token = %@",token);
if (!token) {
_isPaymentSuccess = NO;
completion(PKPaymentAuthorizationStatusFailure);
} else {
NSDictionary *param = [NSDictionary dictionaryWithObjectsAndKeys:@"4",@"paysrc",@"3",@"type",token,@"token",_total_fee,@"total_fee", nil];
NSString *url = [NSString stringWithFormat:@"%@recharge",REQUEST_HOST];
[JJBaseRequestHelper requestWithNSURLSessionMethod:@"post" parameters:param urlName:url success:^(id ResponseObject) {
if ([[[[[ResponseObject objectForKey:@"data"] objectForKey:@"param"] objectForKey:@"applepay"]description] isEqualToString:@"ok"]) {
_isPaymentSuccess = YES;
dispatch_async(dispatch_get_main_queue(), ^{
completion(PKPaymentAuthorizationStatusSuccess);
});
} else {
_isPaymentSuccess = NO;
completion(PKPaymentAuthorizationStatusFailure);
}
} failure:^(NSString *Message) {
_isPaymentSuccess = NO;
completion(PKPaymentAuthorizationStatusFailure);
}];
}
}];
}
用过ApplePay的应该知道这个代理方法,是支付过程中的Delegate方法,[[STPAPIClient sharedClient] createTokenWithPayment:payment completion,这个方法是STPAPIClient中对于苹果支付单独给出的一个方法,大致相同,区别在于苹果支付的时候Stripe会在这个方法中把你再wallet中选择的card转换成Stripe中的信用卡对象,然后就和普通的支付流程一样了,是不是很简单。
总结
可能很多小伙伴在看Stripe文档的时候都觉得很糊涂,其实不单是你们糊涂,我看的时候,也相当费解,我在文中并没有提到STPPaymentContext这个类,因为我觉得作为初学者,想看懂这个难度还是有一点的,Stripe的官方代码耦合度还是不低的,要看懂demo的付款流程,时间还是要一点的,总体来说demo里面只不过给你集成好了卡的管理界面和添加卡片的界面 ,但是我觉得如果你想更好的利用Stripe,就不要去采用这些东西,为了耦合度更低,最好是自己像我这样通过Stripe给出来的组件自己集成界面,这样很简单,而且也降低了界面耦合度,以后维护起来,也只需要改动一下View层即可,有看完这篇文章依然很困惑的小伙伴,可以在评论区评论,看到评论我会及时回复,露珠可能最近要换一份新工作,祝我好运吧!