Launch Overview

SLIM CD’s launching functionality is supported by our IOS, Android, Windows Phone, Windows RT/Win8 app versions. SLIM CD sample code shows how to call our app and how to accept the results returned from our app.   Our native libraries hide all of the complexity of the low-level protocol.  These libraries accept the objects as input and returns a URL string which can be used to launch our app, including the request values.   These request and reply objects mimic those found in our normal web services API, so that calling the SLIM CD API and calling our App as an API give similar results.

Design Basis

This design is based on the app launching specification located at:

http://x-callback-url.com/specifications/

and

http://appurl.org/

Slim CD has implemented a solution that is compatible with both standards and has the name/value data required to meet the needs of Slim CD customers and developers. 


Protocol Participants

 There are two participants in this app launching protocol.  They are:

  1. The Client mobile application
  2. The SlimCD mobile application

SlimCD App Launching Structure

The structure of a URL to launch the SlimCD mobile app will be as follows:

app.slimcd.com://x-callback-url/<action> ? <x-callback-parameters> & <configuration-parameters> & <action-parameters>

Note that it is assumed that the above URL is a single string, with no spaces and with all appropriate values URL encoded as necessary to make it a valid URL.

SlimCD App Responses

SLIM CD allows the calling app to get the results of payment processing.  To accomplish this, your app would register it’s own protocol and pass a self-referencing return URL to the SLIM CD app.  When payment processing is complete, the calling app would get the results by being launched from the SLIM CD app, as specified by the app’s return URL.  The information on how to specify that your app accepts a protocol can be found on the web or in the http://www.x-callback-url.com or http://www.appurl.org websites.

The SLIM CD apps use the x-success value of the x-callback-url.com standard to identify the protocol used to return to the calling application.

Check the PROTOCOL tab for additional information.