{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["sub-heading","br","required","details"]},"type":"markdown"},"seo":{"title":"Configuration","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"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"configuration","__idx":0},"children":["Configuration"]},{"$$mdtype":"Tag","name":"SubHeading","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Configure Payout Drop-in once at initialisation for environment, session, transaction data, callbacks, and method options."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Payout Drop-in uses a single configuration object passed to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayoutDropIn.initialize()"]},". You only configure Drop-in once. It then loads site branding and method order from Unity, reads funding permissions from the payout session, and renders only methods that still have eligible stored instruments after filtering."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You typically configure:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Session data:"]}," Which funding types are allowed for this withdrawal."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionData"]},": Amount, currency, and your merchant transaction identifiers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Callbacks:"]}," Shopper identity, success and error handling, and optional submit hooks."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["methodConfig"]},": Optional instrument blacklists."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["localisation.payoutDropIn"]},": Optional copy overrides."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Branding colours, fonts, and method order usually come from the payout configuration API rather than custom CSS."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"configuration-structure","__idx":2},"children":["Configuration structure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following example shows a complete initialiser shape with required fields and common optional callbacks:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"import {\n  PayoutDropIn,\n  type PayoutDropInSubmitResult,\n  type PayoutDropInMethodConfig,\n} from '@pxpio/web-components-sdk';\nimport type { BaseSdkException } from '@pxpio/web-components-sdk';\n\nconst methodConfig: PayoutDropInMethodConfig = {\n  card: {\n    blacklistedInstruments: {\n      gatewayTokenIds: ['token-to-hide'],\n    },\n  },\n  paypal: {\n    blacklistedPayerId: 'payer-id-to-hide',\n  },\n};\n\nconst payoutDropIn = PayoutDropIn.initialize({\n  environment: 'test',\n  session: sessionData,\n  ownerId: 'YOUR-MERCHANT-GROUP-ID',\n  transactionData: {\n    currency: 'USD',\n    amount: 25,\n    entryType: 'Ecom',\n    merchantTransactionId: 'withdrawal-123',\n    merchantTransactionDate: () => new Date().toISOString(),\n  },\n  onGetShopper: () => Promise.resolve({ id: 'shopper-123' }),\n  onSuccess: (result: PayoutDropInSubmitResult) => {\n    void verifyPayoutOnBackend(result);\n  },\n  onError: (error: BaseSdkException) => {\n    console.error(error.ErrorCode, error.message);\n  },\n  onBeforeSubmit: async (payoutMethod) => {\n    console.log('About to submit:', payoutMethod);\n    return true;\n  },\n  onSubmit: (payoutMethod) => {\n    console.log('Submit started:', payoutMethod);\n  },\n  analyticsEvent: (event) => {\n    console.log(event.eventName, event.sessionId);\n  },\n  methodConfig,\n  localisation: {\n    payoutDropIn: {\n      loadingText: 'Loading withdrawal methods…',\n      cardLabel: 'Debit or credit card',\n    },\n  },\n});\n\nawait payoutDropIn.create('payout-drop-in-container');\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayoutDropIn.initialize()"]}," returns an instance with:"]},{"$$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":{"width":"30%","data-label":"Method"},"children":["Method "]},{"$$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":["create(containerId)"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The method that mounts Drop-in into a DOM element by ID."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["destroy()"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The method that unmounts Drop-in and clears loading or error shells in the container."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getComponent()"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Advanced access to the underlying component instance."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"required-configuration","__idx":3},"children":["Required configuration"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"environment","__idx":4},"children":["Environment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Set the Unity environment for the Drop-in instance:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"environment: 'test' // or 'live'\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use one of these values:"]},{"$$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":"Value"},"children":["Value"]},{"$$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":["test"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The sandbox Unity environment for development and QA."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["live"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The production Unity environment."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["test"]}," with test site configuration and test instruments until you complete ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/web/testing"},"children":["Testing"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"session-data","__idx":5},"children":["Session data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pass the payout session object returned by your backend:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"session: sessionData\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Required session fields for SDK operation:"]},{"$$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":"Field"},"children":["Field"]},{"$$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":["sessionId"]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The session identifier for Unity API calls."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hmacKey"]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The session HMAC secret (validated at initialise)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["encryptionKey"]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The key used for encrypted SDK payloads."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Common optional session fields:"]},{"$$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":{"width":"30%","data-label":"Field"},"children":["Field "]},{"$$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":["allowedFundingTypes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The funding types that gate which payout methods can appear. Card requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cards"]}," to be present. Wallets use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["wallets.paypal"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["wallets.applePay"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["wallets.googlePay"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isClosedLoopEnforced"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Whether Drop-in loads closed-loop allocation and enforcement UI where configured."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["restrictions"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A shared restrictions object on the session."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A method allowed on the session still appears only when the shopper has an eligible stored instrument after filtering."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create the session on your backend. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/web/quickstart"},"children":["Quickstart"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/web/implementation"},"children":["Implementation"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"owner-identification","__idx":6},"children":["Owner identification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pass the merchant group ID used for token vault lookups:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"ownerId: 'YOUR-MERCHANT-GROUP-ID'\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ownerType"]}," is set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MerchantGroup"]}," during initialisation. Token vault requests use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ownerType"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ownerId"]}," when retrieving active tokens."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"transaction-data","__idx":7},"children":["Transaction data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Don't pass payment intents on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionData"]},". The SDK sets payout intents (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paypal"]},", and related intents) to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Payout"]}," internally."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following properties are required on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionData"]},":"]},{"$$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":["currency"]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ISO 4217 currency code. Match the currency on the Payout Session."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["number"]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The payout amount. Match the amount on the payout session."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["entryType"]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Ecom"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Moto"]}]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The channel for the payout."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantTransactionId"]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your withdrawal correlation ID."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantTransactionDate"]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Details","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["() => string"]}]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A function that returns an ISO 8601 timestamp."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"merchant-transaction-id","__idx":8},"children":["Merchant transaction ID"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Generate a unique ID per withdrawal attempt:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"merchantTransactionId: crypto.randomUUID()\n// or\nmerchantTransactionId: `withdrawal-${internalId}`\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"required-callbacks","__idx":9},"children":["Required callbacks"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These callbacks are required on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayoutDropIn.initialize()"]},":"]},{"$$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":{"width":"15%","data-label":"Callback"},"children":["Callback "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"35%","data-label":"Signature"},"children":["Signature "]},{"$$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":["onSuccess"]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(result: PayoutDropInSubmitResult) => void"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The callback fires after successful SDK payout submission."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(error: BaseSdkException) => void"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The callback fires for configuration, empty-method, and payout failures delivered through the SDK error path."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayoutDropInSubmitResult"]}," can include:"]},{"$$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":{"width":"30%","data-label":"Field"},"children":["Field "]},{"$$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":["systemTransactionId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The Unity system transaction ID for a single-method payout."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantTransactionId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An echo of your merchant transaction ID when present."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payoutMethod"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The method used (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Card"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Paypal"]},") when applicable."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payouts"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The closed-loop results: one entry per created payout transaction. Each entry includes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["systemTransactionId"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantTransactionId"]},". When a line isn't ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorised"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Pending"]},", it can also include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errorCode"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errorReason"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treat ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSuccess"]}," as submission acknowledgement, not confirmation that every closed-loop line settled successfully. Inspect each ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payouts"]}," entry and verify final payout state on your backend before updating withdrawal status."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Some failures occur outside ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]}," (e.g., a rejected ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onGetShopper"]}," promise or synchronous initialise validation). Wrap ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["initialize()"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create()"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["try"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["catch"]},". See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/web/error-handling"},"children":["Error handling"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/web/events"},"children":["Events"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"optional-configuration","__idx":10},"children":["Optional configuration"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ongetshopper","__idx":11},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onGetShopper"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Strongly recommended whenever you expect stored cards, Apple Pay or Google Pay device tokens, or PayPal."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"onGetShopper: async () => {\n  const user = await getAuthenticatedUser();\n  return { id: user.shopperId };\n},\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The callback must resolve to this field:"]},{"$$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":"Return field"},"children":["Return field"]},{"$$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":["id"]},{"$$mdtype":"Tag","name":"Break","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The shopper ID used for token vault and PayPal wallet association lookups."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Without a shopper ID, token retrieval is skipped and PayPal can't resolve a linked account. Methods may disappear silently rather than throwing. If the promise rejects, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create()"]}," rejects. Handle that outside ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"submit-callbacks","__idx":12},"children":["Submit callbacks"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These optional callbacks control pre-submit validation, loading UI, and analytics:"]},{"$$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":{"width":"20%","data-label":"Callback"},"children":["Callback "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"20%","data-label":"Wired for"},"children":["Wired for "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Behaviour"},"children":["Behaviour"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onBeforeSubmit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Card"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Apple Pay"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Google Pay"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The callback receives the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayoutMethod"]}," value. Return ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}," (or a promise that resolves to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]},") to cancel submission."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSubmit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Card"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Apple Pay"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Google Pay"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The callback fires when card-on-file submit starts."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["analyticsEvent"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["All"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An analytics hook. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/web/analytics"},"children":["Analytics"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["PayPal uses ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSuccess"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]}," only. There is no Drop-in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onCancel"]}," for the PayPal stored panel."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPayoutMethodChange"]}," isn't available on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayoutDropIn.initialize()"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"methodconfig","__idx":13},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["methodConfig"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Payout-only instrument exclusion for the stored-instrument panels (card, Apple Pay, Google Pay, and PayPal)."]},{"$$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":{"width":"40%","data-label":"Path"},"children":["Path "]},{"$$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":["card.blacklistedInstruments"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gatewayTokenIds"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["schemeTokenIds"]}," arrays of token IDs to hide from the card list."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["applePay.blacklistedInstruments"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The same object shape as card: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gatewayTokenIds"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["schemeTokenIds"]}," arrays of strings that identify Apple Pay device tokens to hide."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["googlePay.blacklistedInstruments"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The same object shape as card: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gatewayTokenIds"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["schemeTokenIds"]}," arrays of strings that identify Google Pay device tokens to hide."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paypal.blacklistedPayerId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The payer ID that hides PayPal when it matches the linked account."]}]}]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"const methodConfig: PayoutDropInMethodConfig = {\n  card: {\n    blacklistedInstruments: {\n      gatewayTokenIds: ['<GATEWAY_TOKEN_ID>'],\n      schemeTokenIds: ['<SCHEME_TOKEN_ID>'],\n    },\n  },\n  applePay: {\n    blacklistedInstruments: {\n      gatewayTokenIds: ['<GATEWAY_TOKEN_ID>'],\n    },\n  },\n  googlePay: {\n    blacklistedInstruments: {\n      schemeTokenIds: ['<SCHEME_TOKEN_ID>'],\n    },\n  },\n  paypal: {\n    blacklistedPayerId: '<PAYPAL_PAYER_ID>',\n  },\n};\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Blacklists hide instruments or methods in the accordion. When closed-loop enforcement is active, the same values are also sent on the closed-loop allocation request. Always enforce payout eligibility on your backend."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"localisation","__idx":14},"children":["Localisation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Override merchant-facing strings under ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["localisation.payoutDropIn"]},":"]},{"$$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":"Key"},"children":["Key"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardLabel"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paypalLabel"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["applePayLabel"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["googlePayLabel"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The accordion method labels."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["loadingText"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The text shown while ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create()"]}," loads configuration."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["noPayoutMethodsError"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The message when no methods remain."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["containerAriaLabel"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payoutMethodsGroupAriaLabel"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The accessibility labels for the Drop-in root and method group."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payoutMethodExpandedAnnouncement"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payoutMethodCollapsedAnnouncement"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The screen reader announcements; use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{method}"]}," as a placeholder."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardOnFileTitle"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardOnFileLoadingAriaLabel"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The card-on-file panel heading and loading label."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payoutNotSupportedForCard"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The message shown when a Visa or Mastercard token is present but not selectable under gaming payout rules."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["preferredMethodTitle"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["preferredMethodDescription"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["preferredMethodAmountLabel"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["preferredMethodGroupLabel"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Copy for the customer-driven preferred-method closed-loop screen."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mandatoryAllocationTitle"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mandatoryAllocationDescription"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mandatoryRemainingDescription"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mandatorySelectPaymentMethodLabel"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Copy for the mandatory allocation closed-loop screen. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mandatoryRemainingDescription"]}," supports ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{currency}"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{amount}"]}," placeholders."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["finalAllocationTitle"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["finalAllocationDescription"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["finalAllocationTotalLabel"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["finalAllocationExcessAmountLabel"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["finalAllocationExcessGroupLabel"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["finalAllocationPolicyMessage"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["finalAllocationPolicyLinkLabel"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["finalAllocationRejectedMessage"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["finalAllocationAcceptLabel"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["finalAllocationBackLabel"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["finalAllocationContinueLabel"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Copy for the final allocation and review closed-loop screens."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"closed-loop-enforcement","__idx":15},"children":["Closed-loop enforcement"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the session returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isClosedLoopEnforced: true"]},", Drop-in requests closed-loop allocation and site closed-loop configuration during ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create()"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If allocation succeeds and enforcement is customer-driven, Drop-in opens the preferred-method closed-loop UI."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If allocation succeeds and enforcement isn't customer-driven, Drop-in opens the mandatory-allocation closed-loop UI."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If allocation doesn't succeed (without throwing), Drop-in falls back to the standard payout accordion and doesn't call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]}," for that fallback."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If allocation or closed-loop config retrieval throws, Drop-in calls ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]}," (typically ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0000"]},") and shows an error shell in the container."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can configure the informational banner with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["closedLoopConfig"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"closedLoopConfig: {\n  helpUrl: 'https://example.com/payout-policy',\n  hideInformationBanner: false,\n},\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These properties control the banner:"]},{"$$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":["helpUrl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A help or FAQ URL opened from the closed-loop policy banner."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hideInformationBanner"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},", hides the informational banner. Defaults to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Closed-loop submit still delivers results through ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSuccess"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]},". For ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSuccess"]},", inspect every entry in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payouts"]},": lines that aren't ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorised"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Pending"]}," can include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errorCode"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errorReason"]},". Submit failures on the closed-loop path can also raise ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1703"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayoutDropInCardPayoutFailedSdkException"]}," (message typically ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Card payout failed."]},"), even when more than one instrument was involved."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"inherited-optional-settings","__idx":16},"children":["Inherited optional settings"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These properties come from the shared Web SDK config surface. Most Payout Drop-in integrations leave them unset."]},{"$$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":["paypalConfig"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The stored PayPal panel overlays linked email and payer ID from wallet association and sets SDK-driven submit, so you typically don't need to supply this for that panel."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kountDisabled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}," (default), Kount remains enabled on card-on-file submit where risk screening data is applied."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["clientName"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["siteName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Display names forwarded to provider experiences that support them."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["restrictions"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A shared restrictions object on the SDK config. For payout card-on-file lists, use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["methodConfig"]}," blacklists to hide instruments in the accordion (and on closed-loop allocation when enforcement is active)."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"backend-driven-configuration","__idx":17},"children":["Backend-driven configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Many behaviours are controlled in the Unity Portal and Sessions API rather than in frontend code."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"payout-method-availability","__idx":18},"children":["Payout method availability"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Controlled by session ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedFundingTypes"]}," and shopper instruments. Example session fragment:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"allowedFundingTypes\": {\n    \"cards\": [],\n    \"cardSchemes\": [\"Visa\", \"Mastercard\"],\n    \"wallets\": {\n      \"paypal\": {},\n      \"applePay\": {},\n      \"googlePay\": {}\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The session response may also include wallet metadata such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantId"]}," when those methods are enabled for the site. The SDK treats a wallet method as a candidate when its wallet object is present."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Remember:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Card requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedFundingTypes.cards"]}," to be present (including ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[]"]},"). ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardSchemes"]}," alone doesn't enable card."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Wallet methods need their wallet entry and an eligible stored instrument."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"branding-and-method-order","__idx":19},"children":["Branding and method order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fetched from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/payout-dropin/configurations"]},". When site config includes a manual payment-method order, Drop-in applies that order. Otherwise it uses the SDK default order. For the methods covered in these guides, that relative order is card, Apple Pay, Google Pay, then PayPal. Other enabled methods can appear in the default list between or after those entries."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"complete-configuration-examples","__idx":20},"children":["Complete configuration examples"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"minimal-configuration","__idx":21},"children":["Minimal configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this pattern when you only need required fields and backend verification:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"const payoutDropIn = PayoutDropIn.initialize({\n  environment: 'test',\n  session: sessionData,\n  ownerId: 'YOUR-MERCHANT-GROUP-ID',\n  transactionData: {\n    currency: 'USD',\n    amount: 25,\n    entryType: 'Ecom',\n    merchantTransactionId: crypto.randomUUID(),\n    merchantTransactionDate: () => new Date().toISOString(),\n  },\n  onGetShopper: () => Promise.resolve({ id: 'shopper-123' }),\n  onSuccess: (result) => {\n    void fetch('/api/verify-payout', {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify(result),\n    });\n  },\n  onError: (error) => {\n    console.error(error.ErrorCode, error.message);\n  },\n});\n\nawait payoutDropIn.create('payout-drop-in-container');\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"full-configuration","__idx":22},"children":["Full configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this pattern when you also need blacklists, localisation, and submit hooks:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"const payoutDropIn = PayoutDropIn.initialize({\n  environment: 'live',\n  session: sessionData,\n  ownerId: 'YOUR-MERCHANT-GROUP-ID',\n  transactionData: {\n    currency: 'USD',\n    amount: 100,\n    entryType: 'Ecom',\n    merchantTransactionId: `wd-${withdrawalId}`,\n    merchantTransactionDate: () => new Date().toISOString(),\n  },\n  onGetShopper: async () => ({ id: (await getUser()).shopperId }),\n  onBeforeSubmit: async (payoutMethod) => {\n    const allowed = await fetch('/api/withdrawal-allowed', {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({ withdrawalId, payoutMethod }),\n    }).then((r) => r.json());\n    return allowed.ok;\n  },\n  onSubmit: () => {\n    document.getElementById('payout-loading')!.hidden = false;\n  },\n  onSuccess: async (result) => {\n    document.getElementById('payout-loading')!.hidden = true;\n    await reconcileWithdrawal(result);\n  },\n  onError: (error) => {\n    document.getElementById('payout-loading')!.hidden = true;\n    showSafeError(error.ErrorCode);\n  },\n  analyticsEvent: (event) => {\n    sendToAnalytics(event);\n  },\n  methodConfig: {\n    card: {\n      blacklistedInstruments: {\n        gatewayTokenIds: blockedTokens,\n      },\n    },\n  },\n  localisation: {\n    payoutDropIn: {\n      loadingText: 'Preparing your withdrawal options…',\n    },\n  },\n  closedLoopConfig: {\n    helpUrl: 'https://example.com/payout-policy',\n  },\n});\n\nawait payoutDropIn.create('payout-drop-in-container');\n","lang":"typescript"},"children":[]}]},"headings":[{"value":"Configuration","id":"configuration","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Configuration structure","id":"configuration-structure","depth":2},{"value":"Required configuration","id":"required-configuration","depth":2},{"value":"Environment","id":"environment","depth":3},{"value":"Session data","id":"session-data","depth":3},{"value":"Owner identification","id":"owner-identification","depth":3},{"value":"Transaction data","id":"transaction-data","depth":3},{"value":"Merchant transaction ID","id":"merchant-transaction-id","depth":4},{"value":"Required callbacks","id":"required-callbacks","depth":3},{"value":"Optional configuration","id":"optional-configuration","depth":2},{"value":"onGetShopper","id":"ongetshopper","depth":3},{"value":"Submit callbacks","id":"submit-callbacks","depth":3},{"value":"methodConfig","id":"methodconfig","depth":3},{"value":"Localisation","id":"localisation","depth":3},{"value":"Closed-loop enforcement","id":"closed-loop-enforcement","depth":3},{"value":"Inherited optional settings","id":"inherited-optional-settings","depth":3},{"value":"Backend-driven configuration","id":"backend-driven-configuration","depth":2},{"value":"Payout method availability","id":"payout-method-availability","depth":3},{"value":"Branding and method order","id":"branding-and-method-order","depth":3},{"value":"Complete configuration examples","id":"complete-configuration-examples","depth":2},{"value":"Minimal configuration","id":"minimal-configuration","depth":3},{"value":"Full configuration","id":"full-configuration","depth":3}],"frontmatter":{"seo":{"title":"Configuration"}},"lastModified":"2026-11-12T15:20:37.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/payout/drop-in/web/configuration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}