त्रुटि कोड

PayerScan API एक मानकीकृत त्रुटि प्रतिक्रिया प्रारूप का उपयोग करता है। सभी त्रुटियां व्यापारी के backend पर आसान हैंडलिंग के लिए एक सुसंगत संरचना का पालन करती हैं।

त्रुटि प्रतिक्रिया संरचना

{
  "status": "error",
  "message": "Invalid API key. Please check your API key and try again.",
  "error_code": "INVALID_API_KEY",
  "request_id": "ORDER_123456",
  "details": { ... }
}

गुण:

• status: हमेशा "error"।
• message: मानव-पठनीय त्रुटि विवरण।
• error_code: UPPER_SNAKE_CASE प्रारूप में मशीन-पठनीय कोड। स्वचालित हैंडलिंग के लिए switch/case का उपयोग करें।
• request_id (वैकल्पिक): आपका ऑर्डर ID, केवल तभी लौटाया जाता है जब इनवॉइस बनाते समय प्रदान किया गया हो।
• details (वैकल्पिक): त्रुटि के बारे में अतिरिक्त संदर्भ (जैसे, validation त्रुटियां, फ़ील्ड नाम)।

त्रुटि कोड संदर्भ

प्रमाणीकरण त्रुटियां

त्रुटि कोड	HTTP	Message	समाधान
MISSING_API_KEY	401	Missing API key. Please provide x-api-key header.	अपने अनुरोध में x-api-key header जोड़ें।
INVALID_API_KEY	401	Invalid API key. Please check your API key and try again.	Dashboard पर अपनी API key सत्यापित करें।
ACCOUNT_INACTIVE	403	Merchant account is inactive. Please contact support to reactivate.	PayerScan सहायता से संपर्क करें।
STORE_INACTIVE	403	Store is inactive. Please contact support to reactivate your store.	Dashboard पर स्टोर पुनः सक्रिय करें।
AUTHENTICATION_FAILED	500	Authentication failed. Please try again later.	बाद में पुनः प्रयास करें; यदि जारी रहे, तो सहायता से संपर्क करें।

Validation त्रुटियां

त्रुटि कोड	HTTP	Message	समाधान
VALIDATION_ERROR	400	Validation failed. Please check your request body.	विशिष्ट फ़ील्ड समस्याओं के लिए details.errors जांचें।
INVALID_MERCHANT_ID	400	Invalid merchant_id. The merchant_id does not match your API key.	सुनिश्चित करें कि merchant_id API key के स्टोर से मेल खाता है।

व्यावसायिक तर्क त्रुटियां

त्रुटि कोड	HTTP	Message	समाधान
INSUFFICIENT_BALANCE	402	Insufficient balance. Please top-up your account to continue.	PayerScan Dashboard पर टॉप-अप करें। कमी की राशि के लिए details जांचें।
NO_PAYMENT_METHOD	400	No payment method configured. Please add at least one wallet or exchange platform.	Dashboard पर वॉलेट जोड़ें या एक्सचेंज प्लेटफ़ॉर्म कनेक्ट करें।

इनवॉइस त्रुटियां

त्रुटि कोड	HTTP	Message	समाधान
INVOICE_NOT_FOUND	404	Invoice not found.	trans_id सत्यापित करें और सुनिश्चित करें कि यह आपके स्टोर का है।
MISSING_TRANS_ID	400	Missing trans_id in URL.	URL पथ में trans_id शामिल करें: GET /invoice/:trans_id।
INVALID_TRANS_ID_FORMAT	400	Invalid trans_id format.	सही प्रारूप का उपयोग करें: TID-XXXXXXXXXXXXXXXX।

दर सीमा त्रुटियां

त्रुटि कोड	HTTP	Message	समाधान
RATE_LIMIT_EXCEEDED	429	Too many requests per second. / Rate limit exceeded.	retry_after_seconds तक प्रतीक्षा करें और पुनः प्रयास करें। दर सीमाएं देखें।

सर्वर त्रुटियां

त्रुटि कोड	HTTP	Message	समाधान
INTERNAL_ERROR	500	Internal server error. Please try again later.	Exponential backoff के साथ पुनः प्रयास करें। यदि जारी रहे, तो सहायता से संपर्क करें।