Phantom Portal setup
This section applies to embedded-wallet integrations and to apps that appear in Phantom’s Explore tab and search results. If you configure only theinjected provider in the React or Browser SDK, skip to Integration testing.
Account created in Phantom Portal
Go to phantom.com/portal and sign in with Google or Apple. Phantom Portal overview →App created and configured in Phantom Portal
Confirm that your app is fully set up in Phantom Portal:- The app has been created in Phantom Portal.
- Branding and app details have been added.
- The domain has been verified.
- Allowed origin URLs have been configured.
- An App ID has been generated.
- The app access mode is set to
PUBLIC.
Integration testing
Validate that your integration works correctly across common user flows:- Wallet connection and authentication work through Phantom Connect.
- Transaction signing works on all supported networks.
- Spending limit behavior is correct, if you’re using embedded wallets.
- Error handling works as expected for rejected transactions or insufficient funds.
- The app behaves correctly across browsers and devices.
Security
Verify that basic security requirements are met:- HTTPS is enforced across all production URLs.
- No private keys or sensitive data are logged.
- All transactions clearly display the correct amounts and intent to users.
Common issues
Transactions fail
If transactions fail during testing or after launch, common causes include the following:- Insufficient funds to cover gas or rent.
- Contract errors or RPC-related failures.
App doesn’t show in the Explore tab
If your app isn’t visible in the Explore tab, it’s usually because of the following reason:- Cause: Your app profile changes are still under review.
- Solution: Wait for Phantom to approve the updates. Once approved, changes appear immediately.
Need help?
Support
Get help from our developer support team
FAQ
Find answers to common questions