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
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.
The parameters we accept include:
returnUrl- your app's URL handler that you set up previously (e.g.
returnAppName- name of the app the
returnUrlwill open (required if
fm- if set to 1, the FileMaker-compatible response format will be used
amount- amount of the transaction (e.g.
firstName- billing first name
lastName- billing last name
address- billing street address
city- billing city
state- billing state or province (e.g.
zip- billing zip or postal code
phone- biling phone number
country- billing country code (e.g.
invoiceNumber- merchant-assigned invoice number
description- description of goods or service
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
In your UIApplicationDelegate, you'll need to override
- (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:
ifcc_amount- amount charged (e.g.
ifcc_redactedCardNumber- redacted card number (e.g.
Here's a sample response:
fm=1 parameter is included in the original request, the response is modified by including a dollar-sign ($) before each query value so that they can be accessed by FileMaker Go scripts. For instance, instead of