104 lines
4.2 KiB
YAML
104 lines
4.2 KiB
YAML
WithholdingBackDiscCheck:
|
||
post:
|
||
tags:
|
||
- 代扣管理
|
||
summary: 代扣回盘状态查询
|
||
description: |
|
||
银行向公用事业单位发起的代扣回盘状态查询请求接口。
|
||
用于查询已发起的代扣回盘交易的当前处理状态。
|
||
|
||
## 交易码说明
|
||
- 请求交易码：BackDiscCheck
|
||
- 应答交易码：BackDiscCheckRes
|
||
|
||
## 查询状态说明
|
||
- 0: 待处理
|
||
- 1: 处理中
|
||
- 2: 处理成功
|
||
- 3: 处理失败
|
||
- 4: 已取消
|
||
|
||
## 使用场景
|
||
- 银行系统需要确认回盘交易状态
|
||
- 处理异常情况的状态核查
|
||
- 定时批量状态查询
|
||
- 对账和清算流程中的状态确认
|
||
|
||
operationId: withholdingBackDiscCheck
|
||
parameters:
|
||
- $ref: '../components/parameters.yaml#/components/parameters/ContentTypeHeader'
|
||
- $ref: '../components/parameters.yaml#/components/parameters/EncryptTypeHeader'
|
||
- $ref: '../components/parameters.yaml#/components/parameters/EncryptModeHeader'
|
||
- $ref: '../components/parameters.yaml#/components/parameters/DataTypeHeader'
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/xml:
|
||
schema:
|
||
$ref: '../components/schemas.yaml#/components/schemas/WithholdingBackDiscCheckRequest'
|
||
example: |
|
||
<?xml version="1.0" encoding="GBK"?>
|
||
<in>
|
||
<Version>1.0.1</Version>
|
||
<InstId>00001</InstId>
|
||
<TranCode>BackDiscCheck</TranCode>
|
||
<TranDate>20240101</TranDate>
|
||
<TranSeq>123456789012</TranSeq>
|
||
<billKey>123456</billKey>
|
||
<companyId>654321</companyId>
|
||
<originalTranSeq>ORIG123456789012</originalTranSeq>
|
||
<originalTranDate>20240101</originalTranDate>
|
||
<contractNo>CONTRACT001</contractNo>
|
||
<batchNo>BATCH20240101001</batchNo>
|
||
</in>
|
||
application/json:
|
||
schema:
|
||
$ref: '../components/schemas.yaml#/components/schemas/WithholdingBackDiscCheckRequest'
|
||
responses:
|
||
'200':
|
||
description: 代扣回盘状态查询成功
|
||
headers:
|
||
Content-Type:
|
||
$ref: '../components/headers.yaml#/components/headers/ContentType'
|
||
X-Response-Time:
|
||
$ref: '../components/headers.yaml#/components/headers/ResponseTime'
|
||
X-Request-Id:
|
||
$ref: '../components/headers.yaml#/components/headers/RequestId'
|
||
content:
|
||
application/xml:
|
||
schema:
|
||
$ref: '../components/schemas.yaml#/components/schemas/WithholdingBackDiscCheckResponse'
|
||
example: |
|
||
<?xml version="1.0" encoding="GBK"?>
|
||
<out>
|
||
<Version>1.0.1</Version>
|
||
<InstId>00001</InstId>
|
||
<TranCode>BackDiscCheckRes</TranCode>
|
||
<TranDate>20240101</TranDate>
|
||
<TranSeq>123456789012</TranSeq>
|
||
<RespCode>AAAAAAA</RespCode>
|
||
<RespMessage>查询成功</RespMessage>
|
||
<billKey>123456</billKey>
|
||
<companyId>654321</companyId>
|
||
<originalTranSeq>ORIG123456789012</originalTranSeq>
|
||
<discStatus>2</discStatus>
|
||
<discStatusDesc>处理成功</discStatusDesc>
|
||
<discTime>20240101120000</discTime>
|
||
<payAmount>15000</payAmount>
|
||
<actualPayAmount>15000</actualPayAmount>
|
||
<batchNo>BATCH20240101001</batchNo>
|
||
<clearingDate>20240102</clearingDate>
|
||
<failReason></failReason>
|
||
</out>
|
||
application/json:
|
||
schema:
|
||
$ref: '../components/schemas.yaml#/components/schemas/WithholdingBackDiscCheckResponse'
|
||
'400':
|
||
$ref: '../components/responses.yaml#/components/responses/BusinessError'
|
||
'500':
|
||
$ref: '../components/responses.yaml#/components/responses/SystemError'
|
||
'403':
|
||
$ref: '../components/responses.yaml#/components/responses/SecurityError'
|
||
security:
|
||
- ApiKeyAuth: []
|
||
- EncryptedData: [] |