{"templateId":"../../../@theme/Templates/ReleaseNote.tsx","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":["img"]},"type":"markdown","date":"2026-10-01","monthLabel":"October 2026","order":1,"coverImage":"/images/heroes/iOS_sdk_hero.png"},"seo":{"title":"iOS and Android SDK Improvements","description":"New in the Finix mobile SDKs, including 3D Secure in the Payment Sheet, tips and surcharges for Tap to Pay on iPhone, and simpler setup for the PAX D135.","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":[]}]},"image":"/assets/ios_sdk_hero.6b4081a1ba9ee618cc2d0daec263c86e462bcf6d27cef1f1b9d8625bbc4c0206.fec90461.png"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"ios-and-android-sdk-improvements","__idx":0},"children":["iOS and Android SDK Improvements"]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/ios_sdk_hero.6b4081a1ba9ee618cc2d0daec263c86e462bcf6d27cef1f1b9d8625bbc4c0206.fec90461.png","alt":"Finix iOS SDK payment sheet","framed":false,"withLightbox":true,"style":"width: 60%; box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15); border-radius: 8px"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We've shipped a round of updates across the Finix iOS SDK and Finix Android SDK. Here's what's new in the Payment Sheet, Tap to Pay on iPhone, and PAX D135 SDKs."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"payment-sheet","__idx":1},"children":["Payment Sheet"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ios","__idx":2},"children":["iOS"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["3D Secure:"]}," Run ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ios/online/configuration#threedsconfiguration"},"children":["3D Secure authentication"]}," after card tokenization. Both frictionless and challenge flows are supported, and the result is returned alongside the token."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Swift Package Manager:"]}," Install the Payment Sheet through Swift Package Manager from the public ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/finix-payments/finix-paymentsheet-ios-sdk"},"children":["finix-paymentsheet-ios-sdk"]}," repository."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Configurable postal code:"]}," Choose a US ZIP code or international postal code format, and set whether the field is required."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Faster form entry:"]}," Buyers can move between fields with ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Done"]}," keyboard buttons."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Easier support:"]}," Errors now include a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["logref"]}," you can share with Finix Support to trace a request."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"android","__idx":3},"children":["Android"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["3D Secure:"]}," Run ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/android/online/configuration#threedsconfiguration"},"children":["3D Secure authentication"]}," after card tokenization. The result is returned alongside the token in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PaymentSheetResponse"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Simpler configuration:"]}," Credentials, environment, and 3D Secure settings are now grouped in a single ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/android/online/configuration"},"children":["PaymentSheetConfiguration"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Structured errors:"]}," A new ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onFailure"]}," callback returns a specific ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/android/online/errors"},"children":["error code"]}," for each failure, so you can handle network, configuration, and 3D Secure failures separately."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tap-to-pay-on-iphone","__idx":4},"children":["Tap to Pay on iPhone"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tips, surcharges, and signatures:"]}," Pass ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tipAmount"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["surchargeAmount"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["promptForSignature"]}," when you ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ios/tap-to-pay/transactions"},"children":["start a transaction"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Simpler setup:"]}," The SDK now looks up the merchant's processor MID automatically. You no longer need to pass ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantMid"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Setup progress:"]}," The new ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["configurationProgress"]}," publisher reports reader configuration progress from 0 to 100, so you can show the progress indicator Apple requires."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["More specific errors:"]}," New ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ios/tap-to-pay/errors"},"children":["error codes"]}," cover reader states that previously returned ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unknown"]},", such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["readerBusy"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["prepareExpired"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["passcodeDisabled"]},". Errors also include a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["logref"]}," for Finix Support."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"pax-d135","__idx":5},"children":["PAX D135"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ios-1","__idx":6},"children":["iOS"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Simpler setup:"]}," The SDK now looks up the merchant's processor MID automatically, so you no longer need to pass ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mid"]}," in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ios/card-present/credentials"},"children":["FinixConfig"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Refund state:"]}," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ios/card-present/refunds"},"children":["Refund results"]}," now include the refund's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["state"]},", so you can tell a pending refund from a completed one."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Easier support:"]}," Errors now include a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["logref"]}," you can share with Finix Support to trace a request."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"android-1","__idx":7},"children":["Android"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Referenced refunds:"]}," The Device Reader SDK now supports ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/in-person-payments/deploy-apps-terminals/quickstart"},"children":["referenced refunds"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To learn more:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ios/online"},"children":["Payment Sheet iOS SDK"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/android/online"},"children":["Payment Sheet Android SDK"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ios/tap-to-pay"},"children":["Tap to Pay on iPhone SDK"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ios/card-present"},"children":["PAX D135 iOS SDK"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/android/card-present"},"children":["PAX D135 Android SDK"]}]}]}]},"headings":[{"value":"iOS and Android SDK Improvements","id":"ios-and-android-sdk-improvements","depth":1},{"value":"Payment Sheet","id":"payment-sheet","depth":2},{"value":"iOS","id":"ios","depth":3},{"value":"Android","id":"android","depth":3},{"value":"Tap to Pay on iPhone","id":"tap-to-pay-on-iphone","depth":2},{"value":"PAX D135","id":"pax-d135","depth":2},{"value":"iOS","id":"ios-1","depth":3},{"value":"Android","id":"android-1","depth":3}],"frontmatter":{"template":"../../../@theme/Templates/ReleaseNote.tsx","seo":{"title":"iOS and Android SDK Improvements","description":"New in the Finix mobile SDKs, including 3D Secure in the Payment Sheet, tips and surcharges for Tap to Pay on iPhone, and simpler setup for the PAX D135.","image":"/assets/ios_sdk_hero.6b4081a1ba9ee618cc2d0daec263c86e462bcf6d27cef1f1b9d8625bbc4c0206.fec90461.png"},"metadata":{"date":"2026-10-01","monthLabel":"October 2026","order":1,"coverImage":"/images/heroes/iOS_sdk_hero.png"}},"lastModified":"2026-11-20T17:45:28.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/release-notes/2026/10/ios-and-android-sdk-improvements","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}