Troubleshooting Common Issues in ID Credit EVAL Score CateB API

While using the ID Credit EVAL Score CateB API, you may encounter issues related to parameter validation, authentication, or system errors. This guide will help you troubleshoot and resolve common problems.

1. Invalid or Missing Parameters: A frequent issue arises from missing or improperly formatted parameters. The API expects valid inputs, especially for customer ID and phone number.

Error: PARAMETER_ERROR

• Message: "Invalid ID number, please check the NIK format."
• Cause: The ID number (NIK) should be a 16-digit string, and no leading zeros are allowed.
• Solution: Double-check the NIK format and ensure the input adheres to the required length and format.

Error: PARAMETER_ERROR

• Message: "Invalid phone number, please check your phone number format or call segment."
• Cause: Phone numbers must start with "+628" and contain no extra symbols.
• Solution: Ensure the phone number is correctly formatted with no spaces or dashes.

2. Expired Access Token: If your access token expires, all subsequent requests will fail.

Error: ACCOUNT_DISABLED or CLIENT_ERROR

• Message: "Token not found or expired."
• Cause: The access token has expired or is invalid.
• Solution: Generate a new access token by sending a request to the token generation endpoint. Ensure the timestamp is correct.

3. Handling HTTP Client Errors: If you receive an HTTP error, such as a 400 Bad Request, the issue is typically related to request structure or missing information.

Error: CLIENT_ERROR

• Message: "HTTP 400 - Bad Request."
• Cause: Incorrectly formatted request or missing required parameters.
• Solution: Review the request body, headers, and parameter values to ensure they match the API documentation.

4. Quota Limits and Overuse: API users may occasionally hit request or quota limits, leading to errors.

Error: OVER_QUERY_LIMIT

• Message: "Quota exceeded, you have exceeded free query quota."
• Cause: The account has reached the daily request limit.
• Solution: Contact your account manager to increase the quota or manage the number of requests more carefully.

5. System Errors and Downtime: At times, the system may encounter internal errors or be unavailable.

Error: ERROR

• Message: "Server error."
• Cause: The server is experiencing issues or undergoing maintenance.
• Solution: Retry the request after some time. If the issue persists, contact technical support.

6. Signature and Timestamp Errors: Authentication errors can occur if the signature or timestamp in the token request is not correctly generated.

Error: PARAMETER_ERROR

• Message: "Signature error."
• Cause: The signature was incorrectly generated from the accessKey, secretKey, and timestamp.
• Solution: Recalculate the SHA256 hash and ensure that the timestamp is accurate.

By following these troubleshooting tips, you can resolve issues quickly and ensure smooth integration of the ID Credit EVAL Score CateB API.

Further Assistance

If you continue to experience issues despite following the guidelines provided, please contact our support team for further assistance:

• Email: help@advance.ai
• Submit a Ticket: Via ADVANCE.AI Support