{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["sub-heading","endpoint","json-example"]},"type":"markdown"},"seo":{"title":"Card","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":["openapi"],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"card","__idx":0},"children":["Card"]},{"$$mdtype":"Tag","name":"SubHeading","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Withdraw funds using stored debit or credit card tokens."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Card in Payout Drop-in is a stored-instrument flow. The accordion lists vaulted plain-card tokens for the authenticated shopper. The shopper selects a card and submits the withdrawal. Drop-in doesn't collect a new card Primary Account Number (PAN) in this flow."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"key-benefits","__idx":2},"children":["Key benefits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This method gives you:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Card-on-file only:"]}," Shoppers choose from tokens already in the vault."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Unified callbacks:"]}," Same ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onBeforeSubmit"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSubmit"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSuccess"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]}," pattern as Apple Pay and Google Pay card-on-file methods."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["No CVC:"]}," Card-on-file payout submit doesn't require CVC for these tokens."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Token maintenance:"]}," Where the list UI allows it, shoppers can delete tokens and edit expiry."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Branding:"]}," Panel styling comes from your payout site configuration."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-it-works","__idx":3},"children":["How it works"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The flow works like this:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your payout session includes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedFundingTypes.cards"]},". Card is gated on this field."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You return a shopper ID from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onGetShopper"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Drop-in loads active tokens and keeps plain-card instruments that aren't expired or blacklisted."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If at least one token remains, card appears in the accordion."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The shopper selects a card and confirms the withdrawal."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optional ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onBeforeSubmit"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSubmit"]}," run, then payout initiation completes with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSuccess"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If every method is filtered out, Drop-in reports ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1701"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"session-requirements","__idx":4},"children":["Session requirements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Card must be allowed on the payout session through ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedFundingTypes.cards"]},". The SDK treats card as enabled when the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cards"]}," field is present (including an empty array). If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cards"]}," is missing or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},", card isn't offered, even if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardSchemes"]}," is set."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example session fragment:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"allowedFundingTypes\": {\n    \"cards\": [],\n    \"cardSchemes\": [\"Visa\", \"Mastercard\"]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardSchemes"]}," may still appear on the session for other product configuration. It doesn't, by itself, turn on the card payout method."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Match ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionData.amount"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionData.currency"]}," to the payout session amounts."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"shopper-and-token-requirements","__idx":5},"children":["Shopper and token requirements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Card appears only when these shopper and token checks pass:"]},{"$$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":"25%","data-label":"Requirement"},"children":["Requirement "]},{"$$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":["onGetShopper"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The authenticated shopper ID used by the token vault. Without it, token retrieval is skipped and card won't appear."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Plain-card token"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tokens that aren't Apple Pay or Google Pay device wallet tokens (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["walletType"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ApplePay"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GooglePay"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["panType"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Device"]},"). Those device tokens appear under Apple Pay or Google Pay instead. Other stored tokens, including non-device wallet tokens, remain eligible for Card."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Expiry"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Whether the token is still in date. Expired tokens are filtered out. The current month remains valid."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Blacklist"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tokens listed in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["methodConfig.card.blacklistedInstruments"]}," are hidden."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After filtering, Drop-in shows up to five tokens, ranked by most recent successful purchase or payout activity."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"token-loading","__idx":6},"children":["Token loading"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When card is a candidate and a shopper ID is present, Drop-in retrieves active tokens for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ownerType"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MerchantGroup"]}," (set during initialisation) and your configured ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ownerId"]},", for that shopper."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Typical path:"]},{"$$mdtype":"Tag","name":"Endpoint","attributes":{"method":"GET"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["/v1/token-vault/{ownerType}/{ownerId}/merchant-shoppers/{shopperId}/active-tokens"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["From that shared list, card keeps tokens that aren't Apple Pay or Google Pay device wallet tokens. If the token call fails or returns nothing usable for card, the card method is omitted without necessarily calling ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Showing a token in Drop-in doesn't authorise the payout. Confirm amount, destination, and eligibility on your backend before treating the withdrawal as complete."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"configuration","__idx":7},"children":["Configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["methodConfig.card"]}," for blacklists only."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"blacklist-stored-instruments","__idx":8},"children":["Blacklist stored instruments"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["blacklistedInstruments"]}," to hide specific tokens from the card panel:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"import type { PayoutDropInMethodConfig } from '@pxpio/web-components-sdk';\n\nconst methodConfig: PayoutDropInMethodConfig = {\n  card: {\n    blacklistedInstruments: {\n      gatewayTokenIds: ['<GATEWAY_TOKEN_ID>'],\n      schemeTokenIds: ['<SCHEME_TOKEN_ID>'],\n    },\n  },\n};\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["blacklistedInstruments"]}," accepts:"]},{"$$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":["gatewayTokenIds"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The gateway token IDs to hide from the panel."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["schemeTokenIds"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The scheme token IDs to hide from the panel."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Blacklisting hides instruments in the accordion. When closed-loop enforcement is active, the same blacklist values are also sent on the closed-loop allocation request. Confirm payout eligibility on your backend."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"gaming-eligibility","__idx":9},"children":["Gaming eligibility"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For plain-card tokens, Drop-in can show a Visa or Mastercard instrument as present but not selectable when gaming payout eligibility rules don't allow a withdrawal to that card. Other card schemes stay selectable. Apple Pay and Google Pay device tokens don't use these Card gaming rules."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a card is greyed out, Drop-in shows the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["localisation.payoutDropIn.payoutNotSupportedForCard"]}," message. Override that string if you need custom copy. Always confirm payout eligibility on your backend before treating a withdrawal as complete."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"localisation","__idx":10},"children":["Localisation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Override the accordion label and unsupported-card message:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"localisation: {\n  payoutDropIn: {\n    cardLabel: 'Debit or credit card',\n    payoutNotSupportedForCard: \"Payouts aren't available for this card.\",\n  },\n},\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"implementation","__idx":11},"children":["Implementation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following example initialises Drop-in for a card payout. It includes optional ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onBeforeSubmit"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSubmit"]}," hooks, which run on the card-on-file path before ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSuccess"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"import {\n  PayoutDropIn,\n  type PayoutDropInSubmitResult,\n} from '@pxpio/web-components-sdk';\nimport type { BaseSdkException } from '@pxpio/web-components-sdk';\n\nconst payoutDropIn = PayoutDropIn.initialize({\n  environment: 'test',\n  session: sessionData,\n  ownerId: 'YOUR-MERCHANT-GROUP-ID',\n  transactionData: {\n    currency: 'USD',\n    amount: 50,\n    entryType: 'Ecom',\n    merchantTransactionId: crypto.randomUUID(),\n    merchantTransactionDate: () => new Date().toISOString(),\n  },\n  onGetShopper: async () => ({ id: 'shopper-123' }),\n  onBeforeSubmit: async (payoutMethod) => {\n    if (payoutMethod !== 'Card') {\n      return true;\n    }\n    return confirmCardWithdrawal();\n  },\n  onSubmit: (payoutMethod) => {\n    if (payoutMethod === 'Card') {\n      showLoading(true);\n    }\n  },\n  onSuccess: async (result: PayoutDropInSubmitResult) => {\n    showLoading(false);\n    console.log('Card payout submitted', result.systemTransactionId);\n    console.log('Payout method', result.payoutMethod);\n    await verifyPayoutOnBackend(result);\n  },\n  onError: (error: BaseSdkException) => {\n    showLoading(false);\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":2,"id":"success-and-verification","__idx":12},"children":["Success and verification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On success, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSuccess"]}," receives a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayoutDropInSubmitResult"]}," with at least:"]},{"$$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":["systemTransactionId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The PXP system transaction ID."]}]},{"$$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":["Your merchant transaction ID."]}]},{"$$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":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Card"]}," for this method."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treat ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSuccess"]}," as submission acknowledgement. Verify the transaction with your webhook handler or a server-side lookup before updating the shopper's withdrawal status. Deduplicate using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["systemTransactionId"]},", and check amount and currency against the withdrawal you authorised."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A successful card payout merchant webhook looks like this:"]},{"$$mdtype":"Tag","name":"JsonExample","attributes":{"json":{"eventDate":"2025-12-16T07:37:11.1613200Z","eventCategory":"transaction","eventData":{"state":"Authorised","amount":{"transaction":50,"currencyCode":"USD"},"transactionMethod":"Payout","merchant":"merchant-1","site":"site-1","merchantTransactionDate":"2025-12-16T07:37:11.1613200Z","merchantTransactionId":"CARD-PAYOUT-001","systemTransactionId":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","fundingData":{"card":{"cardScheme":"Visa","gatewayTokenId":"1ed768bb-e88a-4636-91ae-67927ccbb03a","schemeTokenNumber":"4837261112345678"}}}},"errors":[]},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/web/quickstart"},"children":["Quickstart"]}," for the end-to-end session and reconciliation pattern, and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/get-started/manage-webhooks"},"children":["Manage webhooks"]}," for subscription and signature validation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-handling","__idx":13},"children":["Error handling"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These codes are the ones you're most likely to see on the card path:"]},{"$$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":"Code"},"children":["Code "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Typical card context"},"children":["Typical card context"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1701"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No payout methods remain. For example, no eligible stored cards and no other methods."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1703"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card payout initiation failed. Inspect ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details"]},"; correlate with backend transaction state."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/web/error-handling"},"children":["Error handling"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"testing","__idx":14},"children":["Testing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Validate the path with these steps:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["environment: 'test'"]}," with sandbox credentials."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Prepare a test shopper that already has a non-expired plain-card token in the vault (not an Apple Pay or Google Pay device token)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create a payout session that includes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedFundingTypes.cards"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm the card accordion appears, token selection works, and submit reaches ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSuccess"]}," or a clear ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1703"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify the transaction on your backend before treating the withdrawal as complete."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/web/testing"},"children":["Testing"]},"."]}]},"headings":[{"value":"Card","id":"card","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Key benefits","id":"key-benefits","depth":3},{"value":"How it works","id":"how-it-works","depth":2},{"value":"Session requirements","id":"session-requirements","depth":2},{"value":"Shopper and token requirements","id":"shopper-and-token-requirements","depth":2},{"value":"Token loading","id":"token-loading","depth":3},{"value":"Configuration","id":"configuration","depth":2},{"value":"Blacklist stored instruments","id":"blacklist-stored-instruments","depth":3},{"value":"Gaming eligibility","id":"gaming-eligibility","depth":3},{"value":"Localisation","id":"localisation","depth":3},{"value":"Implementation","id":"implementation","depth":2},{"value":"Success and verification","id":"success-and-verification","depth":2},{"value":"Error handling","id":"error-handling","depth":2},{"value":"Testing","id":"testing","depth":2}],"frontmatter":{"seo":{"title":"Card"}},"lastModified":"2026-11-12T15:20:37.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/payout/drop-in/web/card","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}