Common Error Codes

Common error codes and what they mean in 2settle

Code	HTTP	Description	Resolution
MISSING_API_KEY	401	No X-API-Key header	Add API key header
INVALID_API_KEY	401	API key not found	Check API key
INVALID_SIGNATURE	401	HMAC mismatch	Verify signature logic
SIGNATURE_EXPIRED	401	Timestamp too old	Use current timestamp
PERMISSION_DENIED	403	Missing permission	Request permission
RATE_LIMIT_EXCEEDED	429	Too many requests	Implement backoff
VALIDATION_ERROR	400	Invalid input	Check request body
PAYMENT_NOT_FOUND	404	Reference not found	Verify reference
PAYMENT_EXPIRED	400	Payment timed out	Create new payment
ALREADY_CLAIMED	400	Gift already claimed	Cannot reclaim
ALREADY_FULFILLED	400	Request already fulfilled	Cannot refulfill
INVALID_NETWORK	400	Crypto/network mismatch	Check valid combinations