---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/checkout/api/getCapture/index.md
description: >-
  预授权请款查询接口用于获取支付预授权的请款状态。适用于需要验证预授权请款是否成功的场景，支持全球范围内的支付方式。调用时需注意应在同步返回后进行，以避免查询异常。请求响应采用
  JSON 格式，包含关键参数如交易 ID 等，确保准确追踪每笔交易的状态。
---
# 预授权请款查询

```apidef
endpoint: POST /v4/capture/query
name: 预授权请款查询
summary: 查询预授权请款结果
tags: Query, Capture
```

预授权请款查询接口用于获取支付预授权的请款状态。适用于需要验证预授权请款是否成功的场景，支持全球范围内的支付方式。调用时需注意应在同步返回后进行，以避免查询异常。请求响应采用 JSON 格式，包含关键参数如交易 ID 等，确保准确追踪每笔交易的状态。

## 请求参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| accId | string | M | 店铺唯一标识 |
| clientId | string | M | PingPong 商户号 |
| signType | string | M | 支持 MD5 、 SHA256 ，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/一栏 |
| sign | string | M | 签名，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/，所有参数均参与签名 |
| version | string | M | 版本号，当前固定为1.0，后续随接口变动可能有调整 |
| bizContent | string | M | 请求参数的集合，最大长度不限，除公共请求参数外所有请求参数都必须放在这个参数中传递，格式：JSON字符串。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ merchantCaptureId | string | M | 商户网站预授权请款流水号，全局唯一 |
| └─ merchantTransactionId | string | M | 商户网站的原交易流水号 |

### 请求示例

```json
{
  "accId": "2018092714313010016291",
  "clientId": "2018092714313010016",
  "signType": "SHA256",
  "sign": "898A3CBE981B3E2BF4E2B8D1A817D7E23EF93BC4293993EE545E36F4C87F2E79",
  "version": "1.0",
  "bizContent": "{\"merchantCaptureId\":\"2023070750000647\",\"merchantTransactionId\":\"202307075000324\"}"
}
```

## 响应参数

| 参数名 | 类型 | 说明 |
|--------|------|------|
| accId | string | 店铺唯一标识 |
| clientId | string | PingPong 商户号 |
| signType | string | 支持 MD5 、 SHA256 ，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/一栏 |
| sign | string | 签名，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/，所有参数均参与签名 |
| code | string | 结果状态码，见附录状态码表: /notes/zh/appendix/successCodeList/ |
| description | string | 结果描述 |
| bizContent | string | 业务响应参数。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ transactionId | string | PingPong 交易流水号 |
| └─ merchantTransactionId | string | 网站交易流水号 |
| └─ currency | string | 交易币种，ISO 4217 三位币种，具体支持币种⻅附件交易币种: /notes/zh/appendix/transactionCurrency/ |
| └─ resultCode | string | 状态结果码 |
| └─ resultDescription | string | 状态结果描述 |
| └─ amount | string | capture金额 |
| └─ captureTime | string | capture发起时间，时间戳 |
| └─ captureEndingTime | string | capture到达终态时间，时间戳 |
| └─ status | string | 交易状态：状态幂等: /notes/zh/guide/paystatus/ SUCCESS-成功; FAILED-失败; PROCESSING-处理中; |

### 响应示例

```json
{
  "accId": "2023060217493010231446",
  "bizContent": "{\"amount\":\"200.000000\",\"captureTime\":\"1687335326000\",\"resultCode\":\"000000\",\"transactionId\":\"2023062150000332\",\"merchantTransactionId\":\"PMT-RRI7V42FR31687334823784\",\"currency\":\"USD\",\"resultDescription\":\"Transaction succeeded\",\"status\":\"SUCCESS\"}",
  "clientId": "2023060217493010231",
  "code": "001000",
  "description": "Successful request",
  "sign": "C550628F93D95A84AE89D18264CD9184520896908CEEEE77829F72196036A0AC",
  "signType": "SHA256"
}
```