IOS SDK

Learn how to integrate Safepay Checkout into your IOS mobile application

A set of components allowing easy integration of Safepay Button and Safepay Checkout into your website, powered by zoid

1. Create an IBOutlet for the main view

Create an IBOutlet for the main view and declare a property for the WKWebView.

2. Variable declarations

Next, you declare several variables that are essential for tracking the state and managing the web view. These include flags to monitor success and failure states, as well as arrays to store the success and failure keywords.

3. Setup of URL and Success/Failure Keywords

When the view appears, this method sets up the URL and defines the success and failure keywords that will be used when the view appears.

4. Configure the Web View to Load the Safepay URL

This method initializes and configures the web view to load the Safepay URL. It sets up the web view, loads the specified URL, and adds an observer to monitor changes in the URL.

5. URL Check

Inside the observation method, it retrieves the new URL from the change dictionary and checks whether it contains any success or failure URLs from the `success_array` and `failure_arrays` arrays.

6. Handle success

The code loops through the success URL addresses obtained from `success_array`. It checks each address to see if the redirected URL contains it. If a match is found, the isSuccess flag is set to true, indicating a successful URL match. Additionally, the isFailure flag is set to false to signify no failure.

7. Handle Failure

Similarly, the code iterates through the failure URL addresses retrieved from `failure_array`. For each address, it examines whether the redirected URL contains it. If a match is detected, the isFailure flag is set to true, indicating a failure URL match. Simultaneously, the isSuccess flag is set to false to denote the absence of a success.

8. Delay and Action

If a success or failure URL is found, it schedules the doCompletionAction method to be called after a delay of 2 seconds. This is necessary because the observer triggers rapidly with each URL change. The delay will ensure that only one condition is met before performing your action.

9. Completion Action

The doCompletionAction method is responsible for handling the completion action based on whether the URL indicates success or failure. It ensures that the action is executed only once (isSuccessAlreadyFired flag), and then executes the appropriate block of code for success or failure.

Preview

1
// Properties
2
@property (weak, nonatomic) IBOutlet UIView *webMainView;
3
@property (strong, nonatomic) WKWebView *safePayWebView;
4

5
BOOL isSuccessAlreadyFired;
6
BOOL isSuccess;
7
BOOL isFailure;
8

9
NSString *safePayURL;
10
NSArray * success_array;
11
NSArray * failure_array;
12

13

14
- (void)viewDidAppear:(BOOL)animated {
15
    [super viewDidAppear:YES];
16
    
17
    // Changed URL in case of success on Safepay Hosted Checkout
18
    safePayURL = @"https://sandbox.api.getsafepay.com/checkout/external/mobile?env=development&source=mobile&beacon=track_fd2fdcd2-b5ca-4c1f-b703-01ccb38b92a1&tracker=track_fd2fdcd2-b5ca-4c1f-b703-01ccb38b92a1&sig=e224792a7fa3f52da74a9cbedae9f58b27e59064d248a7217b61bb13321da431&action=complete";
19

20
    // Changed URL in case of an error on Safepay Hosted Checkout
21
    safePayURL = @"https://sandbox.api.getsafepay.com/checkout/external/error?error=Tracker%20is%20in%20an%20invalid%20state";
22

23
    // Changed URL in case of success on Safepay Embedded Checkout
24
    safePayURL = @"https://sandbox.api.getsafepay.com/embedded/external/complete?environment=sandbox&tbt=6Qw_YaQ304iuB-Ad3UXicBOQwYT33huFj3I1zLYrkbRmpiz3ce2dD2Up3xDWoxeS8mivGmW17g%3D%3D&tracker=track_a7d2bc6d-3b8f-4643-aae5-4f506307075b&finalizer_message=Card%20saved%20successfully&action=complete";
25

26
    // Changed URL in case of success on Safepay Embedded Checkout
27
    safePayURL = @"https://sandbox.api.getsafepay.com/embedded/external/error?environment=sandbox&tbt=6Qw_YaQ304iuB-Ad3UXicBOQwYT33huFj3I1zLYrkbRmpiz3ce2dD2Up3xDWoxeS8mivGmW17g%3D%3D&tracker=track_5e4f5be3-f235-47ef-82a7-8c0c680ea195&finalizer_message=error%20performing%20action%20%27AUTHORIZATION%27%3A%20cannot%20add%20payment%20method%3A%20duplicate%20&action=complete";
28
    
29
    // Add success/failure keywords on completion
30
    success_array = [@"success", @"success/done", @"complete", @"external/complete", @"external/mobile"];
31
    failure_array = [@"failure", @"failed", @"not_processed", @"external/error"];
32
    
33
    [self createSafePayWkWebView];
34
}
35

36
-(void)createSafePayWkWebView{
37
    
38
    WKWebViewConfiguration *theConfiguration = [[WKWebViewConfiguration alloc] init];
39
    self.safePayWebView = [[WKWebView alloc]initWithFrame:CGRectMake(0, 0, self.webMainView.bounds.size.width, self.webMainView.bounds.size.height) configuration:theConfiguration];
40
    
41
    self.safePayWebView.navigationDelegate = self;
42
    
43
    NSURL *url = [NSURL URLWithString:safePayURL];
44
    NSURLRequest *request = [NSURLRequest requestWithURL:url];
45
    [self.safePayWebView loadRequest:request];
46
    
47
    [self.safePayWebView addObserver:self forKeyPath:@"URL" options:NSKeyValueObservingOptionNew context:nil];
48
    [self.safePayWebView addSubview:self.webMainView];
49
}
50

51
- (void)observeValueForKeyPath:(NSString *)keyPath ofObject:(id)object change:(NSDictionary<NSKeyValueChangeKey,id> *)change context:(void *)context {
52
    
53
    if ([keyPath isEqualToString:@"URL"] && object == self.safePayWebView) {
54
        
55
        NSURL *currentURL = [change objectForKey:NSKeyValueChangeNewKey];
56
        NSString *redirectedURL = currentURL.absoluteString;
57
        
58
        isSuccess = NO;
59
        isFailure = NO;
60
        
61
        // Compare Success URL's
62
        for (NSString * strSuccess in success_array) {
63
            
64
            NSRange range = [redirectedURL rangeOfString:strSuccess];
65
            
66
            if (range.location != NSNotFound) {
67
                
68
                // NSLog(@"success url: %@", redirectedURL);
69
                isSuccess = YES;
70
                isFailure = NO;
71
            }
72
        }
73
        
74
        // Compare Failure URL's
75
        for (NSString * strFailure in failure_array) {
76
            
77
            NSRange range = [redirectedURL rangeOfString:strFailure];
78
            
79
            if (range.location != NSNotFound) {
80
                
81
                //  NSLog(@"failure url: %@", redirectedURL);
82
                isFailure = YES;
83
                isSuccess = NO;
84
            }
85
        }
86
        
87
        if (isSuccess || isFailure){
88
            [self performSelector:@selector(doCompletionAction) withObject:self afterDelay:2.0 ];
89
        }
90
        
91
    } else {
92
        [super observeValueForKeyPath:keyPath ofObject:object change:change context:context];
93
    }
94
}
95

96
-(void)doCompletionAction{
97
    
98
    if (!isSuccessAlreadyFired) {
99
        
100
        isSuccessAlreadyFired = YES;
101
        
102
        if (isSuccess){
103
            // Deal success block here
104
            
105
        } else {
106
            
107
            if (isFailure){
108
                // Deal failure block here
109
            }
110
        }
111
    }
112
}

Java SDK

Element - Save Card