JudoSDK 4.7.4
- 作者：
- Hamon Riazy
- JudoPayments
judoNative SDK for iOS
judoNative iOS库可以让您将安全的_in-app_卡支付集成到您的iOS应用程序中。Judo的SDK使您的应用程序中的支付体验更快、更简单、更安全。
***由于全行业安全更新，此SDK的4.7.2以下版本将在2016年10月1日之后不再受支持。有关这些更新的更多信息，请在此处阅读我们的博客here.***
说明
judopayments iOS SDK包括头文件和一个静态库。
注册judopayments
- 要使用judopay SDK，您需要注册并获取您的应用令牌。
要求
- 支持iOS 6.0+的目标部署。
- 支持armv7和armv7s设备，但不是armv6。
安装
手动
-
将这些框架添加到您的项目中。
- CoreGraphics
- Foundation
- MobileCoreServices
- QuartzCore
- Security
- SystemConfiguration
- UIKit
将JudoPay.framework和JudoPay.bundle拖到Xcode项目并将其添加到链接器标志的-ObjC和-all_load。
将judopayments开源许可致谢添加到应用程序的致谢中。
附加设置
在您想使用SDK的文件顶部添加。
#import <JudoPay/JudoPay.h>要指示SDK与沙盒通信，请包含以下行
[[JudoAPIManager sharedSession] setSandboxMode]当您准备上线时，可以删除此行。我们建议将其放在AppDelegate的didFinishLaunchingWithOptions方法中。您也可以在此处设置密钥和秘密，如果您不希望将其包含在所有后续调用中：
[[JudoSDKManager sharedSession] setToken:和Secret:]可以使用JudoSDKManager上的以下静态方法实现单行集成。
- (void)judoPaymentWithAmount:(nonnull JPAmount *)amount
judoID:(nonnull NSString *)judoID
consumerRef:(nonnull NSString *)consumerRef
metaData:(nullable NSDictionary *)metaData
parentViewController:(nonnull id)viewController
success:(nullable void(^)(id __nullable JSON))successBlock
failure:(nullable void(^)(NSError * __nullable error))failureBlock;解析和检查返回的JSON数据对象以获取交易详情。
示例
{
"amount": 4,
"appearsOnStatementAs": "JudoPay/judoPayD",
"cardDetails": {
"cardLastfour": 3436,
"cardToken": "9CE128956DB34ED0902AC3E155EBC299",
"cardType": 1,
"endDate": 1215
},
"consumer": {
"yourConsumerReference": "yourconsumerref"
},
"createdAt": "2013-07-18T11:39:03.6000+01:00",
"judoId": 100016,
"merchantName": "judoPay Dev",
"netAmount": 4,
"originalAmount": 4,
"receiptId": 33712,
"result": "Success",
"type": "Payment"
}- 要将卡片保存以供以后使用，从上述响应中检索cardDetails字典和yourConsumerReference并安全存储。使用以下JudoSDK静态方法使用卡片token进行另一笔支付
- (void)judoPaymentWithAmount:(nonnull JPAmount *)amount
cardDetails:(nonnull NSDictionary *)cardDetails
judoID:(nonnull NSString *)judoID
consumerRef:(nonnull NSString *)consumerRef
metaData:(nullable NSDictionary *)metaData
parentViewController:(nonnull id)viewController
success:(nullable void (^)(id __nullable JSON))successBlock
failure:(nullable void (^)(NSError * __nullable error))failureBlock;- 有关更多使用选项和信息，请参阅头文件。
示例代码
// SomeViewController.h
#import <JudoPay/JudoPay.h>
[JudoSDKManager judoPaymentWithAmount:4.0
judoID:@"100016"
consumerRef:@"yourConsumerRef"
metaData:nil
parentViewController:self
success:^(id responseObject) {
id object = [NSJSONSerialization JSONObjectWithData:responseObject options:0 error:nil];
NSLog(@"parsed response: %@", object);
// store these for later use
NSDictionary *cardDetails = [object valueForKey:@"cardDetails"];
NSString *consumerRef = [[object valueForKey:@"consumer"] valueForKey:@"yourConsumerReference"];
} withFailure:^(NSError *error) {
NSLog(@"Failure: %@", error);
}];- 要注册不付款的卡片，请使用registerCard方法。
- (void)judoRegisterCard:(nonnull Card *)card
consumerRef:(nonnull NSString *)consumerRef
deviceID:(nullable NSString *)deviceID
parentViewController:(nonnull id)viewController
success:(nullable void(^)(id __nullable JSON))successBlock
failure:(nullable void(^)(NSError * __nullable error))failureBlock;提示与技巧
您可能希望包括适当的付款引用和消费者引用，JudoPay SDK提供辅助类以简化这一过程，并使用如NSDictionary和NSString之类的简单对象。
示例应用
此存储库中包含的Swift和Objective-C示例应用是用Xcode 7编写的。截至本beta版本发布时，Xcode 7仍然处于Beta测试阶段。某些功能可能无法按预期工作，所以请耐心等待，并希望9月能快速发布最终版本。