Technical Reference

Errors

This page is a reference to error codes returned by MiniKit.

Verify

Below are the error codes you could receive with the Verify command

CodeDescriptionHow to fix?
verification_rejectedUser rejected the World ID request in World App.If this was a mistake, trigger the verify command again.
max_verifications_reachedThis person has already verified for this particular action the maximum number of times allowed.Nothing to do. User cannot verify for this action again.
credential_unavailableThis user does not have the requested credential.

The user must verify at the Orb or verify their unique device in World App to receive the credential required.

malformed_requestThe request payload couldn't be decrypted or did not conform to the standard.Ensure MiniKit is configured properly and all parameters are valid.
invalid_networkThe application is configured for a different environment than the verifying user's client.

Ensure you use the Worldcoin Simulator for Staging applications and World App for Production applications.

inclusion_proof_failedThe sequencer returned an unexpected error when retrieving the inclusion proof.

Ask the user to try again. This may be due to a temporary network issue, or a bug with World App or the Signup Sequencer.

inclusion_proof_pending

The user might have the requested credential, but it is not available on-chain yet. It might be available for API verification.

Ask the user to verify again in approximately one hour.
unexpected_responseThere was a problem with the response obtained from the WLD app.Try again, though in most cases these will require contacting us to report the bug.
generic_errorAn unhandled exception occurred.Try again, though in most cases these will require contacting us to report the bug.

Pay

Below are the error codes you could receive with the Pay command

CodeDescriptionHow to fix?
input_errorThere was a problem with this request. Please try again or contact the app owner.Ensure the request is properly formed and try again.
payment_rejectedYou’ve cancelled the payment in World App.If this was a mistake, initiate the payment again.
invalid_receiverThe receiver address is invalid. Please contact the app owner.You don't have this address whitelisted inside the Developer Portal.
insufficient_balanceYou do not have enough balance to complete this transaction.Add more funds to your wallet
transaction_failedThe transaction failed. Please try again.Try the transaction again. Something failed on-chain.
generic_errorSomething unexpected went wrong. Please try again.Try again, though in most cases these will require contacting us to report the bug.

Wallet Auth

Below are the error codes you could receive with the walletAuth command

CodeDescriptionHow to fix?
malformed_requestProvided parameters in the request are invalid.

Ensure the request is properly formed and try again. If the problem persists, contact the app owner.

user_rejectedUser rejected the request.If this was a mistake, initiate the request again.
generic_errorSomething unexpected went wrong.Try the request again. If the problem persists, contact the app owner.