{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["sub-heading","tabs","tab","yes","br","details","no","admonition"]},"type":"markdown"},"seo":{"title":"Events","description":"Transform your commerce with PXP's unified platform—seamless payments, real-time insights, and global growth in one powerful integration.","lang":"en-UK","siteUrl":"https://developer.pxp.io","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"events","__idx":0},"children":["Events"]},{"$$mdtype":"Tag","name":"SubHeading","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Implement callbacks to customise your payment flow."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Components surface callbacks from shopper interaction and validation. You attach closures on configuration types in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PXPCheckoutSDK"]}," so your app can run business rules and refresh the UI while the SDK handles PCI scope, tokenisation, optional 3DS, and transport."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Callbacks enable you to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Validate business rules before payments proceed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Display custom error, failure, or success messages."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Tailor the interface to match your app."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Integrate with fraud tools or your own customer systems."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Control how shoppers experience both successful and failed transactions."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Drive loading states, token lists, saved-card flows, and 3DS where you enable it."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All events are optional and can be mixed and matched based on your business needs."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"supported-events","__idx":2},"children":["Supported events"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the matrices below to see which pre-built or standalone surface supports each callback; expand a cell for scope. Session-wide hooks live on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CheckoutConfig"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onGetShopper"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onGetShippingAddress"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["analyticsEvent"]}," — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/ios/card/analytics"},"children":["Analytics"]},"). Pay lifecycle hooks live on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CardSubmitComponentConfig"]},", usually nested under ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NewCardComponentConfig.submit"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ClickOnceComponentConfig.cardSubmitComponentConfig"]}," (",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/ios/card/about-configuration"},"children":["About configuration"]},", ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/ios/card/card-submit"},"children":["Card submit"]},")."]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Pre-built components","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table lists all events supported by the different pre-built card components."]},{"$$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":"Event"},"children":["Event"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Billing address"},"children":["Billing address"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Card-on-file"},"children":["Card-on-file"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Click-once"},"children":["Click-once"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"New card"},"children":["New card"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onBlur"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Nested fields only"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["New card only"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onCardBrandCannotRecognised"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Card number field only"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onCardBrandDetected"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Card number field only"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onChange"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Nested fields only"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["New card only"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onClick"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Click Once ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardSubmitComponentConfig"]}," only"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["New card ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["submit"]}," only"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onCollectEnd"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Click Once ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardSubmitComponentConfig"]}," only"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["New card ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["submit"]}," only"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onCollectStart"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Click Once ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardSubmitComponentConfig"]}," only"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["New card ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["submit"]}," only"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onCustomValidation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Click Once ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardSubmitComponentConfig"]}," only"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["New card ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["submit"]}," only"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onDeleteTokenFailed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onDeleteTokenSuccess"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onFocus"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Nested fields only"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["New card only"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onGetFingerprintResult"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Click Once ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardSubmitComponentConfig"]}," only"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["New card ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["submit"]}," only"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onOnceCardClick"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPostAuthentication"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Click Once ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardSubmitComponentConfig"]}," only"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["New card ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["submit"]}," only"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPostAuthorisation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Click Once ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardSubmitComponentConfig"]}," only"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["New card ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["submit"]}," only"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPostInitiateAuthentication"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Click Once ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardSubmitComponentConfig"]}," only"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["New card ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["submit"]}," only"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPostTokenisation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Also on nested ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["submit"]}," when used"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPreAuthentication"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Click Once ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardSubmitComponentConfig"]}," only"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["New card ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["submit"]}," only"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPreAuthorisation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Click Once ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardSubmitComponentConfig"]}," only"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["New card ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["submit"]}," only"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPreDeleteToken"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPreInitiateAuthentication"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Click Once ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardSubmitComponentConfig"]}," only"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["New card ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["submit"]}," only"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPreRenderTokens"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPreTokenisation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Click Once ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardSubmitComponentConfig"]}," only"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["New card ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["submit"]}," only"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onRetrieveTokensFailed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSelectToken"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSubmitError"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Click Once ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardSubmitComponentConfig"]}," only"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["New card ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["submit"]}," only"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onUpdateTokenFailed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onUpdateTokenSuccess"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onValidation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onValidationPassed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Nested fields only"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["New card only"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onValidationFailed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Nested fields only"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["New card only"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tokenItemBuilder"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tokenLabelBuilder"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPaste"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Secured fields under ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fields"]}," only"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onRetrieveTokensSuccess"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onStartSubmit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Click Once ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardSubmitComponentConfig"]}," only"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["New card ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["submit"]}," only"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onValidationError"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["buttonBuilder"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["selectTokenItemBuilder"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Billing address means the pre-built billing address form: nested ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CountrySelectionComponentConfig"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PostcodeComponentConfig"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AddressComponentConfig"]}," under ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fields"]},". The pre-fill billing checkbox is a standalone component (see the Standalone tab). Dynamic card image is configured on the new card flow for presentation only; it doesn't expose events on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DynamicCardImageComponentConfig"]},"."]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Standalone components","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table lists all events supported by the different standalone components."]},{"$$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":"Event"},"children":["Event"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Billing address input fields"},"children":["Billing address input fields"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Card input fields"},"children":["Card input fields"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Card submit"},"children":["Card submit"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Prefill checkbox"},"children":["Prefill checkbox"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onBlur"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Except card brand selector"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["No callbacks on config"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onCardBrandCannotRecognised"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Card number only"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onCardBrandDetected"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Card number only"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onChange"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Except card brand selector"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["No callbacks on config"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onClick"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onCollectEnd"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onCollectStart"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onCustomValidation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onDeleteTokenFailed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onDeleteTokenSuccess"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onFocus"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Except card brand selector"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["No callbacks on config"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onGetFingerprintResult"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onOnceCardClick"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Use Click Once or card-on-file pre-builts"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPostAuthentication"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPostAuthorisation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPostInitiateAuthentication"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPostTokenisation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPreAuthentication"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPreAuthorisation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPreDeleteToken"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPreInitiateAuthentication"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPreRenderTokens"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPreTokenisation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onRetrieveTokensFailed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSubmitError"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onUpdateTokenFailed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onUpdateTokenSuccess"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onValidation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onValidationPassed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Except card brand selector"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["No callbacks on config"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onValidationFailed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Except card brand selector"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["No callbacks on config"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tokenItemBuilder"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tokenLabelBuilder"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPaste"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Secured fields only (number, expiry, CVC)"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPreRetrySoftDecline"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onStartSubmit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Yes","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["buttonBuilder"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Use Click Once or card-on-file pre-builts"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["selectTokenItemBuilder"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["Use Click Once or card-on-file pre-builts"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"No","attributes":{},"children":[]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Country selection, dynamic card image, the pre-fill billing address checkbox, and card consent are layout or styling components that don't expose events on their configs. Billing address input fields: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CountrySelectionComponentConfig"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PostcodeComponentConfig"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AddressComponentConfig"]},". Card input fields: card number, expiry, CVC, cardholder name, and card brand selector (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CardBrandSelectorComponentConfig"]}," has no event closures). Prefill checkbox: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CheckboxComponentConfig"]},"; initial ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checked"]}," only."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"buttonbuilder","__idx":3},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["buttonBuilder"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Builds the primary action control for Click Once standalone flows. Also supported on pre-built Click Once when shown in the matrix."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to match your app’s button styling for one-tap checkout."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature","__idx":4},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(ClickOnceButtonBuilderElements) -> AnyView"]}," (see SDK types and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/ios/card/click-once"},"children":["Click Once"]},")."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onblur","__idx":5},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onBlur"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs when a billing or card ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["field"]}," loses focus (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FieldComponentConfig"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SecuredFieldComponentConfig"]}," subclasses)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to hide inline help or run your own validation pass after the shopper leaves the field."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-1","__idx":6},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["() -> Void"]}," — no payload; read values from your own state if needed."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-implementation","__idx":7},"children":["Example implementation"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"swift","header":{"controls":{"copy":{}}},"source":"CardNumberComponentConfig(\n    label: \"Card number\",\n    onBlur: { /* update UI */ }\n)\n","lang":"swift"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"oncardbrandcannotrecognised","__idx":8},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onCardBrandCannotRecognised"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs on the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["card number"]}," field when digits don't match a known brand pattern."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to show generic card art or guidance for unknown BIN ranges."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-2","__idx":9},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(CardBrandDetectionEvent) -> Void"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"event-data","__idx":10},"children":["Event data"]},{"$$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":"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":["cardBrand"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CardBrandInfo"]}," from the SDK."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isCardBrandAccepted"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Whether the brand is allowed, when the SDK can determine it."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"oncardbranddetected","__idx":11},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onCardBrandDetected"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs when the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["card number"]}," field recognises a scheme."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to swap card art, show accepted-brand messaging, or log analytics."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-3","__idx":12},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(CardBrandDetectionEvent) -> Void"]}," — same payload shape as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onCardBrandCannotRecognised"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onchange-fields-and-billing","__idx":13},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onChange"]}," (fields and billing)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs when the shopper edits a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["billing or card field"]}," (not the pay button state)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to sync custom labels, enable dependent fields, or debounce your own checks."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-4","__idx":14},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["() -> Void"]}," — no payload for these configs."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onchange-submit","__idx":15},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onChange"]}," (submit)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CardSubmitComponent"]}," coarse state changes (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["idle"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["loading"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["success"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to drive a global spinner or disable navigation while submit is in flight."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-5","__idx":16},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(ComponentState) -> Void"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onclick","__idx":17},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onClick"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs when the shopper activates the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["submit"]}," control, before deeper validation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to log intent, play haptics, or guard double submission at the very start of the tap."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-6","__idx":18},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["() -> Void"]}," on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CardSubmitComponentConfig"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"oncollectend","__idx":19},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onCollectEnd"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs when a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["device-data collection"]}," phase finishes during submit."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to clear intermediate UI tied to collection."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-7","__idx":20},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(Any) -> Void"]}," — treat the argument as opaque unless your SDK version documents it."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"oncollectstart","__idx":21},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onCollectStart"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs when a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["device-data collection"]}," phase starts during submit."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Show “preparing secure check” style messaging."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-8","__idx":22},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(Any) -> Void"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"oncustomvalidation","__idx":23},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onCustomValidation"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs after field validation passes; return whether submit may continue."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to re-check basket price, inventory, or session with your backend before tokenisation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-9","__idx":24},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["() async -> Bool"]}," — return ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}," to block submit."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ondeletetokenfailed","__idx":25},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onDeleteTokenFailed"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs when deleting a saved token from the vault fails (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CardOnFileComponentConfig"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to show an error and keep the list consistent."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-10","__idx":26},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(DeleteCardTokenResponseFailed) -> Void"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ondeletetokensuccess","__idx":27},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onDeleteTokenSuccess"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs when a saved token was removed successfully."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to refresh your local list and analytics."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-11","__idx":28},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(DeleteCardTokenResponseSuccess) -> Void"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onfocus","__idx":29},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onFocus"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs when a billing or card ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["field"]}," receives focus."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to show inline help or scroll the field into view."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-12","__idx":30},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["() -> Void"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ongetfingerprintresult","__idx":31},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onGetFingerprintResult"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Async hook on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CardSubmitComponentConfig"]}," when the flow needs a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["fingerprint string"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to return device or session data your processor expects."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-13","__idx":32},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["() async -> String"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ononcecardclick","__idx":33},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onOnceCardClick"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs when the shopper uses the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Click Once"]}," one-tap affordance (standalone or pre-built, per matrix)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to start your server-side path for that flow or log funnel events."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-14","__idx":34},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ClickOnceStandaloneComponentConfig"]}," in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/ios/card/click-once"},"children":["Click Once"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onpostauthentication","__idx":35},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPostAuthentication"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs after the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["3DS authentication"]}," step completes (success or failure path), on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CardSubmitComponentConfig"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to log authentication outcomes or adjust UI before authorisation continues."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-15","__idx":36},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(AuthenticationResult) -> Void"]}," — cast to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FailedAuthenticationResult"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ExceptionAuthenticationResult"]}," on failure paths; see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/ios/card/3ds"},"children":["3DS"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onpostauthorisation","__idx":37},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPostAuthorisation"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs after the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["gateway"]}," has finished processing the payment (authorised, captured, refused, or failed)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to navigate, show receipts, or reconcile orders."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-16","__idx":38},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(BaseSubmitResult) -> Void"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"event-data-1","__idx":39},"children":["Event data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Downcast ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["result"]}," — common types include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AuthorisedSubmitResult"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CapturedSubmitResult"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RefusedSubmitResult"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FailedSubmitResult"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MerchantSubmitResult"]}," depending on intent and response."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-implementation-1","__idx":40},"children":["Example implementation"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"swift","header":{"controls":{"copy":{}}},"source":"submitConfig.onPostAuthorisation = { result in\n    if let success = result as? AuthorisedSubmitResult {\n        print(\"transaction=\\(success.fundingData.transactionId ?? \"\")\")\n    } else if let refused = result as? RefusedSubmitResult {\n        print(\"refused: \\(refused.state ?? \"\")\")\n    } else if let failed = result as? FailedSubmitResult {\n        print(\"failed: \\(failed.errorCode ?? \"\") \\(failed.errorReason ?? \"\")\")\n    }\n}\n","lang":"swift"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onpostinitiateauthentication","__idx":41},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPostInitiateAuthentication"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs after the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["3DS pre-initiate"]}," call returns."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to inspect coarse ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stateData"]}," or handle ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FailedAuthenticationResult"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-17","__idx":42},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(AuthenticationResult) -> Void"]}," — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/ios/card/3ds"},"children":["3DS"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onposttokenisation","__idx":43},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPostTokenisation"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs after ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["tokenisation"]}," completes. Appears on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NewCardComponentConfig"]}," and on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CardSubmitComponentConfig"]}," when nested as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["submit"]}," (see Supported events)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to store ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gatewayTokenId"]}," for subscriptions or card on file."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-18","__idx":44},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(CardTokenizationResult) -> Void"]}," — cast to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CardTokenizationResultSuccess"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CardTokenizationResultFailed"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-implementation-2","__idx":45},"children":["Example implementation"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"swift","header":{"controls":{"copy":{}}},"source":"submitConfig.onPostTokenisation = { result in\n    if let ok = result as? CardTokenizationResultSuccess {\n        print(\"token=\\(ok.gatewayTokenId)\")\n    } else if let fail = result as? CardTokenizationResultFailed {\n        print(\"token failed: \\(fail.errorCode) \\(fail.errorReason ?? \"\")\")\n    }\n}\n","lang":"swift"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onpreauthentication","__idx":46},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPreAuthentication"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Async hook before ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["3DS authentication"]}," runs; return initiate payload or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nil"]}," to abort."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to supply merchant country, legal name, challenge window, shopper contact, and optional ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ThreeDSRecurring"]}," for recurring setups."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-19","__idx":47},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["() async -> InitiateIntegratedAuthenticationData?"]}," — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/ios/card/3ds"},"children":["3DS"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onpreauthorisation","__idx":48},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPreAuthorisation"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs before the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["authorisation"]}," request is sent. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Required"]}," for the authorisation step to complete as expected."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to return ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TransactionInitiationData"]}," (PSD2 exemptions, risk payloads) or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nil"]}," to stop."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-20","__idx":49},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(PreAuthorizationData?) async -> TransactionInitiationData?"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"event-data-2","__idx":50},"children":["Event data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PreAuthorizationData"]}," in this build exposes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gatewayTokenId"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["schemeTokenId"]}," where applicable."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-implementation-3","__idx":51},"children":["Example implementation"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"swift","header":{"controls":{"copy":{}}},"source":"submitConfig.onPreAuthorisation = { preAuth in\n    // This is an async closure - you can use await here if needed\n    // await someAsyncOperation()\n    _ = preAuth?.gatewayTokenId\n    return TransactionInitiationData()\n}\n","lang":"swift"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onpredeletetoken","__idx":52},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPreDeleteToken"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs before the SDK deletes a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["saved token"]},"; return whether to proceed."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to confirm with your server or show a final confirmation sheet."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-21","__idx":53},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(BaseCardToken) async -> Bool"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onpreinitiateauthentication","__idx":54},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPreInitiateAuthentication"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Async hook before ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["3DS pre-initiate"]},"; return data or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nil"]}," to skip 3DS for that attempt."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to supply ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["providerId"]},", requestor indicator, and timeouts."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-22","__idx":55},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["() async -> PreInitiateIntegratedAuthenticationData?"]}," — pair with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPreAuthentication"]}," per ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/ios/card/3ds"},"children":["3DS"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/ios/card/non-3ds"},"children":["Non-3DS"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onprerendertokens","__idx":56},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPreRenderTokens"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs when the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["saved-card list"]}," is about to render; return mappings for display."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to filter or reorder tokens for the current session (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CardOnFileComponentConfig"]},"; also Click Once retrieve flows per matrix)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-23","__idx":57},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(RetrieveCardTokensResponseSuccess) -> [CardTokenMapping]"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onpreretrysoftdecline","__idx":58},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPreRetrySoftDecline"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs when the SDK offers a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["soft-decline retry"]}," path."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to decide whether to retry with adjusted data."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-24","__idx":59},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(BaseSubmitResult) -> SoftDeclineRetryResult"]}," — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/ios/card/card-submit"},"children":["Card submit"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onpretokenisation","__idx":60},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPreTokenisation"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs immediately before ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["tokenisation"]},"; return whether to continue."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to gate on consent when you don't use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CardConsentComponent"]},", or block when fraud checks fail."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-25","__idx":61},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["() -> Bool"]}," — return ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}," to cancel."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onretrievetokensfailed","__idx":62},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onRetrieveTokensFailed"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs when loading ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["saved tokens"]}," fails (card on file or Click Once, per matrix)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to show retry UI or fall back to new-card entry."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-26","__idx":63},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(RetrieveCardTokensResponseFailed) -> Void"]}," on card on file; Click Once uses ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ClickOnceRetrieveTokensError"]}," — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/ios/card/click-once"},"children":["Click Once"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onretrievetokenssuccess","__idx":64},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onRetrieveTokensSuccess"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs when ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["saved tokens"]}," were loaded successfully."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to bind your model to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gatewayTokens"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["schemeTokens"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-27","__idx":65},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(RetrieveCardTokensResponseSuccess) -> Void"]}," on card on file; Click Once uses ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ClickOnceRetrieveTokensSuccess"]}," — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/ios/card/click-once"},"children":["Click Once"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onselecttoken","__idx":66},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSelectToken"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs when the shopper picks a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["saved token"]}," in card on file."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to highlight the row and pass the token id to submit."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-28","__idx":67},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(BaseCardToken) -> Void"]}," — cast to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GatewayToken"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SchemeToken"]}," as needed."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-implementation-4","__idx":68},"children":["Example implementation"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"swift","header":{"controls":{"copy":{}}},"source":"cofConfig.onSelectToken = { token in\n    if let gateway = token as? GatewayToken {\n        print(\"Selected: \\(gateway.gatewayTokenId)\")\n    }\n}\n","lang":"swift"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onstartsubmit","__idx":69},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onStartSubmit"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs after field validation passes and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["before tokenisation"]}," on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CardSubmitComponentConfig"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to show a full-screen or inline loading state for the pay journey."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-29","__idx":70},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["() -> Void"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onsubmiterror","__idx":71},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSubmitError"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs when the SDK reports a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["failure"]}," during submit (validation, vault, network, 3DS runtime, and similar)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to clear loading UI and map ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errorCode"]}," to shopper-safe copy."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-30","__idx":72},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(BaseSdkException) -> Void"]}," — use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errorCode"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errorMessage"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-implementation-5","__idx":73},"children":["Example implementation"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"swift","header":{"controls":{"copy":{}}},"source":"submitConfig.onSubmitError = { error in\n    switch error.errorCode {\n    case \"SDK0503\", \"SDK0505\":\n        showAuthenticationRetryUI()\n    default:\n        showGenericPaymentError(error.errorMessage)\n    }\n}\n","lang":"swift"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onupdatetokenfailed","__idx":74},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onUpdateTokenFailed"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs when updating token metadata on the vault ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["fails"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to show an error toast and revert UI."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-31","__idx":75},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(UpdateCardTokenResponseFailed) -> Void"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onupdatetokensuccess","__idx":76},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onUpdateTokenSuccess"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs when a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["saved token"]}," was updated successfully."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to refresh labels (for example new expiry)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-32","__idx":77},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(UpdateCardTokenResponseSuccess) -> Void"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onvalidation","__idx":78},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onValidation"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Aggregates ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["linked field validation"]}," for submit (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CardSubmitComponentConfig"]},"), or appears on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NewCardComponentConfig"]}," for container-level results — prefer ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["submit"]}," and per-field callbacks for most UX (",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/ios/card/new-card"},"children":["New card"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to enable or disable the pay button from one snapshot."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-33","__idx":79},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["([ValidationResult]) -> Void"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-implementation-6","__idx":80},"children":["Example implementation"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"swift","header":{"controls":{"copy":{}}},"source":"let newCardConfig = NewCardComponentConfig(\n    fields: fields,\n    submit: submit,\n    onValidation: { results in\n        let ok = results.allSatisfy(\\.valid)\n        updatePayButtonEnabled(ok)\n    }\n)\n","lang":"swift"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onvalidationfailed","__idx":81},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onValidationFailed"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs when a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["field"]}," fails validation for that field’s config."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to show inline errors from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ValidationResult.errors"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-34","__idx":82},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["([ValidationResult]) -> Void"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onvalidationpassed","__idx":83},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onValidationPassed"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs when a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["field"]}," passes validation for that field’s config."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to clear error state for that field."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-35","__idx":84},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["([ValidationResult]) -> Void"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-implementation-7","__idx":85},"children":["Example implementation"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"swift","header":{"controls":{"copy":{}}},"source":"CountrySelectionComponentConfig(\n    label: \"Country\",\n    onValidationFailed: { results in\n        for result in results where !result.valid {\n            result.errors?.values.forEach { print($0.code, $0.message) }\n        }\n    }\n)\n","lang":"swift"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onvalidationerror","__idx":86},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onValidationError"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SDK validation-style errors"]}," on card-on-file or Click Once (for example CVC format), as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BaseSdkException"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to map ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errorCode"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errorMessage"]}," next to the saved-card entry UI."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-36","__idx":87},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(BaseSdkException) -> Void"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onpaste","__idx":88},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPaste"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Runs when the shopper ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["pastes"]}," into a secured field (PAN, expiry, CVC)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to track paste-assisted entry or adjust formatting hints."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-37","__idx":89},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["() -> Void"]}," on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SecuredFieldComponentConfig"]}," subclasses."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"selecttokenitembuilder","__idx":90},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["selectTokenItemBuilder"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Builds each ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["token row"]}," in Click Once token selection UI."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to render scheme icons and masked PAN in SwiftUI."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-38","__idx":91},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ClickOnceStandaloneComponentConfig"]}," in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/ios/card/click-once"},"children":["Click Once"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tokenitembuilder","__idx":92},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tokenItemBuilder"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Builds each ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["saved card row"]}," for card on file."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to customise list layout beyond default styling."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-39","__idx":93},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(CardTokenBuilderElements) -> AnyView"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tokenlabelbuilder","__idx":94},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tokenLabelBuilder"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Produces the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["subtitle or label string"]}," for a saved token row."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to show ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Scheme •••• 1234"]}," style text."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"signature-40","__idx":95},"children":["Signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(BaseCardToken) -> String"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-implementation-8","__idx":96},"children":["Example implementation"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"swift","header":{"controls":{"copy":{}}},"source":"cofConfig.tokenLabelBuilder = { token in\n    let last4 = String(token.maskedPrimaryAccountNumber.suffix(4))\n    return \"\\(token.cardScheme.rawValue) •••• \\(last4)\"\n}\n","lang":"swift"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"fieldcomponentontriggerfieldvalidation","__idx":97},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FieldComponent.onTriggerFieldValidation"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Optional instance hook on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FieldComponent"]}," (not on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FieldComponentConfig"]},"). The SDK may set it internally."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to react to imperative validation triggers if you attach to the component after creation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Prefer ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onValidationPassed"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onValidationFailed"]}," on configs for normal flows."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For session setup, weak references, and environment details, use ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/ios/card/about-configuration"},"children":["About configuration"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/ios/card/analytics"},"children":["Analytics"]}," alongside this page."]}]}]},"headings":[{"value":"Events","id":"events","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Supported events","id":"supported-events","depth":2},{"value":"buttonBuilder","id":"buttonbuilder","depth":2},{"value":"Signature","id":"signature","depth":4},{"value":"onBlur","id":"onblur","depth":2},{"value":"Signature","id":"signature-1","depth":4},{"value":"Example implementation","id":"example-implementation","depth":4},{"value":"onCardBrandCannotRecognised","id":"oncardbrandcannotrecognised","depth":2},{"value":"Signature","id":"signature-2","depth":4},{"value":"Event data","id":"event-data","depth":4},{"value":"onCardBrandDetected","id":"oncardbranddetected","depth":2},{"value":"Signature","id":"signature-3","depth":4},{"value":"onChange (fields and billing)","id":"onchange-fields-and-billing","depth":2},{"value":"Signature","id":"signature-4","depth":4},{"value":"onChange (submit)","id":"onchange-submit","depth":2},{"value":"Signature","id":"signature-5","depth":4},{"value":"onClick","id":"onclick","depth":2},{"value":"Signature","id":"signature-6","depth":4},{"value":"onCollectEnd","id":"oncollectend","depth":2},{"value":"Signature","id":"signature-7","depth":4},{"value":"onCollectStart","id":"oncollectstart","depth":2},{"value":"Signature","id":"signature-8","depth":4},{"value":"onCustomValidation","id":"oncustomvalidation","depth":2},{"value":"Signature","id":"signature-9","depth":4},{"value":"onDeleteTokenFailed","id":"ondeletetokenfailed","depth":2},{"value":"Signature","id":"signature-10","depth":4},{"value":"onDeleteTokenSuccess","id":"ondeletetokensuccess","depth":2},{"value":"Signature","id":"signature-11","depth":4},{"value":"onFocus","id":"onfocus","depth":2},{"value":"Signature","id":"signature-12","depth":4},{"value":"onGetFingerprintResult","id":"ongetfingerprintresult","depth":2},{"value":"Signature","id":"signature-13","depth":4},{"value":"onOnceCardClick","id":"ononcecardclick","depth":2},{"value":"Signature","id":"signature-14","depth":4},{"value":"onPostAuthentication","id":"onpostauthentication","depth":2},{"value":"Signature","id":"signature-15","depth":4},{"value":"onPostAuthorisation","id":"onpostauthorisation","depth":2},{"value":"Signature","id":"signature-16","depth":4},{"value":"Event data","id":"event-data-1","depth":4},{"value":"Example implementation","id":"example-implementation-1","depth":4},{"value":"onPostInitiateAuthentication","id":"onpostinitiateauthentication","depth":2},{"value":"Signature","id":"signature-17","depth":4},{"value":"onPostTokenisation","id":"onposttokenisation","depth":2},{"value":"Signature","id":"signature-18","depth":4},{"value":"Example implementation","id":"example-implementation-2","depth":4},{"value":"onPreAuthentication","id":"onpreauthentication","depth":2},{"value":"Signature","id":"signature-19","depth":4},{"value":"onPreAuthorisation","id":"onpreauthorisation","depth":2},{"value":"Signature","id":"signature-20","depth":4},{"value":"Event data","id":"event-data-2","depth":4},{"value":"Example implementation","id":"example-implementation-3","depth":4},{"value":"onPreDeleteToken","id":"onpredeletetoken","depth":2},{"value":"Signature","id":"signature-21","depth":4},{"value":"onPreInitiateAuthentication","id":"onpreinitiateauthentication","depth":2},{"value":"Signature","id":"signature-22","depth":4},{"value":"onPreRenderTokens","id":"onprerendertokens","depth":2},{"value":"Signature","id":"signature-23","depth":4},{"value":"onPreRetrySoftDecline","id":"onpreretrysoftdecline","depth":2},{"value":"Signature","id":"signature-24","depth":4},{"value":"onPreTokenisation","id":"onpretokenisation","depth":2},{"value":"Signature","id":"signature-25","depth":4},{"value":"onRetrieveTokensFailed","id":"onretrievetokensfailed","depth":2},{"value":"Signature","id":"signature-26","depth":4},{"value":"onRetrieveTokensSuccess","id":"onretrievetokenssuccess","depth":2},{"value":"Signature","id":"signature-27","depth":4},{"value":"onSelectToken","id":"onselecttoken","depth":2},{"value":"Signature","id":"signature-28","depth":4},{"value":"Example implementation","id":"example-implementation-4","depth":4},{"value":"onStartSubmit","id":"onstartsubmit","depth":2},{"value":"Signature","id":"signature-29","depth":4},{"value":"onSubmitError","id":"onsubmiterror","depth":2},{"value":"Signature","id":"signature-30","depth":4},{"value":"Example implementation","id":"example-implementation-5","depth":4},{"value":"onUpdateTokenFailed","id":"onupdatetokenfailed","depth":2},{"value":"Signature","id":"signature-31","depth":4},{"value":"onUpdateTokenSuccess","id":"onupdatetokensuccess","depth":2},{"value":"Signature","id":"signature-32","depth":4},{"value":"onValidation","id":"onvalidation","depth":2},{"value":"Signature","id":"signature-33","depth":4},{"value":"Example implementation","id":"example-implementation-6","depth":4},{"value":"onValidationFailed","id":"onvalidationfailed","depth":2},{"value":"Signature","id":"signature-34","depth":4},{"value":"onValidationPassed","id":"onvalidationpassed","depth":2},{"value":"Signature","id":"signature-35","depth":4},{"value":"Example implementation","id":"example-implementation-7","depth":4},{"value":"onValidationError","id":"onvalidationerror","depth":2},{"value":"Signature","id":"signature-36","depth":4},{"value":"onPaste","id":"onpaste","depth":2},{"value":"Signature","id":"signature-37","depth":4},{"value":"selectTokenItemBuilder","id":"selecttokenitembuilder","depth":2},{"value":"Signature","id":"signature-38","depth":4},{"value":"tokenItemBuilder","id":"tokenitembuilder","depth":2},{"value":"Signature","id":"signature-39","depth":4},{"value":"tokenLabelBuilder","id":"tokenlabelbuilder","depth":2},{"value":"Signature","id":"signature-40","depth":4},{"value":"Example implementation","id":"example-implementation-8","depth":4},{"value":"FieldComponent.onTriggerFieldValidation","id":"fieldcomponentontriggerfieldvalidation","depth":2}],"frontmatter":{"seo":{"title":"Events"}},"lastModified":"2026-06-12T11:56:36.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/checkout/components/ios/card/events","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}