---
title: "Charge Record Query"
method: GET
path: "/transfer/open/institution/v1/pay/charges/detail"
---

# Charge Record Query

`GET /transfer/open/institution/v1/pay/charges/detail`

## Request

- Base URL: `https://openplatform.gateapi.io`
- URL: `https://openplatform.gateapi.io/transfer/open/institution/v1/pay/charges/detail`
- Auth: none declared. Required headers: `X-GatePay-Certificate-ClientId`, `X-GatePay-Timestamp`, `X-GatePay-Nonce`, `X-GatePay-Signature`, `X-GatePay-On-Behalf-Of`

Query historical charge records by merchant batch number for result backfill or reconciliation checks. In the current version, it is no longer used as an asynchronous polling endpoint.

## Query parameters

- `merchantBatchNo` string, required

## Headers

- `X-GatePay-Certificate-ClientId` string, required
- `X-GatePay-Timestamp` string, required
- `X-GatePay-Nonce` string, required
- `X-GatePay-Signature` string, required
- `X-GatePay-On-Behalf-Of` string, required

## Response `200`

Success

- ChargeDetailResponseWrapper
  - `status` string
  - `code` string
  - `errorMessage` string
  - `data` ChargeDetailResponse: Historical charge record query result for result backfill or reconciliation checks.
    - `merchantBatchNo` string: Batch ID; same as request merchantBatchNo.
    - `status` string: Status: PENDING (pending payment), PROCESS (processing), ERROR (failed), EXPIRED (expired), PAID (successful), CANCELLED (cancelled).
    - `toAccountId` string: Recipient account ID.
    - `fromAccountId` string: Payer account ID.
    - `createTime` integer: Order creation time, milliseconds.
    - `currency` string: Currency.
    - `amount` string: Transfer amount.

---

[API](https://skmtc.dev/gate/apis/gatepay-institutional-api.md) - [All operations](https://skmtc.dev/gate/apis/gatepay-institutional-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gate/apis/gatepay-institutional-api/revisions/4627cdb35251?raw)