Get Qualification Renewal Status

Endpoint: GET /v2/gc/sub-merchants/qualification-renewals/{requestId}

Description: Retrieve the current status of a sub-merchant qualification renewal request by its request ID and sub-merchant ID.

Request

Request Params Field Descriptions

Field Name	Type	Required	Description
subMerchantId	string	Yes	NeoX identifier of the sub-merchant associated with the renewal request.

Response

Response Field Descriptions

Field Name	Type	Description
code	number	Response code.
state	number	State of the response.
data	object	Qualification renewal status details.
message	string	Response message.
neoResponseId	string	Unique NeoX response identifier.

data object fields:

Field Name	Type	Description
requestId	string	The original merchant-supplied requestId for this renewal submission.
merchantId	string	NeoX merchant identifier for the parent merchant.
subMerchantId	string	NeoX identifier of the sub-merchant whose qualification is being renewed.
inspectionNoticeId	string	Inspection notice identifier associated with this renewal.
status	string	Current renewal status. Enum: PROCESS, SUCCESS, FAILED.
subMerchantStatus	string	Current overall status of the sub-merchant account after the renewal review.
errCode	string	Error code if the renewal failed; empty when not applicable.
errMsg	string	Human-readable error description if the renewal failed; empty otherwise.

Response sample

{
  "code": 1,
  "state": 2,
  "data": {
    "requestId": "f8b1c2d3-3456-4e90-dbcd-2233445566ff",
    "merchantId": "MC-00012345",
    "subMerchantId": "SM-00098761",
    "inspectionNoticeId": "INS-20240601-00042",
    "status": "SUCCESS",
    "subMerchantStatus": "ACTIVATED",
    "errCode": "",
    "errMsg": ""
  },
  "message": "Successful",
  "neoResponseId": "b6c7d8e9-99fe-4f56-c037-8d0123456789"
}

Example cURL

curl -X GET "https://{base_url_openapi}/v2/gc/sub-merchants/qualification-renewals/{requestId}?subMerchantId=SM-00098761" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Content-Type: application/json" \
  -H "Accept-Language: en"

Notes

• Requires Bearer token in the Authorization header.

• The Accept-Language header can be used to specify the response language (Support: "vi", "en").

• No request body required.

• Replace {requestId} with the actual requestId used when submitting the qualification renewal.

• The subMerchantId query parameter is required and must match the sub-merchant associated with the renewal request.

• Poll this endpoint to check the renewal result when a notifyUrl was not provided, or as a fallback to the SUB_MERCHANT webhook notification.