{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-ios/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Troubleshooting | iOS Card Present SDK Reference","description":"Troubleshooting tips and support resources for the Finix iOS Card Present SDK.","siteUrl":"https://docs.finix.com/","llmstxt":{"hide":false,"sections":[{"title":"Getting Started","includeFiles":["guides/getting-started/**/*.md"],"excludeFiles":[]},{"title":"Online Payments","includeFiles":["guides/online-payments/**/*.md"],"excludeFiles":["guides/online-payments/payment-features/fsa-hsa-non-healthcare-mcc.md"]},{"title":"In-Person Payments","includeFiles":["guides/in-person-payments/**/*.md"],"excludeFiles":[]},{"title":"Subscriptions","includeFiles":["guides/subscriptions/**/*.md"],"excludeFiles":[]},{"title":"After the Payment","includeFiles":["guides/after-the-payment/**/*.md"],"excludeFiles":[]},{"title":"Managing Operations","includeFiles":["guides/managing-operations/**/*.md"],"excludeFiles":[]},{"title":"Platform Payments","includeFiles":["guides/platform-payments/**/*.md"],"excludeFiles":[]},{"title":"Payouts","includeFiles":["guides/payouts/**/*.md"],"excludeFiles":[]},{"title":"Low-Code / No-Code","includeFiles":["low-code-no-code/**/*.md"],"excludeFiles":[]},{"title":"Developers","includeFiles":["additional-resources/developers/**/*.md"],"excludeFiles":[]},{"title":"Plugins","includeFiles":["additional-resources/plugins/**/*.md"],"excludeFiles":[]},{"title":"Industry Considerations","includeFiles":["guides/industry-considerations/**/*.md"],"excludeFiles":[]},{"title":"Regional Considerations","includeFiles":["guides/regional-considerations/**/*.md"],"excludeFiles":[]},{"title":"Release Notes","includeFiles":["release-notes/**/*.md"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"troubleshooting","__idx":0},"children":["Troubleshooting"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"bluetooth-permission","__idx":1},"children":["Bluetooth permission"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If scanning returns no devices, verify that your app has been granted Bluetooth access. When running for the first time, the OS shows a permission prompt during the first ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["startScan()"]}," call. If the user dismisses the scanner before tapping Allow, have them dismiss and re-open the scanner after granting permission in Settings."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NSBluetoothAlwaysUsageDescription"]}," key must be present in your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Info.plist"]}," before the prompt will appear."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"physical-device-required","__idx":2},"children":["Physical device required"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The SDK cannot run on the iOS Simulator. Deploy to a physical device for all testing with the PAX D135."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"device-pairing-indicators","__idx":3},"children":["Device pairing indicators"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"LED"},"children":["LED"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Status"},"children":["Status"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Orange"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ready for pairing"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Green"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Battery fully charged"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Green only (post-connect)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Connected and ready"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Blue"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Waiting for card interaction"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Off + beeping"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card detected"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"troubleshooting-your-terminal","__idx":4},"children":["Troubleshooting Your Terminal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For device-level issues such as connectivity, charging, and LED status, see the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/in-person-payments/troubleshooting-your-terminal"},"children":["Troubleshooting Your Terminal"]}," guide."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"contact-support","__idx":5},"children":["Contact support"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Email ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"mailto:support@finix.com"},"children":["support@finix.com"]}," with a description of the issue, your device serial number, and your SDK version."]}]},"headings":[{"value":"Troubleshooting","id":"troubleshooting","depth":1},{"value":"Bluetooth permission","id":"bluetooth-permission","depth":2},{"value":"Physical device required","id":"physical-device-required","depth":2},{"value":"Device pairing indicators","id":"device-pairing-indicators","depth":2},{"value":"Troubleshooting Your Terminal","id":"troubleshooting-your-terminal","depth":2},{"value":"Contact support","id":"contact-support","depth":2}],"frontmatter":{"seo":{"title":"Troubleshooting | iOS Card Present SDK Reference","description":"Troubleshooting tips and support resources for the Finix iOS Card Present SDK."}},"lastModified":"2026-08-20T01:30:42.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ios/card-present/troubleshooting","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}