Error Reference
Complete guide to error codes and troubleshooting
HTTP Status Codes
400 Bad Request
The request was malformed or missing required fields.
{
"error": "Invalid request",
"message": "Missing required field: transaction"
}402 Payment Required
Payment is required to access this resource.
{
"error": "Payment required",
"payment": {
"amount": 10000,
"token": "USDC",
"network": "solana",
"facilitator": "https://getconduit.io/api/facilitator"
}
}403 Forbidden
Payment verification failed or transaction is invalid.
{
"error": "Payment verification failed",
"message": "Invalid signature or insufficient amount"
}500 Internal Server Error
An unexpected error occurred on the server.
{
"error": "Internal server error",
"message": "An unexpected error occurred"
}503 Service Unavailable
The Solana network or facilitator is temporarily unavailable.
{
"error": "Service unavailable",
"message": "Solana network is currently unavailable"
}Common Issues
Insufficient Funds
The payer's wallet doesn't have enough USDC to complete the payment.
Solution: Ensure the wallet has sufficient USDC balance before making the request.
Invalid Signature
The transaction signature is invalid or doesn't match the payer.
Solution: Verify the transaction is properly signed by the correct keypair.
Network Timeout
The Solana network took too long to respond.
Solution: Retry the request or check Solana network status.
Replay Attack Detected
The same transaction was submitted multiple times.
Solution: Create a new transaction for each request.
Need Help?
If you're experiencing issues not covered here, reach out to our support team.