Resources

Troubleshooting

Diagnose the most common setup, connection and transaction issues.

Connect Wallet is hidden

Both conditions must be true:

enabledMethods.connectWallet is explicitly set to true.
A non-null partnerContractDeposit adapter is passed to Checkout.

An installed wallet is missing

Confirm the extension is enabled for the current browser profile.
Reload the page after installing or unlocking the wallet.
Confirm the integration is rendered inside D0fiWalletProvider.
Avoid private browsing modes that block extension injection.

The wallet is on the wrong network

For EVM, call getClientForChainAsync(policy.chainId) insideexecute. The SDK requests a switch when required and returns a fresh client pinned to the selected chain. For Solana and TRON, verify the connected provider is on the server-approved network before signing.

The Checkout layout looks broken

Import the stylesheet once from your application entry:

import '@d0fi/checkout-react/styles.css';

A transaction stays pending

Open the transaction in the explorer selected for its network and inspect the matching backend chain reader. A hash displayed by Checkout records submission only; it does not become an authoritative paid status in the browser.