{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-ios/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["code-walkthrough","step"]},"type":"markdown"},"seo":{"title":"Configuration | iOS SDK Reference","description":"Reference for Configuration and Branding — customize the sheet title, logo, and button label in the Finix iOS payment sheet.","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":"CodeWalkthrough","attributes":{"__idx":1,"filters":{},"filesets":[{"files":[{"path":"ios/online/_filesets/configuration.swift","content":[{"start":0,"condition":{"steps":["configuration-shape"]},"children":["Configuration(","    title: title,","    branding: branding,","    buttonTitle: buttonTitle,","    enableCardScanning: enableCardScanning",")"]},"",{"start":9,"condition":{"steps":["branding-shape"]},"children":["Branding(","    image: UIImage(named: \"MyLogo\"),","    title: \"My Company\"",")"]},"",{"start":16,"condition":{"steps":["param-branding"]},"children":["let branding = Branding(","    image: UIImage(named: \"MyLogo\"),","    title: \"My Company\"",")"]},"",{"start":23,"condition":{"steps":["param-title"]},"children":["Configuration(","    title: \"Card Entry\",","    buttonTitle: \"Pay Now\"",")"]},"",{"start":30,"condition":{"steps":["full-example"]},"children":["let branding = Branding(","    image: UIImage(named: \"MyLogo\"),","    title: \"My Company\"",")","let config = Configuration(","    title: \"Card Entry\",","    branding: branding,","    buttonTitle: \"Pay Now\",","    enableCardScanning: true",")","let paymentAction = PaymentAction(","    credentials: credentials,","    delegate: self,","    configuration: config",")"]},""],"metadata":{"steps":["configuration-shape","branding-shape","param-branding","param-title","full-example"]},"basename":"configuration.swift","language":"swift"}],"downloadAssociatedFiles":[]}],"steps":[{"id":"configuration-shape","heading":"Configuration shape"},{"id":"branding-shape","heading":"Branding shape"},{"id":"param-branding","heading":"image / title"},{"id":"param-title","heading":"title / buttonTitle"},{"id":"full-example","heading":"Full example"}],"inputs":{},"toggles":{}},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"configuration","__idx":0},"children":["Configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Controls the title, branding, and button label displayed in the payment sheet. Pass an instance to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["configuration"]}," parameter of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PaymentAction"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All properties are optional. Omit any you don't need and the default value will be used."]},{"$$mdtype":"Tag","name":"CodeStep","attributes":{"id":"configuration-shape","heading":"Configuration shape"},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"swift","header":{"controls":{"copy":{}}},"source":"Configuration(\n    title: String?,\n    branding: Branding?,\n    buttonTitle: String?,\n    enableCardScanning: Bool = false\n)\n","lang":"swift"},"children":[]},{"$$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":"Property"},"children":["Property"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Default"},"children":["Default"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["String?"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Card Entry\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Title displayed at the top of the payment sheet navigation bar."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["branding"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Branding?"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Finix default logo"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Logo image and label shown in the form header. See ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#branding"},"children":["Branding"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["buttonTitle"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["String?"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Tokenize\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Label for the submit button."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["enableCardScanning"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Bool"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},", offers a camera-based card scanning option on supported devices."]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"branding","__idx":1},"children":["Branding"]},{"$$mdtype":"Tag","name":"CodeStep","attributes":{"id":"branding-shape","heading":"Branding shape"},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"swift","header":{"controls":{"copy":{}}},"source":"Branding(\n    image: UIImage?,\n    title: String?\n)\n","lang":"swift"},"children":[]},{"$$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":"Property"},"children":["Property"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Default"},"children":["Default"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["image"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UIImage?"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Finix default logo"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Logo image displayed in the form header."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["String?"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Daphne's Corner\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Label displayed next to the logo image."]}]}]}]}]}]},{"$$mdtype":"Tag","name":"CodeStep","attributes":{"id":"param-branding","heading":"image / title"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["image"]}," sets the logo image displayed in the form header. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]}," sets the label displayed next to it."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"swift","header":{"controls":{"copy":{}}},"source":"let branding = Branding(\n    image: UIImage(named: \"MyLogo\"),\n    title: \"My Company\"\n)\n","lang":"swift"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sheet-title--button","__idx":2},"children":["Sheet title & button"]},{"$$mdtype":"Tag","name":"CodeStep","attributes":{"id":"param-title","heading":"title / buttonTitle"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Override the default sheet title and submit button label with your own strings. Common overrides: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Pay Now\""]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Confirm\""]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Submit\""]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"full-example","__idx":3},"children":["Full example"]},{"$$mdtype":"Tag","name":"CodeStep","attributes":{"id":"full-example","heading":"Full example"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pass a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Configuration"]}," instance to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PaymentAction"]}," via the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["configuration"]}," parameter."]}]}]}]},"headings":[{"value":"Configuration","id":"configuration","depth":1},{"value":"Branding","id":"branding","depth":2},{"value":"Sheet title & button","id":"sheet-title--button","depth":2},{"value":"Full example","id":"full-example","depth":2}],"frontmatter":{"seo":{"title":"Configuration | iOS SDK Reference","description":"Reference for Configuration and Branding — customize the sheet title, logo, and button label in the Finix iOS payment sheet."},"markdown":{"toc":{"hide":true}},"footer":{"hide":true}},"lastModified":"2026-08-06T01:23:57.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ios/online/configuration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}