What happened
The source wallet is missing required signing configuration — for example, it has no signing organization or suborganization set up, or its signing setup is not usable. The payout could not be initiated and is in a terminal failed state withfailureCode: crypto_wallet_misconfigured.
Common causes
- Incomplete signing activation — a non-custodial wallet application was approved but the signing activation step did not complete successfully
- Signing setup unusable — the wallet’s signing setup is incomplete or no longer usable, so Conduit cannot sign for it
Recovery
1. Confirm the terminal statestatus: "failed" and failureCode: "crypto_wallet_misconfigured".
2. Check the wallet status
status field. An active wallet should have complete signing configuration. If the wallet is in a non-active status, investigate the application or conversion flow.
3. Contact support if the wallet appears active
If the wallet status is active but payouts still fail with this code, contact support with the wallet ID and transaction ID. The signing configuration may need to be repaired by the Conduit team.
Prevention
- Wait for wallet activation — do not submit payouts against a wallet until its status is
activeand any pending applications or conversions have completed - Handle
transaction.failedwith this code — branch onfailureCode === 'crypto_wallet_misconfigured'to surface a “wallet setup incomplete” message and direct the customer to complete the activation flow
Related webhooks
Thetransaction.failed event fires when the misconfiguration is detected:
Related endpoints
- GET /v2/transactions/:id — read transaction state
- GET /v2/customers/:customerId/wallets/:walletId — read wallet status