{"_id":"59dfa8f55c0bae001c2e8b18","category":{"_id":"59dfa8f45c0bae001c2e8aed","version":"59dfa8f45c0bae001c2e8ae8","project":"57336fd5a6a9c40e00e13a0b","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2017-09-28T18:25:00.606Z","from_sync":false,"order":4,"slug":"sdks","title":"SDKs"},"project":"57336fd5a6a9c40e00e13a0b","user":"560d5913af97231900938124","parentDoc":null,"version":{"_id":"59dfa8f45c0bae001c2e8ae8","project":"57336fd5a6a9c40e00e13a0b","__v":1,"createdAt":"2017-10-12T17:40:04.535Z","releaseDate":"2017-10-12T17:40:04.535Z","categories":["59dfa8f45c0bae001c2e8ae9","59dfa8f45c0bae001c2e8aea","59dfa8f45c0bae001c2e8aeb","59dfa8f45c0bae001c2e8aec","59dfa8f45c0bae001c2e8aed","59dfa8f45c0bae001c2e8aee","59dfa8f45c0bae001c2e8aef","59dfa8f45c0bae001c2e8af0"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"3.23. Release","version_clean":"8976.0.0-Basics","version":"8976-Basics"},"__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-08-03T15:05:48.801Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":26,"body":"The BlueSnap iOS SDK (Beta) makes it easy to offer a delightful payment experience to shoppers using their iPhones or iPads, and provides two elegant UI options for you to choose from - a pre-built checkout UI (shown in images below) to get up-and-running quickly or a flexible credit card field to embed in your own checkout flow. In both options, the shopper's payment data never passes through your server, since it is submitted directly to BlueSnap. Your PCI burden is reduced to the minimum SAQ-A. \n<br>\n[block:html]\n{\n  \"html\": \"<span id=\\\"standard-checkout-flow\\\"></span>\\n<!-- flow w/shipping -->\\n<div class=\\\"custom-2\\\">\\n  <img src=\\\"https://files.readme.io/e532bbf-step1.jpg\\\">\\n  <img src=\\\"https://files.readme.io/aa3638c-step2.jpg\\\">\\n  <img src=\\\"https://files.readme.io/971c9a1-step3.jpg\\\">\\n</div>\\n<style>\\n  .custom-2 {\\n    text-align: center;\\n    display: block;\\n  }\\n  .custom-2 > img {\\n    display: inline-block;\\n    margin: 4px;\\n    border: 3px solid #EDEAE5; \\n    width: 25%;\\n  }\\n</style>\"\n}\n[/block]\n## Checkout flow options \n### Standard Checkout Flow \nIn the Standard Checkout Flow, you get up and running quickly with our pre-built checkout UI providing dynamic currency conversions and built-in validations. By building a single integration, you can accept Apple Pay, credit cards, and PayPal payments. Some additional capabilities include: \n\n* Specifying required shopper info, such as email or billing address.\n* Pre-populating checkout page with shopper details you've already collected.\n* Launching the checkout flow with a simple start function.\n\n<span></span>\n*The images above show the Standard Checkout Flow with an additional shipping details page.*\n\n### Custom Checkout Flow \n[block:html]\n{\n  \"html\": \"<div style=\\\"display:block;margin-bottom: -46px; line-height: 1.7em;\\\">\\n  <div style=\\\"display:inline-block; width:55%;margin-right:20px;\\\">\\n    <p style=\\\"margin-bottom:10px;\\\">In the Custom Checkout Flow, you \\n    control the look and feel of your checkout process, while using our flexible credit card field (shown in right image) to collect the shopper's sensitive data. With this flow, you have full access to the following benefits:</p>\\n    <ul>\\n      <li>Built-in validations and card-type detection.</li>\\n      <li>Helper classes to assist you in currency conversions, removing whitespaces, and more.</li>\\n      <li>Simple function that submits sensitive card details directly to BlueSnap's server. </li>\\n    </ul>\\n  </div>\\n  <img style=\\\"display:inline-block; vertical-align:top;margin-top:0px;border: 2px solid #EDEAE5;\\\" src=\\\"https://files.readme.io/d54a75d-custom1.PNG\\\">\\n</div>\"\n}\n[/block]\n## Installation and usage \nThe [SDK and a demo app are available on GitHub](https://github.com/bluesnap/bluesnap-ios/tree/master). See the [readme file](https://github.com/bluesnap/bluesnap-ios/blob/master/README.md) for detailed usage instructions.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"It's necessary to understand the difference between Apple Pay and In-App Purchase. Use BlueSnap and Apple Pay within apps to sell physical goods (such as groceries, clothing, and appliances), or for services (such as club memberships, hotel reservations, and event tickets).\\n\\nUse In-App purchases to sell virtual goods (such as premium app content and subscriptions for digital content). See Apple's [In-App Purchase](https://developer.apple.com/ios/human-interface-guidelines/technologies/in-app-purchase/) for more information.\",\n  \"title\": \"When you can use BlueSnap and Apple Pay in iOS\"\n}\n[/block]","excerpt":"","slug":"ios-sdk","type":"basic","title":"iOS SDK"}

The BlueSnap iOS SDK (Beta) makes it easy to offer a delightful payment experience to shoppers using their iPhones or iPads, and provides two elegant UI options for you to choose from - a pre-built checkout UI (shown in images below) to get up-and-running quickly or a flexible credit card field to embed in your own checkout flow. In both options, the shopper's payment data never passes through your server, since it is submitted directly to BlueSnap. Your PCI burden is reduced to the minimum SAQ-A.

Checkout flow options

Standard Checkout Flow

In the Standard Checkout Flow, you get up and running quickly with our pre-built checkout UI providing dynamic currency conversions and built-in validations. By building a single integration, you can accept Apple Pay, credit cards, and PayPal payments. Some additional capabilities include:

  • Specifying required shopper info, such as email or billing address.
  • Pre-populating checkout page with shopper details you've already collected.
  • Launching the checkout flow with a simple start function.


The images above show the Standard Checkout Flow with an additional shipping details page.

Custom Checkout Flow

In the Custom Checkout Flow, you control the look and feel of your checkout process, while using our flexible credit card field (shown in right image) to collect the shopper's sensitive data. With this flow, you have full access to the following benefits:

  • Built-in validations and card-type detection.
  • Helper classes to assist you in currency conversions, removing whitespaces, and more.
  • Simple function that submits sensitive card details directly to BlueSnap's server.

Installation and usage

The SDK and a demo app are available on GitHub. See the readme file for detailed usage instructions.

When you can use BlueSnap and Apple Pay in iOS

It's necessary to understand the difference between Apple Pay and In-App Purchase. Use BlueSnap and Apple Pay within apps to sell physical goods (such as groceries, clothing, and appliances), or for services (such as club memberships, hotel reservations, and event tickets).

Use In-App purchases to sell virtual goods (such as premium app content and subscriptions for digital content). See Apple's In-App Purchase for more information.