Get Sub-Merchant Report Status

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

Description: Retrieve the current status of a previously submitted sub-merchant report by its request ID.

Request

Request Body Field Descriptions (JSON)

Field Name	Type	Required	Description
N/A	N/A	N/A	GET request does not require a JSON body.

Request sample

// No request body required for this GET endpoint.

Response

Response Field Descriptions

Field Name	Type	Description
code	number	Response code.
state	number	State of the response.
data	object	Sub-merchant report status details.
message	string	Response message.
neoResponseId	string	Unique NeoX response identifier.

data object fields:

Field Name	Type	Description
merchantId	string	NeoX merchant identifier for the parent merchant.
requestId	string	The original merchant-supplied requestId for this report submission.
subMerchantId	string	NeoX identifier assigned to the sub-merchant.
bankInfos	array	List of bank account records associated with the sub-merchant. See bankInfos item fields below.
status	string	Current report status. Enum: TO_BE_REVIEW, ACTIVATED, AUDIT_REJECT, PROCESSING.

bankInfos object item fields:

Field Name	Type	Description
accountType	string	Type of bank account. Enum: PUBLIC, PRIVATE.
bankAccountName	string	Name of the account holder as registered with the bank.
bankCardNumber	string	Bank card number associated with the account.
payeeCardNumber	string	Payee card number used for receiving funds.

Response sample

{
  "code": 1,
  "state": 2,
  "data": {
    "merchantId": "MC-00012345",
    "requestId": "d5e6f7a8-2345-4d89-cabc-1122334455ee",
    "subMerchantId": "SM-00098762",
    "bankInfos": [
      {
        "accountType": "PUBLIC",
        "bankAccountName": "Bright Star Commerce Ltd",
        "bankCardNumber": "62260000123456789",
        "payeeCardNumber": "62260000987654321"
      }
    ],
    "status": "ACTIVATED"
  },
  "message": "Successful",
  "neoResponseId": "f2a3b4c5-77dc-4d34-ae15-6b8901234567"
}

Example cURL

curl -X GET "https://{base_url_openapi}/v2/gc/sub-merchants/report/{requestId}" \
  -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 sub-merchant report.

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