Skip to main content

What happened

The source wallet is missing required custody configuration — for example, the non-custodial wallet has no signing organization or suborganization set up. The payout could not be initiated and is in a terminal failed state with failureCode: crypto_wallet_misconfigured.

Common causes

  • Incomplete custody activation — a non-custodial wallet application was approved but the custody activation step did not complete successfully

Recovery

This is a terminal state. No funds were moved. The original transaction cannot be recovered; you must resolve the wallet configuration before submitting a new transaction.
1. Confirm the terminal state
The response will show status: "failed" and failureCode: "crypto_wallet_misconfigured". 2. Check the wallet status
Inspect the status field. An active wallet should have complete custody 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 custody 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 active and any pending applications or conversions have completed
  • Handle transaction.failed with this code — branch on failureCode === 'crypto_wallet_misconfigured' to surface a “wallet setup incomplete” message and direct the customer to complete the activation flow
The transaction.failed event fires when the misconfiguration is detected: