Developer API


Add the ability to collect credit card payments from your mobile app by integrating with Swipe. We have support for iPhone, iPad, and iPod devices.

Setting Up Your App

In order for Swipe to call back into your app, you'll need to register a BundleURL in your Info.plist:


If you don't need Swipe to call back, you can skip this step.

Crafting the Request

The request is simply a set of query string parameters appended to our URL handler. Be sure to properly encode the query string parameters.

URL handler: com-appninjas-iswipe://charge/1.0.0/

The parameters we accept include:

Here's a sample request. Please take note of the correct encoding of the parameters:


Making the Request

After crafting the request into NSURL* url, you can call into our app using the following code:

UIApplication* app = [UIApplication sharedApplication];

if( [app respondsToSelector:@selector(canOpenURL:)] && ![app canOpenURL:url] )
    // handle case when Swipe is not installed

[[UIApplication sharedApplication] openURL:url];

Handling the Response

If you provided us with a returnUrl, we will call back into your app with the transaction details. The results of the transaction will be provided via query string parameters. These parameters will begin with ifcc_.

In your UIApplicationDelegate, you'll need to override application:didFinishLaunchingWithOptions: method:

- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions
    NSURL* launchURL = [launchOptions objectForKey:UIApplicationLaunchOptionsURLKey];
    if ( nil != launchURL )
        // handle url

Here's the list of parameters that will be included in the response: