Error Codes

Error Code List

Code	Description	Recommended Action
0000	Success	Read the data field and proceed with your business logic
10001	HTTP request URL parsing error	Check path parameters, version number, and URL format
10002	JSON parsing error	Verify the request body is valid JSON with correct field types
10003	Signature verification failed	Check the private key, signature algorithm, timestamp, nonce, query parameter sorting, and raw body
10004	Server persistence error	Retry the request; contact iGV support if the issue persists

Error Response Example

{
  "code": "10003",
  "msg": "Request signature error.",
  "time": "2025-04-03 02:55:16",
  "data": null
}

Troubleshooting

10001 — URL Parsing Error

• Verify that the {merchant} and {ver} path parameters are correct
• Ensure the Base URL has no extra path segments
• Confirm proper URL encoding

10002 — JSON Parsing Error

• Verify Content-Type: application/json is set
• Ensure the request body is valid JSON
• Check that field types match the documentation

10003 — Signature Verification Failed

• Confirm you are using the correct private key
• Confirm the signature algorithm is SHA256withRSA
• Confirm the signature string concatenation order: sorted_params + timestamp + nonce + body_data
• Confirm URL parameters are sorted alphabetically
• Confirm body_data is the raw request body and has not been re-serialized

10004 — Server Error

• Safe to retry
• Use an exponential backoff strategy
• Contact iGV technical support if the issue persists