Error Handling
The AkashicPay SDK may throw or return errors (extending the default error object of the language) with specific error codes. For the /payout endpoint, errors are typically returned rather than thrown. Below is a list of Akashic-specific errors, their explanations, and recommended actions.
| Error Code | Explanation | What to Do |
|---|---|---|
| OTK_ONBOARDING_FAILED | Failed to set up an OTK on AkashicChain for testing. | Try again. If it persists, contact AkashicPay Support. |
| INVALID_PRIVATE_KEY_FORMAT | The private key or recovery phrase used to instantiate the SDK is invalid. | Double-check your variables and try again. |
| WALLET_CREATION_FAILURE | Failed to create an L1 wallet on AkashicChain. | Try again. If it persists, contact AkashicPay Support. |
| UNHEALTHY_WALLET | A wallet was created on AkashicChain but could not be verified as safe. | Try again. If it persists, contact AkashicPay Support. |
| ACCESS_DENIED | Attempted to access the OTK in a production environment (not allowed). | Do not attempt this in production. |
| L2ADDRESS_NOT_FOUND | Formatting error or the L2 address does not exist for a Layer 2 transaction. | Double-check your input and try again. |
| NOT_SIGNED_UP | SDK instantiated without completing setup on AkashicPay.com. | Complete the setup on AkashicPay.com and try again. |
| FUNDS_EXCEEDED | Attempted to withdraw more funds than available. | Check your balances and inputs and try again. |
| ASSIGNMENT_FAILED | Failed to create an L1 wallet on AkashicChain. | Try again. If it persists, contact AkashicPay Support. |
| INVALID_PARAMETER | Invalid argument provided to a function (Java and C# only). | Double-check your inputs for syntax errors. |
| UNKNOWN_ERROR | An unspecified error occurred. | Check the error message details. Retry after a short delay. If it persists, contact AkashicPay Support. |