Prepare payout method accounts and returning shoppers before you mount Drop-in.
If you haven't already, make sure that you have activated the Payout Drop-in service and any relevant payout method services in the Unity Portal. For more information, see our Activation guide.
Payout Drop-in shows only methods the session allows and for which the shopper already has an eligible stored instrument (or linked PayPal account). It doesn't collect a new card Primary Account Number (PAN) for first-time vaulting on the withdrawal page.
Card in Drop-in uses vaulted plain-card tokens for the authenticated shopper.
- Activate the Card service and Payout Drop-in service for the site. See Activation.
- Enable card under Payout Drop-in in the payout method configuration. See Payout methods.
- Store eligible plain-card tokens for returning shoppers through your programme's pay-in or tokenisation flows before they reach withdrawal.
- Pass the merchant group
ownerIdand a shopper ID fromonGetShopperso Drop-in can load active tokens.
Card appears only when the payout session includes allowedFundingTypes.cards (including an empty array). cardSchemes alone doesn't enable card. Device wallet tokens (walletType ApplePay or GooglePay with panType Device) appear under Apple Pay or Google Pay instead.
For Token Vault concepts, see our Token Vault guide. For Drop-in card behaviour, see Card.
A method allowed on the payout session isn't enough. Drop-in also needs an eligible instrument after expiry, wallet-type, and blacklist filtering. Plan an empty-state test where the shopper has no eligible instruments to confirm SDK1701 handling. See How it works.